
dist/LEIA-ME-games.txt
========================================
Jogos
=====

Uma pasta por jogo, extraída e desencriptada da SUA consola, com a estrutura:

  games\<pasta do jogo>\eboot.bin
  games\<pasta do jogo>\sce_sys\param.json
  games\<pasta do jogo>\sce_module\   (se o jogo tiver)

Os jogos NUNCA vêm com o emulador e não devem ser compartilhados.

dist/LEIA-ME-system.txt
========================================
Bibliotecas de sistema do console
=================================

Coloque em system\modules\ estes ficheiros, extraídos e desencriptados da SUA PS5
(ficam em /system/common/lib/ no console):

  libSceAgc.sprx
  libSceAgcDriver.sprx
  libSceAmpr.sprx
  libScePsml.sprx

Alguns jogos exigem estas bibliotecas; o launcher avisa quais estão em falta.
Eles NUNCA vêm com o emulador e não devem ser compartilhados com outras
pessoas (copiar entre os seus próprios PCs pode).
A pasta escolhida em Configurações tem prioridade. As bibliotecas locais encontradas são copiadas para coleções em system/modules/collections. Novos conjuntos são acrescentados sem misturar pastas de origem nem substituir versões. As cópias completas continuam disponíveis sem o disco original. Não são descarregadas bibliotecas.

dist/LEIA-ME.txt
========================================
ZeraPS5 0.1.0+2555f7a-dirty (build 571, 2026-10-29) — candidato local para revisão

Emulador experimental de PlayStation 5 para Windows x86-64.
Não há garantia de compatibilidade, estabilidade ou FPS.

Idiomas: menu Idiomas, ou Configurações > Idiomas. Há 15 opções de interface,
incluindo árabe, farsi, russo e ucraniano. Veja docs/IDIOMAS.txt.

1. Extraia o ZIP em uma pasta gravável, fora de Program Files.
2. Leia system/LEIA-ME.txt; adicione apenas módulos do próprio console.
3. Abra ZeraPS5.exe e adicione as pastas dos seus jogos em Configurações.
4. Selecione o jogo e clique em Jogar. Pastas e imagens .exfat usam o suporte
   existente. Este pacote não extrai jogos nem descriptografa ficheiros.

Requisitos: Windows 10/11 x64, CPU x86-64/AVX2, GPU Vulkan 1.3 e driver
atualizado. Python, CMake e MSYS2 não são necessários para usar os executáveis.
O driver Vulkan vem do fabricante da GPU, não deste ZIP.
DualSense USB e XInput usam o suporte existente. Nenhum novo controle foi
validado nesta edição. Consulte docs/LIMITACOES.txt antes de testar jogos.

user/ é criado no primeiro uso e guarda saves, configurações, caches e logs.
Não compartilhe essa pasta inteira. Relatórios são locais por padrão; linhas
com caminhos, nomes locais e credenciais comuns são omitidas. Revise o ZIP e
a descrição antes de compartilhar: o filtro não remove qualquer dado possível.

Atualizações estáveis Windows x64 são consultadas automaticamente em
https://github.com/zeraps5/ZeraPS5-Releases/releases/latest/download/latest.json
sem login, token ou identificação do computador. A consulta pode ser desligada
nas Configurações. Instalar uma nova versão pede confirmação.
O destino depende de publicação futura autorizada. Sem release acessível,
a versão local continua disponível. A instalação verifica integridade e
preserva user/, games/ e system/. Recuperação: docs/ATUALIZACOES.txt.

Fontes reais, FFmpeg e objetos de religação: sources/ e docs/RECOMPILAR.txt.
Licenças e créditos: LICENSE, CREDITS.txt e licenses/.
Não há jogos, firmware, módulos do console ou chaves no pacote. Use somente
cópias extraídas legalmente do próprio console. Não há afiliação com a Sony.

dist/docs/ATUALIZACOES.txt
========================================
Atualização e recuperação

