[지문 스캐너 매크로] 도움말

안내

GTA 온라인 지문 스캐너 매크로와 관련된 주요 질문들을 모아둔 글입니다.
Ctrl + F를 통해 원하시는 키워드를 검색해보시거나, 내용이 많지 않으므로 직접 스크롤하셔서 찾아보셔도 됩니다.

최종 수정 - 2020년 6월 8일 (v20060801)

Q. 바이러스로 감지됐어요

• v20060801 바이러스 검사 결과: run.exe, 압축 파일

virustotal.com을 통해 확인한 결과 v20060801을 기준으로 현재 70여개의 백신 중 하나의 백신(SecureAge APEX)이 본 프로그램을 수상한(Malicious) 파일로 진단하고 있습니다.

본 프로그램은 Python으로 작성한 스크립트를 Pyinstaller를 이용해서 실행 파일(.exe)로 변환한 것 입니다.
Pyinstaller를 통해 생성된 실행파일에 대한 백신들의 오진은 이미 여러번 발견된 바 있습니다 (관련 Pyinstaller GitHub 이슈: #2988, #4343, #4670).

해당 백신이 본 프로그램을 수상한 파일로 감지함에 따라 개발사에 오진 검토 요청을 하였었고, 그 결과 최초 버전에 대한 오진은 해결되었습니다.
그러나 이후 버전들은 지속적으로 수상한 파일로 감지됨에 따라서 개발사측에 재검토 요청을 보내 둔 상황입니다.

바이러스 오진 문제를 해결하기 위해 Pyinstaller의 부트로더 교체 등 다양한 시도를 해보았으나 의미있는 결과를 얻지 못했습니다.
혹여나 작성한 소스코드에 문제점이 있는지 확인하기 위해 Hello, World!를 출력하고 끝나는 프로그램을 동일한 방법으로 변환해서 검사해 본 결과, 이 또한 동일한 결과를 보임에 따라 명백한 오진으로 판단하고 백신 개발사에 오진 검토를 요청해두었습니다.

본 프로그램에는 사용자의 컴퓨터에 영향을 끼치는 악성코드나 바이러스가 절대 포함되어 있지 않습니다. 안심하고 사용하셔도 됩니다.
만약 그래도 신경쓰이신다면 업데이트 내역에서 바이러스 검출이 되지 않은 이전버전을 다운로드해 사용하실 수 있습니다.

Q. 오류가 뜨면서 종료돼요

프로그램 사용시 발생할 수 있는 주요 오류들은 다음과 같습니다.
아래 목록에 없는 오류들은 문의를 통해 에러 메세지를 접수해주세요.

NoSectionError

설정 파일인 settings.ini가 없거나 손상된 경우 발생합니다.
압축 파일에서 원본 settings.ini를 가져와 run.exe와 같은 폴더에 옮겨주시거나 기존의 것에 덮어씌워주세요.

ValueError

설정 파일인 settings.ini에 잘못된 값이 들어가있습니다. 좌표값에 숫자가 아닌 다른 값이 들어가있거나 단축키 값이 틀린 경우 발생합니다.
문제를 수정하지 못하시겠는 경우 압축 파일에서 원본 settings.ini를 가져와 run.exe와 같은 폴더에 옮겨주시거나 기존의 것에 덮어씌워주세요.

UnicodeDecodeError

설정 파일인 settings.ini가 잘못된 인코딩으로 작성된 경우 발생합니다.
인코딩을 BOM 제외 UTF-8으로 변환해주시거나 압축 파일에서 원본 settings.ini를 가져와 run.exe와 같은 폴더에 옮겨주시거나 기존의 것에 덮어씌워주세요.

RuntimeError

본 에러가 발생하는 경우에는 문의를 통해 에러 메세지를 접수해주세요.

OSError

주로 이미지 분석 중 화면을 캡쳐하지 못했을 때 발생합니다. 대부분의 경우 프로그램을 재실행하면 해결됩니다.

지속해서 본 에러가 발생하는 경우에는 문의를 통해 에러 메세지를 접수해주세요.

PermissionError

권한 부족으로 인해 설정 파일을 읽어오지 못하거나 디버그 스크린샷을 저장하지 못한 경우에 발생합니다.
프로그램 폴더를 관리자 권한이 필요하지 않은 곳으로 옮겨주세요.

KeyboardInterrupt

프로그램을 Ctrl + C를 이용해 종료하였을 경우 발생합니다.
프로그램 종료 단축키(기본 F4)나 우측 상단의 X 버튼을 이용해서 프로그램을 종료해주세요.

Q. 제 해상도를 지원하지 않아요

프로그램을 개발하는 과정에서 모든 해상도에 대한 정보를 얻을 수 없었기에 주로 사용되는 일부 해상도에 대해서만 지원하고 있습니다.
만약 본인의 해상도가 지원되지 않는 경우 다음 방법을 시도해보실 수 있습니다.

• 설정 파일 settings.ini를 수정해 이미지 내 좌표를 직접 입력
• 지문 스캐너 해킹 화면을 캡쳐하고 문의를 통해 접수

설정 파일 수정은 아래의 Q. 설정 파일을 수정하고 싶어요 항목을 참고해주세요.

Q. 매크로가 작동하지 않아요

매크로가 작동하지 않는 상황에는 여러가지가 있으며, 주로 다음 상황들입니다.

단축키가 작동하지 않는 경우

단축키의 작동을 확인하기 위해서 단축키 작동 시 소리를 활성화하여 단축키가 감지되면 소리가 나도록 설정해보실 수 있습니다.
단축키를 눌러도 소리가 나지 않는 경우 이는 게임이 모든 키 입력을 가져가고 있기 때문일 확률이 높습니다.

이 현상이 지속되신다면 피날레 진행 중 금고가 열리는 영상이 나올 때 프로그램을 실행하시고, 채팅이나 다른 기능을 이용하지 말고 바로 지문 스캐너를 사용하시기를 권장해드립니다.

단축키 소리 관련 설정은 아래의 Q. 설정 파일을 수정하고 싶어요 항목을 참고해주세요.

이미지 좌표값이 틀려 정상적인 분석을 진행하지 못한 경우

설정에 입력되어 있는 이미지 좌표값에 오류가 있어 정상적인 분석을 진행하지 못하고 있는 경우입니다.

• 바탕화면의 해상도와 게임 내 해상도가 다른 경우에는 게임을 실행한 다음 재설정(기본 단축키 F5)을 진행해주세요.
• 여러 개의 모니터를 사용중이신 경우에는 주 모니터(1번 모니터)에서 게임을 플레이하셔야 합니다.

위 경우가 아니라면, 좌표가 정확하게 입력되어 있는지 확인하기 위해 디버그 모드를 활성화하여 스크린샷을 얻을 수 있습니다.

정상적인 경우 위 이미지와 같이 제시 지문과 선택 항목에 맞춰서 빨간 테두리가 그려진 이미지를 볼 수 있습니다.

만약 지원되는 해상도인데 빨간 테두리가 맞지 않는 문제가 발생할 경우, 이는 GTA의 그래픽 설정에 문제가 있어 UI가 통상적인 상황과 다르게 나타나고 있을 확률이 높습니다.
설정의 완전한 초기화를 위해 내 문서\Rockstar Games\GTA V에 있는 settings.xml의 이름을 다른 아무거나로 바꿔주세요. 그 상태로 게임을 실행하면 완전 초기화된 설정을 담고있는 새로운 settings.xml 파일이 생성됩니다.

만약 위 방법을 시도해보셔도 작동하지 않거나, 지속적으로 문제가 발생하는 경우 문의를 통해 해상도 정보와 스크린샷 파일을 접수해주세요.

디버그 모드 활성화는 아래의 Q. 설정 파일을 수정하고 싶어요 항목을 참고해주세요.

이 외의 경우

위 두 경우에 모두 해당하지 않으나, 별도의 오류 메세지 없이 작동하지 않는 경우 정확한 원인 파악이 불가능합니다.
일단은 문제 기록을 위해 문의를 통해 오류를 접수해주세요.

Q. 설정 파일을 수정하고 싶어요

설정 파일인 settings.ini에는 다양한 설정들이 포함되어 있습니다.
수정을 원하시는 경우 아래를 참고해서 수정해주세요.

setting

프로그램의 작동과 관련된 설정들을 포함하고 있는 항목입니다.

• use_custom: 사용자 정의 좌표 사용 여부를 설정할 수 있습니다. 활성화 된 경우 설정 파일의 CUSTOM 항목의 이미지 좌표값을 사용합니다. 기본값은 off 입니다.
• standby_threshold: 실행중인 게임을 몇 번까지 탐색할지 설정할 수 있습니다. 프로그램이 실행되었을 때 게임이 실행중이 아닌 경우 지정된 횟수만큼 검색을 시도하고, 찾지 못할경우 프로그램을 종료합니다. 기본값은 5입니다.
• print_on_hotkey: 단축키 작동 시 로그 출력 여부를 설정할 수 있습니다. 활성화 된 경우 단축키가 눌렸을 때 CLI에 로그를 출력합니다. 로그 출력 시 딜레이가 발생해 작동이 느려지므로 테스트에서만 활성화를 권장합니다.기본값은 off 입니다.
• debug: 디버그 모드 여부를 설정할 수 있습니다. 활성화 된 경우 디버그 스크린샷을 저장합니다. 기본값은 off 입니다.

sound

프로그램의 소리와 관련된 설정을 포함하고 있는 항목입니다. 모든 값은 on 혹은 off 로 작성합니다.
소리 출력시 딜레이가 발생해 작동이 느려지므로 단축키 작동 시 소리는 테스트에서만 활성화를 권장합니다

• on_found: 게임 프로세스 확인 시 소리 여부를 설정할 수 있습니다. 활성화 된 경우 게임 프로세스를 찾았을 때 1000Hz의 소리가 200 밀리초 동안 발생합니다. 기본값은 on 입니다.
• on_lost: 게임 프로세스 실종 시 소리 여부를 설정할 수 있습니다. 활성화 된 경우 게임 프로세스가 사라졌을 때 300Hz의 소리가 1000 밀리초 동안 발생합니다. 기본값은 on 입니다.
• on_hotkey: 단축키 작동 시 소리 여부를 설정할 수 있습니다. 활성화 된 경우 단축키가 눌렸을 때 2000Hz의 소리가 200 밀리초 동안 발생합니다. 기본값은 on 입니다.
• on_error: 에러 발생 시 소리 여부를 설정할 수 있습니다. 활성화 된 경우 에러가 발생했을 때 100Hz의 소리가 1000 밀리초 동안 발생합니다. 기본값은 on 입니다.

hotkey

단축키 설정을 포함하고 있는 항목입니다. 다른 프로그램의 단축키와 겹치지 않게 변경해서 사용해야 합니다.

• escape - 어떤 키를 눌러 프로그램을 종료할지 설정할 수 있습니다. 기본값은 F4 입니다.
• reload - 어떤 키를 눌러 재설정 기능을 사용할지 설정할 수 있습니다. 기본값은 F5 입니다.
• action - 어떤 키를 눌러 매크로 기능을 사용할지 설정할 수 있습니다. 기본값은 F6 입니다.
• test - 어떤 키를 눌러 단축키 테스트 기능을 사용할지 설정할 수 있습니다. 기본값은 F7 입니다.

CUSTOM

사용자 정의 이미지 좌표값을 포함하고 있는 항목입니다. 프로그램이 해상도를 지원하지 않거나 기본으로 제공하는 좌표값이 틀린 경우 setting 항목의 use_custom을 활성화하고 본 항목을 수정함으로써 원하는 좌표값을 직접 사용할 수 있습니다.

모든 값은 픽셀 단위 정수로 작성합니다. 글로 이해되지 않는 경우 위 이미지를 참고해주세요.

• fp_x1 - 제시 지문 사각형의 시작 위치 X좌표
• fp_y1 - 제시 지문 사각형의 시작 위치 Y좌표
• fp_x2 - 제시 지문 사각형의 끝 위치 X좌표
• fp_y2 - 제시 지문 사각형의 끝 위치 Y좌표
• piece_x - 지문 조각 모음의 시작 위치 X 좌표
• piece_y - 지문 조각 모음의 시작 위치 Y 좌표
• piece_gap - 지문 조각의 크기와 조각 사이 여백의 합
• piece_size - 지문 조각의 크기

올바른 좌표가 입력된 경우 위와 같은 디버그 모드를 사용하면 위와 같은 디버그 스크린샷을 얻을 수 있습니다.