설치와 첫 실행

pqp는 화면에서 이미지나 문자를 찾고 정해 둔 입력을 실행하는 Windows 자동화 도구입니다. 처음 사용할 때는 설치, 장치 연결, 화면 확인, 짧은 규칙 시험 순서로 진행하세요.

사용하려는 게임·서비스의 이용약관과 자동화 허용 범위를 먼저 확인하세요. 화면 인식을 사용하더라도 이용 제한이나 계정 제재가 없다고 보장할 수 없습니다. 본인이 사용할 권한이 있는 환경에서만 실행하세요.

1. 공식 설치 파일 확인

설치 전 이용약관 제15조의 기술적 위험 안내를 읽어 주세요. 해당 약관은 커널 수준 모듈과 백신 충돌, 운영체제 불안정 및 데이터 유실 가능성을 명시합니다. 화면 인식 기능을 사용한다는 설명만으로 프로그램 전체가 시스템 수준 기능을 사용하지 않는다고 판단해서는 안 됩니다. 중요한 작업과 데이터는 먼저 저장·백업하세요.

공식 GitHub 릴리스에서 버전과 파일 목록을 확인할 수 있습니다. 현재 배포 형식은 pqp-setup.exe 설치 프로그램입니다. 이전 안내에 나온 ZIP 포터블 파일과 다릅니다.

1. Windows 설치 파일 다운로드를 선택합니다. 다운로드는 사용자가 링크를 누른 뒤 시작됩니다.
2. 파일 이름과 다운로드 출처를 확인하고 설치 프로그램의 안내를 따릅니다. 브라우저나 Windows의 경고가 나타나면 경고의 이유와 출처를 확인하세요. 보호 기능을 끄고 설치하지 마세요.
3. 설치 후 pqp를 실행합니다. 사용 중인 버전은 오류를 문의할 때 함께 기록해 두세요.

Get-FileHash -Algorithm SHA256 -LiteralPath .\pqp-setup.exe

2. 에뮬레이터 연결과 화면 확인

사이트에서 안내하는 에뮬레이터는 MuMu Player 12와 LDPlayer 9입니다. 에뮬레이터를 먼저 실행하고 Android 홈 화면이 보일 때까지 기다리세요.

1. pqp의 장치 목록에서 새로고침을 누릅니다.
2. 실제로 사용할 장치를 선택합니다. 여러 인스턴스를 사용한다면 다른 장치를 잘못 선택하지 않았는지 확인하세요.
3. 화면 미리보기가 현재 에뮬레이터 화면과 일치하는지 확인합니다. 목록에 장치가 없거나 화면이 멈춰 있으면 규칙 실행보다 연결 문제를 먼저 해결하세요.

연결이 되지 않으면 장치 연결 점검을 확인하세요. USB·무선 연결은 해당 장치의 설정에 따라 추가 구성이 필요할 수 있습니다.

3. 짧은 규칙으로 시험하고 중지하기

처음부터 긴 반복 작업을 실행하지 마세요. 한 번의 인식이나 입력으로 결과를 확인할 수 있는 규칙부터 시험하면 원인을 찾기 쉽습니다.

1. 규칙의 대상 장치와 입력 위치를 확인합니다. 구매·삭제·계정 설정 같은 되돌리기 어려운 화면은 시험에 사용하지 마세요.
2. 실행 화면의 중지 기능을 먼저 확인합니다.
3. 규칙을 짧게 실행해 입력이 의도한 위치에 도달하는지 확인하고 중지합니다.
4. 의도하지 않은 반복이나 입력이 발생하면 즉시 중지하고 조건·좌표·대기 시간을 다시 확인합니다.

다른 사람이 만든 프리셋도 실행 전에 포함된 동작을 검토하세요. 화면 크기나 UI 배치가 다르면 같은 규칙이 다른 위치에 입력할 수 있습니다.

4. 이미지 인식이 일정하게 동작하도록 설정하기

이미지 템플릿은 실제 사용할 장치의 화면에서 캡처하세요. 해상도, 배율, 언어, 테마가 바뀌면 같은 버튼도 다른 이미지가 됩니다. 검색 범위를 필요한 영역으로 좁히면 비슷한 다른 요소와 혼동하는 문제를 줄일 수 있습니다.

OCR 결과가 기대와 다르면 원본 화면에서 글자가 잘리는지, 배경과 글자의 대비가 충분한지 확인하세요. 화면 전환이나 애니메이션 중에는 결과가 달라질 수 있으므로 화면이 안정된 뒤 시험합니다.

5. 다음 단계와 도움 요청

직접 스크립트를 작성한다면 JavaScript API 참조와 단계별 예제를 확인하세요. 문제가 생기면 문제 해결 안내에 따라 버전·재현 순서·오류 메시지를 정리해 문의 채널로 전달할 수 있습니다.