처음 실패하는 단계부터 확인
멈춘 위치를 고른 뒤 시스템별 점검을 따르세요.
입력 형식과 대상 옵션 확인
- 깨끗한 ELF와 지원 모듈 폴더를 확인하세요. --sce-module-path는 상위 폴더를 지정합니다.
- --windows를 명시하세요. 선택하지 않으면 .exe 이름도 기본 Linux 형식입니다.
- 같은 릴리스 문서로 옵션을 비교하세요. 기본 시도에 폐기된 디버그 인수를 넣지 마세요.
종료 코드 0은 도움말 표시일 수도 있습니다. --autorun의 코드는 실행된 프로그램의 것일 수 있으니 명령과 로그도 남기세요.
v0.1.2 입력, 옵션과 종료 코드 ↗문제 해결 보고서 작성
GitHub issue나 토론에 복사할 보고서를 만드세요. 입력은 업로드하지 않습니다.
다른 빌드를 사용한다면 맞는 문서를 따르고 AnyPS5 게임 보고서와 비교하세요.
AnyPS5가 작동하지 않으면 입력 읽기, 변환, 라이브러리 로딩, 게임 실행 중 처음 실패하는 단계를 찾으세요. 그에 따라 파일, 명령, 실행 폴더 또는 게임의 차단 요인을 조사할 수 있습니다.
첫 유용한 오류를 옆에 두고 진행하세요. v0.1.2 사용 문서를 기준으로 하며 게임 전용 브랜치는 추가 설명이 있을 수 있습니다.
입력을 읽지 못할 때
사용 권한이 있는 깨끗한 ELF인지 확인하세요. 암호화 패키지나 SELF/fSELF는 바로 입력할 수 없습니다. eboot.bin 같은 이름만으로 파일 내용을 알 수는 없습니다.
함께 제공된 모듈도 확인하세요.
source/
input.elf
sce_module/
bundled-module.prx
표준 이름은 sce_module/, sce_modules/, prx/입니다. prx/는 다른 하나와 공존할 수 있지만 앞의 둘이 동시에 있거나 셋 다 없으면 오류입니다. 각 폴더 바로 안의 파일만 처리합니다.
--sce-module-path는 모듈 폴더의 상위 폴더를 가리킵니다. 플러그인 같은 다른 경로는 보고서의 --module-dir 사용을 확인하세요. AnyPS5 설치에 입력과 출력 배치가 있습니다.
Windows에서 출력이 실행되지 않을 때
기본 출력은 Linux ELF이며 app.exe 이름도 바꾸지 못합니다. --windows로 다시 변환하세요.
.\relinker-v0.1.2.exe --windows source\input.elf app.exe
Intel의 잘못된 명령 오류라면 --to-intel 사용을 확인하세요. 입력·모듈의 지원 AMD 명령을 처리하지만 실행 중 생성 명령은 처리하지 못합니다. 계속 멈추면 오류 세부사항을 남기고 AnyPS5 시스템 요구 사항을 확인하세요.
Windows 오류 193 또는 126
| 오류 | 우선 확인 | 조치 |
|---|---|---|
| 193: not a valid Win32 application | 원 콘솔 .prx가 libs/에 있는지 |
같은 AnyPS5 Windows 라이브러리로 교체. 생성 게임 모듈은 app0/의 Guest module: 경로에 둡니다. |
| 126: module not found | .prx가 있어도 의존 DLL이 없는지 |
libs/의 MinGW DLL과 다른 의존성을 확인합니다. |
v0.1.2 패키지의 libgcc_s_seh-1.dll, libstdc++-6.dll, libwinpthread-1.dll을 모두 libs/에 두세요. 직접 빌드했다면 같은 MinGW 툴체인의 mingw64/bin에서 DLL을 사용하고 런타임을 혼합하지 마세요.
직접 메모리 매핑 실패
Windows의 replace guest placeholder with resident direct memory 같은 오류는 커밋 부족일 수 있습니다. 직접 메모리는 매핑 시 커밋되며 타이틀당 최대 13,824 MiB입니다. 작업 관리자의 커밋 한도에 다른 시스템 사용량도 들어가야 합니다. 실제 부족분에 따라 다른 앱을 닫거나 페이지 파일을 조정하세요.
Linux의 [gpu] open /dev/udmabuf: Permission denied는 dma-buf 경로의 권한·크기 제한을 확인할 신호입니다. 영향받은 메모리 경로가 실패하면 BDA access failed도 나올 수 있습니다. 사용 문서를 따라 점검하세요.
창은 뜨지만 검거나 멈출 때
마지막 로그를 보고 AnyPS5 게임의 같은 게임·빌드와 비교하세요. 배치가 맞아도 로딩이나 그래픽 구현 문제로 멈출 수 있습니다.
다른 GPU가 선택됐다면 Physical device candidate 이름 일부를 지정하세요. 사용 가능한 이름에 NVIDIA가 있을 경우의 예입니다.
$env:ANYPS5_GPU="NVIDIA"
.\app.exe
기본적으로 외장 Vulkan GPU를 우선합니다. 다른 장치가 필요할 때 선택을 바꾸세요. 검은 화면만으로 GPU 선택 문제라고 단정할 수 없고, 일치하지 않는 값이면 시작이 실패합니다.
미구현 호출이나 셰이더·드라이버 오류라면 원 게임 토론에서 같은 실패를 찾으세요. 우회책을 시도하기 전 브랜치와 PR을 기록하세요. AnyPS5 GitHub 가이드에서 출처를 찾을 수 있습니다.
메뉴 글자가 없을 때
시스템 글꼴을 여는 게임은 실행 파일 옆의 anyps5-fonts/ 또는 ANYPS5_SYSTEM_FONTS를 확인하세요. 사용 문서는 Latin/CJK 글꼴과 Noto 대체 파일을 설명합니다. 일반 게임 리소스를 app0/에 복사해도 이 글꼴은 제공되지 않습니다.
조작이 반응하지 않을 때
SDL의 컨트롤러 인식과 다른 패드가 첫 슬롯을 차지했는지 확인하세요. 기본 키보드 조작을 시도하면 매핑 문제인지 게임이 멈춘 것인지 구분하기 쉽습니다.
anyps5-input.ini 또는 ANYPS5_INPUT_CONFIG가 가리키는 파일을 확인하세요. 잘못된 줄은 파일명·줄 번호를 출력하며 입력 초기화를 중단합니다. 입력 매핑 문서와 비교하세요. 터치패드 클릭과 손가락 좌표는 다르며 후자는 구현되지 않았습니다.
빌드를 바꾸기 전 로그 저장
Windows PowerShell:
.\app.exe *>&1 | Tee-Object -FilePath .\launch-log.txt
Linux:
./app.elf 2>&1 | tee launch-log.txt
사용할 stdout/stderr 핸들이 없는 Windows GUI 실행은 폴더가 쓰기 가능하면 실행 파일 옆 anyps5.log를 씁니다. 기존 로그를 덮어쓰므로 다음 실행 전에 복사하세요.
이 페이지의 보고 도구로 게임 버전, 빌드, 하드웨어, 실행 경로와 첫 오류를 모을 수 있습니다. 공유 전 개인 경로와 게임 데이터를 제거하세요. 커뮤니티 배경은 AnyPS5 Reddit, 다른 변환 경로는 AnyPS5 웹 변환기를 보세요.