Canal estável Windows x86-64: zeraps5/ZeraPS5-Releases no GitHub.
O repositório de desenvolvimento zeraps5/ZeraPS5 permanece privado.
O destino de distribuição ainda depende de criação e publicação autorizadas.
O launcher consulta releases/latest/download/latest.json por HTTPS, sem token,
nome do computador ou identificador da instalação. Não utiliza a API REST.
O redirecionamento latest seleciona a release estável. Falta de release,
HTTP 403/429 ou falha de rede preservam a instalação, sem repetição contínua.

A nova versão é oferecida para confirmação. A aplicação espera o launcher
fechar, não encerra processos e recusa atualização com jogo desta pasta ativo.
Confere SHA-256 do ZIP, canal/arquitetura e hash/tamanho dos ficheiros internos.
Caminhos externos, links, colisões e ficheiros pessoais são recusados.
user/, games/ e system/ não são substituídos.

Backups e diário ficam em user/updates/transaction. Uma falha de cópia restaura
o programa anterior. Uma interrupção durante a cópia dispara recuperação no
próximo início do launcher. Para recuperação manual, feche esta instalação e use:
powershell -NoProfile -ExecutionPolicy Bypass -File "user/updates/Recuperar-ZeraPS5.ps1" -InstallRoot "PASTA_DA_INSTALACAO" -Recover
A cópia de recuperação é criada ao iniciar uma atualização. Consulte também
user/updates/result.txt. Mantenha transaction/backup até validar a nova versão.

SHA-256 verifica integridade em relação ao manifesto obtido por HTTPS;
não é assinatura Authenticode. Esta candidata não tem assinatura digital.

Por predefinição, o programa verifica atualizações ao abrir. Também pode usar o botão Verificar atualizações no ecrã principal. A consulta ao iniciar pode ser desligada nas Configurações.

dist/docs/IDIOMAS.txt
========================================
Idiomas da interface do ZeraPS5

Abra o menu Idiomas na parte superior do launcher. Também há um botão
Idiomas em Configurações. A escolha é salva ao confirmar e vale na próxima
abertura; os menus e a tela principal mudam imediatamente, sem reiniciar jogos.

15 opções:
- Português (Brasil) — pt-BR
- Português (Portugal) — pt-PT
- Inglês — en
- Espanhol — es
- Francês — fr
- Alemão — de
- Italiano — it
- Japonês — ja
- Coreano — ko
- Chinês simplificado — zh-CN
- Chinês tradicional — zh-TW
- Árabe — ar
- Farsi (persa) — fa
- Russo — ru
- Ucraniano — uk

Árabe e farsi usam leitura e disposição da direita para a esquerda. Os
campos de caminhos e do endereço de atualização continuam da esquerda para
a direita para preservar sua leitura. As opções exibem seus nomes nativos
para facilitar voltar ao idioma desejado.

A preferência fica em [interface] idioma de user/config/zeraps5.ini e é
independente de [geral] idioma, que informa a língua do console ao jogo.
Ela não instala traduções, fontes ou ficheiros de idioma nos jogos.
O idioma e os idiomas disponíveis em cada jogo dependem dos seus ficheiros.

Menus, controles, avisos, erros, campos dos relatórios e resultados das
atualizações usam o idioma escolhido. Abra Ajuda técnica para ler a ajuda
nesse idioma; Ver log mostra os registros novos no idioma escolhido, mesmo
se a preferência mudar depois da execução.

Códigos, nomes de ficheiros, modelos de hardware e títulos dos jogos são dados
e permanecem intactos. A descrição escrita pelo usuário não é traduzida.
Os registros originais continuam em user/logs para diagnóstico. Sessões
anteriores sem registro estruturado precisam ser executadas novamente para
gerar a visualização traduzida. A cópia estruturada é limitada a 64 MiB por
execução; a janela mostra até 1 MiB do trecho final da visualização.
Licenças e créditos mantêm seus textos originais e sua validade.

Os catálogos ficam em frontends/launcher/. Os geradores verificam os parâmetros
de formatação; tools/check_localization.py verifica a cobertura e reprodução.
As traduções técnicas foram assistidas por software local e revisadas em parte.
Ainda precisam de revisão por falantes nativos de todos os idiomas.

dist/docs/LIMITACOES.txt
========================================
Estado desta candidata

Organização de distribuição e atualização; não anuncia novo ganho de FPS.
Jogos comerciais não foram abertos para validar este pacote, preservando os
testes em andamento. Resultados anteriores não são promessa de compatibilidade.

