Comece pela primeira etapa com falha
Escolha onde para e siga as verificações do seu sistema.
Confira formato de entrada e opção de destino
- Confirme ELF limpo e diretório de módulos compatível; --sce-module-path recebe a pasta pai.
- Selecione --windows explicitamente. O nome .exe mantém o formato Linux padrão se você não escolher Windows.
- Compare opções com a documentação da mesma versão. Evite opções de depuração obsoletas numa tentativa básica.
Código 0 pode significar que a ajuda foi exibida. Com --autorun, o código pode pertencer ao aplicativo iniciado. Guarde comando e log com o número.
Entradas, opções e códigos de saída v0.1.2 ↗Criar relato de problemas
Monte um relato para copiar numa issue ou discussão do GitHub. Este formulário não envia suas informações.
Usa outra compilação? Siga a documentação correspondente e compare os relatos em relatos de jogos no AnyPS5.
Quando o AnyPS5 não funciona, comece pela primeira etapa que falha: ler entradas, converter, carregar bibliotecas ou executar o jogo. Isso indica se deve conferir arquivos, comando, pasta de execução ou bloqueios atuais do título.
Tenha o primeiro erro útil por perto. As verificações seguem o USAGE da v0.1.2; branches específicas podem exigir outros passos.
O relinker não lê a entrada
Confirme um ELF limpo, não um pacote criptografado ou contêiner SELF/fSELF. O nome eboot.bin não confirma que o conteúdo está pronto. Use arquivos com os direitos necessários.
Depois, confira os módulos:
source/
input.elf
sce_module/
bundled-module.prx
São reconhecidos sce_module/, sce_modules/ e prx/. prx/ pode coexistir com um dos outros dois. Ter ambos sce_module/ e sce_modules/, ou nenhum dos três, é erro. Apenas arquivos diretamente nessas pastas são processados.
--sce-module-path aponta para a pasta pai do diretório de módulos. Para pastas extras, como plugins, confira se o relato usa --module-dir. A instalação do AnyPS5 reúne a estrutura de entrada e saída.
O Windows não inicia a saída
O padrão é ELF Linux, mesmo com nome app.exe. Converta novamente com --windows:
.\relinker-v0.1.2.exe --windows source\input.elf app.exe
Se houver instrução ilegal em Intel, confira --to-intel. Cobre instruções AMD reconhecidas nas entradas e módulos, não as geradas em execução. Preserve os detalhes se continuar falhando. Os requisitos do AnyPS5 explicam essa rota.
Erro 193 ou 126 no Windows
| Erro | Primeira verificação | Correção |
|---|---|---|
| 193: not a valid Win32 application | Há .prx original do console em libs/? |
Troque pela biblioteca Windows AnyPS5 correspondente. Módulos convertidos do jogo ficam nas rotas Guest module: sob app0/. |
| 126: module not found | Falta dependência mesmo com o .prx presente? |
Confira DLLs MinGW do pacote Windows e demais dependências em libs/. |
A v0.1.2 inclui libgcc_s_seh-1.dll, libstdc++-6.dll e libwinpthread-1.dll; mantenha as três em libs/. Se compilou as bibliotecas, use DLLs de mingw64/bin da mesma cadeia MinGW, sem misturar runtimes.
O mapeamento de memória direta falha
No Windows, replace guest placeholder with resident direct memory pode indicar falta no limite de comprometimento. A memória é comprometida ao ser mapeada, até 13.824 MiB por jogo. O limite Comprometido no Gerenciador de Tarefas deve cobri-la e ao restante do sistema. Feche aplicativos ou ajuste a paginação conforme a falta real.
No Linux, [gpu] open /dev/udmabuf: Permission denied aponta para outra verificação. Em drivers com importação dma-buf, siga as permissões e limites de tamanho do manual. Também pode aparecer BDA access failed quando esse caminho de memória não funciona.
A janela abre, mas fica preta ou travada
Leia as últimas linhas e compare jogo/compilação em jogos no AnyPS5. Um título pode parar em carregamento ou ter problemas gráficos mesmo com os arquivos corretos.
Se foi escolhida outra GPU, leia Physical device candidate e selecione parte do nome desejado. Por exemplo, se um dispositivo utilizável contiver NVIDIA:
$env:ANYPS5_GPU="NVIDIA"
.\app.exe
O runtime já prefere GPU Vulkan dedicada. Trocar a seleção ajuda quando precisa de outro adaptador; uma janela preta sozinha não demonstra seleção errada. Sem correspondência utilizável, a inicialização falha.
Se parar em chamada não implementada ou erro de shader/driver, pesquise a falha na discussão original. Registre branch ou pull request de qualquer alternativa antes de testá-la. O AnyPS5 no GitHub ajuda a encontrá-las.
Os menus não têm texto
Para jogos que abrem fontes do console, confira anyps5-fonts/ ou defina ANYPS5_SYSTEM_FONTS. O manual lista arquivos e substitutos Noto, inclusive latinos e CJK. Sem as fontes, a abertura pode falhar; recursos normais em app0/ não as fornecem.
Os controles não respondem
Confira se SDL reconhece o controle e se outro ocupa a primeira posição. Tente o teclado integrado para separar um problema de mapeamento de um jogo que parou de responder.
Verifique anyps5-input.ini ou o arquivo de ANYPS5_INPUT_CONFIG. Uma linha inválida impede inicialização e informa arquivo/linha. Compare com as instruções de entrada. Clique no touchpad não é a mesma função que coordenadas dos dedos, não implementadas no documento.
Guarde um log antes de mudar a compilação
No PowerShell:
.\app.exe *>&1 | Tee-Object -FilePath .\launch-log.txt
No Linux:
./app.elf 2>&1 | tee launch-log.txt
Uma execução gráfica Windows sem stdout/stderr utilizáveis pode gravar anyps5.log ao lado do executável, se houver permissão de escrita. Ele substitui o log anterior; copie antes de tentar novamente.
O gerador desta página organiza versão, compilação, hardware, inicialização e primeiro erro. Retire caminhos pessoais e dados do jogo antes de compartilhar. Veja AnyPS5 no Reddit para contexto ou o conversor web do AnyPS5 para outra rota.