From 09bd0731fc3a9db151d2ca7110bbcfdd38fd69d4 Mon Sep 17 00:00:00 2001 From: MarcZX10 <67475268+MarcZX10@users.noreply.github.com> Date: Mon, 26 Oct 2026 14:02:50 +0000 Subject: [PATCH] docs(game-testing): say what exit code 1 of the import audit means --- docs/dev/GAME_TESTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dev/GAME_TESTING.md b/docs/dev/GAME_TESTING.md index ade7d2a3b7..5a3ab4513d 100644 --- a/docs/dev/GAME_TESTING.md +++ b/docs/dev/GAME_TESTING.md @@ -14,7 +14,7 @@ For user options see [USAGE](../user/USAGE.md); for internals see [ARCHITECTURE] - A dump whose `app0` holds `ampr_assets.index` and `ampr_assets-*.pak` was repacked for [ampr_emu](https://github.com/drakmor/ampr_emu): the packed files were removed from `app0`, and only ampr_emu reads the packs. Restore them first with ampr_emu's `tools/ampr_pack.py unpack --index app0/ampr_assets.index --output ` and copy the files missing from `app0`. Without them a Unity title stops at start-up on the missing `Media/Resources/unity default resources`. - Convert every module the title loads from its own folders (`sce_module/`, `Media/Modules/`, `Media/Plugins/`). Unity titles need `--module-dir Media/Modules --module-dir Media/Plugins`. The relinker writes each converted module as `.guest.prx` into `app0/` beside the output, in the module's own folder, and lists it in the `Arrange the files like this` tree it prints. Keep the original `.prx` next to it. - `libs/` holds only AnyPS5's own libraries, from `build/core/libs/libs` (not `unpatched/`). A game module placed there fails to load (error 193 on Windows). A self-built `libs/` on Windows also needs `libgcc_s_seh-1.dll`, `libstdc++-6.dll` and `libwinpthread-1.dll` from the toolchain's `mingw64/bin`, or every library fails with error 126 ([USAGE](../user/USAGE.md#runtime-layout)). -- Run `tools/import_audit.py` on the registries. Exit code 1 lists imports that will fail or throw. +- Run `tools/import_audit.py` on the registries. Exit code 1 means an import or a needed library is missing; the report also lists `stub` imports, which throw when called, and `--strict-stubs` makes them fail the audit too. `tools/audit_dump.py --relinker --libs build/core/libs/libs` (`--windows` on Windows) does the unwrapping, the conversion with `--registry` and the audit in one step, from every module folder above and `.prx` files beside `eboot.bin`, into a temporary directory (or `--work `), reading the dump only.