Diablo II ainda não tem gameplay comprovado: textos e abertura melhoraram,
mas faltam personagens/cena e há pressão de memória/cache. Outros jogos
continuam sujeitos a defeitos gráficos, quedas e lentidão do desenvolvimento.
Experimentos opt-in continuam desligados por padrão. Não foi reduzida a
qualidade dos jogos e não há caches ou configurações pessoais no pacote.

O canal de Releases foi preparado para ensaio local. A hospedagem real
depende de criação/publicação autorizada em zeraps5/ZeraPS5-Releases.
Nenhum repositório, release, visibilidade ou conta foi alterado aqui.

dist/docs/PUBLICACAO.txt
========================================
Publicação futura — etapa manual, ainda não autorizada

Destino de distribuição escolhido: zeraps5/ZeraPS5-Releases, público e separado.
Desenvolvimento: zeraps5/ZeraPS5, privado. Não transferir nem abrir este último.
Esta preparação não cria repositórios, não envia ficheiros e não publica releases.

Após autorização específica do usuário:
1. Criar/conferir o repositório separado de distribuição e sua visibilidade.
2. Revisar o relatório local, executar os testes e revisar o ZIP final.
3. Conferir SHA256SUMS e os fontes reais correspondentes. O ZIP binário inclui
   sources/ZeraPS5-source.zip, FFmpeg e objetos para religação. Enviar também
   o asset versionado *-source.zip; "Source code" automático não o substitui.
4. Usar tools/publish-release.ps1 manualmente com -PackageDir e
   -AuthorizePublication. O script exige confirmação e cria somente um rascunho.
   Não é executado por compilação, empacotamento ou mudanças no desenvolvimento.
5. Revisar/baixar os assets do rascunho e publicar a release estável manualmente
   só após aprovação. latest.json deve acompanhar o ZIP cujo SHA indica.
6. Verificar o redirecionamento público releases/latest/download/latest.json
   e realizar uma atualização de uma instalação de teste com saves fictícios.

Use números de build crescentes, sem reutilizar tags/nomes de pacotes. O canal
automático ignora versões preview e outras arquiteturas. Releases estáveis
anteriores devem ser mantidas para recuperação. Não há token no aplicativo.
O login gh do responsável pela publicação é separado da distribuição.

Fontes oficiais consultadas:
https://docs.github.com/en/repositories/releasing-projects-on-github/linking-to-releases
https://ffmpeg.org/legal.html

dist/docs/RECOMPILAR.txt
========================================
Fontes correspondentes e religação

sources/ZeraPS5-source.zip contém fontes reais, testes, cabeçalhos, CMake,
scripts, materiais dist/ e licenças da revisão indicada no manifesto.
O ficheiro automático "Source code" do GitHub não substitui esses fontes.
Não há administração Git, histórico pessoal ou configurações da máquina.

Requisitos: Windows x64, MSYS2 UCRT64 GCC/binutils/make, CMake >= 3.21 e nasm
para reconstruir FFmpeg. Extraia os fontes ZeraPS5; coloque ffmpeg-7.1.2.tar.xz
em third_party/ffmpeg/ e execute no MSYS2 UCRT64: sh tools/build_ffmpeg.sh
Depois, com UCRT64/bin no PATH:
cmake -S . -B build/distribution -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release
cmake --build build/distribution --parallel 2
ctest --test-dir build/distribution --output-on-failure

Para trocar FFmpeg, altere/recompile seus fontes e reconstrua ZeraPS5 contra
os novos include/lib. ZeraPS5-relink-objects.zip fornece também objetos do
aplicativo e link.txt com a ordem das bibliotecas para religar sem recompilar.
Substitua <SOURCE>/<BUILD> pelas suas pastas e libav*.a pela versão reconstruída;
execute o comando no diretório de build. Bibliotecas MinGW vêm do MSYS2.

SOURCE-VERSION.txt preserva a identificação sem .git. Igualdade byte a byte
entre toolchains diferentes não foi certificada. Não há restrições adicionais
de uso, modificação, depuração ou redistribuição além das licenças aplicáveis.
