Conflicts resolved: hle_audio.c keeps the AAudio downmix on Android and takes upstream's 5.1 downmix on Apple; hle_nvn.c keeps mtl_queue_flush / ADPF pacing on Android. Android translates synchronously on the submit thread for now (the Vulkan backend's fence also counts readback commits); Vulkan gets no-op mtl_host_latch / mtl_host_apply; compat adds pthread_attr_set_qos_class_np. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
dm/tools: tool index
中文: README.zh-CN.md
Three kinds of things live here. The first you will use when following the front page or the docs; the second is the measurement and regression scaffolding we use during development, published as is; the third is a set of one-off probes written when the game program was first analysed, kept for the record.
What you will use
| File | What it does |
|---|---|
patch_nso.py |
The program rewriter: rewrites the few instructions in the game program that cannot run unchanged under Apple's kernel and leaves everything else byte-for-byte intact. Called by setup.sh |
extract_game.sh |
Extracts the two parts this project needs (program files and resources) from your own game package into the workspace |
d2rm_pack.py |
Produces a playable install package without Xcode by building your own game files into the "shell"; see docs/NO_XCODE.md |
guest_dylib.py |
Writes the rewritten game program as an Apple-format dynamic library (pure Python, byte-identical output on every system); called by d2rm_pack.py |
winlf/ |
Makes the packaging tool chain use \n line endings on Windows, so packages made on different systems match |
product.sh |
The identifier of the current rewrite output lives in one place (dm/PRODUCT); scripts get paths through this |
dmx.py |
A minimal read-only reader for the game's resource storage: list files, fetch a file |
casc_overlay.py |
Builds the overlay at build time: points chosen resource paths at our new content without touching the original archives |
astc_pack.py |
Supplement pack for older devices: converts BC-format game textures offline into ASTC, which those devices support |
gen_bright_levels.py |
Generates the level table used by the 3D brightness boost (built from your game files) |
tact_bootlist.py |
Generates the startup prefetch list: resource blocks needed before character select, decoded ahead of time at launch |
Measurement and regression scaffolding
| File | What it does |
|---|---|
host_savecmp.sh |
Byte-for-byte save comparison: the host replays a game, saves, and the save is compared with a reference |
save_txn_regress.sh |
Determinism regression for save transactions |
host_war13.sh |
Host replay of one fixed case, compared tick by tick and by save |
l3reg.py, l3seg.sh, l3run.sh, test_l3reg.py |
Long-run memory regression: fits the growth of memory and handles against game ticks and extrapolates to a long session |
frameprobe.sh |
Comparison measurement of frame pacing stability |
conc_watch.sh |
Concurrency check for timed runs: a timing taken while other heavy work was running is discarded |
sampagg.py, lockalign.py |
Aggregation of sampling logs; call-chain statistics for lock-holding threads |
hle_inventory.py |
Inventory of the host's system service implementations (full / simplified / stub) |
sdis.py, sideeff.py |
Disassemble one function; walk the call graph for a function's side effects |
blackcols.py |
Checks a screenshot for fully black columns (whether the picture fills the screen) |
guirun.sh |
Starts a program inside the graphical session and collects its output |
mini_sync.sh |
Syncs the workspace to a second Mac for heavy runs (the target is set in the local config) |
One-off probes from the early analysis
nso.py (splits the game program into segments), fn.py (function boundaries from the unwind table), sweep.py (linear instruction sweep), x18.py and cat18.py (find and classify instructions using x18, a register Apple reserves), xref_sdk.py (cross-references of system library functions), tp.c (checks how the thread pointer register behaves under Apple's kernel). They were written before the rewrite approach was settled and depend on intermediate files from that time; they are not guaranteed to run as they are. The basis of the rewrite approach is in dm/README.md and dm/verify/README.md.