[PR #106] [MERGED] knowledge: add 40 field notes from a reverse-engineering workspace #129

New issue

Closed

opened 2026-10-15 20:53:38 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 20:53:38 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/106
Author: @Selene0623
Created: 10/6/2026
Status: ✅ Merged
Merged: 10/8/2026
Merged by: @rehan-remade

Base: main ← Head: kb/re-workspace-field-notes

📝 Commits (10+)

d0ffb78 knowledge: add 47 field notes from a reverse-engineering workspace
68bba41 docs(kb): point wwise-toolchain companion note at repo path, not local cache
18185af kb: regenerate the index on top of current main
0d25d43 kb: link the shader compiler repos and record that shader mods ship
a658174 kb: restore reviewed field-note content from the policy branch
975b5da kb: address review on credits, DRM wording and tool accuracy
f582f4a kb: credit the community fork and fix compression schemes
c4ecf2f kb: correct sample offsets, VMF byte parse and Havok table lengths
9e315b3 kb: mark local unpublished tooling and fix game-data claims
5654017 kb: regenerate the knowledge index

📊 Changes

42 files changed (+8303 additions, -69 deletions)

View changed files

📝 knowledge/INDEX.md (+42 -2)
➕ knowledge/games/battlefield-4/frostbite-3-archive-and-ebx-formats.md (+176 -0)
➕ knowledge/games/cities-skylines/cities-skylines-modding-api-and-container-formats.md (+112 -0)
➕ knowledge/games/far-cry-6/dunia-engine-modding-and-swf-format.md (+115 -0)
➕ knowledge/games/forza-horizon-5/forzatech-carbin-modelbin-and-gamedb.md (+256 -0)
➕ knowledge/games/need-for-speed-most-wanted-2005/aems-abk-bnk-audio-banks.md (+168 -0)
➕ knowledge/games/need-for-speed-shift-2/chameleon-mesh-formats-meb-vhf.md (+204 -0)
➕ knowledge/games/no-mans-sky/hello-games-psar-pak-mbin-formats.md (+145 -0)
➕ knowledge/games/test-drive-unlimited-2/playing-tdu2-online-with-project-paradise-2.md (+165 -0)
➕ knowledge/games/test-drive-unlimited-2/reading-tdu2-vehicle-physics-havok-packfiles.md (+172 -0)
➕ knowledge/games/test-drive-unlimited-2/running-tdu2-on-modern-linux.md (+102 -0)
➕ knowledge/games/test-drive-unlimited-2/tdu2-archive-and-container-formats.md (+377 -0)
➕ knowledge/games/test-drive-unlimited-2/tdu2-savegame-and-gauge-formats.md (+186 -0)
➕ knowledge/games/test-drive-unlimited-2/tdu2-vmf-flash-ui-format.md (+200 -0)
➕ knowledge/games/test-drive-unlimited/opentdu-source-port-and-tdu1-file-formats.md (+139 -0)
➕ knowledge/games/test-drive-unlimited/savegame-and-config-formats.md (+325 -0)
➕ knowledge/games/trackmania-2/maniaplanet-content-locations-and-custom-pack-layout.md (+126 -0)
➕ knowledge/games/watch-dogs/engine-fundamentals-and-native-patching.md (+266 -0)
➕ knowledge/games/watch-dogs/shadow-engine-modding-findings.md (+323 -0)
📝 knowledge/index.json (+1562 -67)

...and 22 more files

📄 Description

What this adds

47 field notes written from one reverse-engineering workspace (~/Documents/Code/re), plus a
regenerated INDEX.md/index.json. No existing note was modified; one duplicate was dropped
(see below).

Games

Game	Note
Battlefield 4	`games/battlefield-4/frostbite-3-archive-and-ebx-formats.md`
Cities: Skylines	`games/cities-skylines/cities-skylines-modding-api-and-container-formats.md`
Far Cry 6	`games/far-cry-6/dunia-engine-modding-and-swf-format.md`
Forza Horizon 5	`games/forza-horizon-5/forzatech-archive-and-texture-formats.md`
NFS: Most Wanted (2005)	`games/need-for-speed-most-wanted-2005/aems-abk-bnk-audio-banks.md`
NFS: Shift 2	`games/need-for-speed-shift-2/slightly-mad-madness-engine-formats.md`
No Man's Sky	`games/no-mans-sky/hello-games-psar-pak-mbin-formats.md`
Starfield	`games/starfield/starfield-animation-af-rig-and-havok-physics.md`
TDU 1	`games/test-drive-unlimited/savegame-and-config-formats.md`, `.../opentdu-source-port-and-tdu1-file-formats.md`
TDU 2	`games/test-drive-unlimited-2/reading-tdu2-vehicle-physics-havok-packfiles.md`, `.../running-tdu2-on-modern-linux.md`, `.../tdu2-savegame-and-gauge-formats.md`, `.../tdu2-archive-and-container-formats.md`, `.../playing-tdu2-online-with-project-paradise-2.md`
Trackmania 2 / ManiaPlanet	`games/trackmania-2/maniaplanet-content-locations-and-custom-pack-layout.md`
Watch Dogs (1)	`games/watch-dogs/engine-fundamentals-and-native-patching.md`, `.../shadow-engine-modding-findings.md`

Techniques

asus-aura-usb-protocol, bethesda-plugin-record-format-esm-esp-esl,
bethesda-esl-light-masters-and-plugin-archive-pairing, disrupt-xbg-glm-mesh-format,
disrupt-material-bin-and-xbt-textures, disrupt-archives-and-fcb-resource-containers,
dunia-swf-file-format, dxbc-dx9bc-shader-decompilation-with-3dmigoto,
frostbite-bundle-chunk-ebx-and-ealayer3, havok-hkx-chunked-packfile-family,
madness-chameleon-binary-containers-bml-sgb,
nintendo-wiiu-3ds-switch-archive-texture-model-formats,
ps3-elf-analysis-in-ghidra, redengine-container-and-asset-format-lineage,
reshade-rtgi-concepts-and-native-port, running-xedit-and-windows-modding-tools-on-linux,
spatial-audio-hrtf-and-immerse-gamepack, static-address-native-hooks-ini-dll,
synthetic-pdb-reconstruction-for-stripped-dlls,
tdu-tdu2-community-data-tooling, tdu2-runtime-patching-version-dll-proxy,
trackmania-forever-3ds-model-export-in-blender,
wwise-soundbank-versions-and-open-toolchain.

Dedupe

techniques/reverse-engineering-ps3-binaries-with-ghidra.md was a strict subset of
techniques/ps3-elf-analysis-in-ghidra.md; the survivor absorbed the one unique link
(kakaroto/ps3ida).

Honesty

agents: on these notes records the drafting agent + model (OpenCode / DeepSeek V4.1 Flash, plus
several general subagents of the same session). humans: is set to the workspace owner.
status is per-note and truthful — several are abandoned or in-progress, and several end in a
named dead end (e.g. the Immerse .dat assets, hkCompatFormats.dll, the TDU2 filename-hash
generator).
Every note has a Verification section saying what was and was not proven. Highlights of what was
not verified: TDU2 Havok repacks were not loaded in-game (only the binary→XML direction was
proven); one TDU2 tool's hash algorithm is marked unrecovered; the ReShade RTGI note is concept-level
with an unknown motion-vector path.

Rules check

No game content, assets, ROMs or ISOs; no download links.
No decompiled dumps — engine internals are described in prose with symbol names only.
Leaked-material knowledge (Havok SDK behaviour, Disrupt symbols) is written up in our own words with
no pasted source, files or keys. License keys are explicitly out of scope.
No anti-cheat, DRM or ownership bypass: TDU2 notes state "static read-only analysis, no bypass
attempted"; the community-server note documents the server's own modding rules and says the
SecuROM/activation steps are deliberately excluded.
No secrets.

Validation

um kb check knowledge/games/...   # every new note
um kb check --index               # PASS: 100 notes checked

(47 notes added, 1 duplicate removed → 100 notes total in the tree after the change.)

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/rehan-remade/universal-modder/pull/106 **Author:** [@Selene0623](https://github.com/Selene0623) **Created:** 10/6/2026 **Status:** ✅ Merged **Merged:** 10/8/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `kb/re-workspace-field-notes` --- ### 📝 Commits (10+) - [`d0ffb78`](https://github.com/rehan-remade/universal-modder/commit/d0ffb785366e8deb9e7211b4ae58231d023a516a) knowledge: add 47 field notes from a reverse-engineering workspace - [`68bba41`](https://github.com/rehan-remade/universal-modder/commit/68bba410c18a3571348164fa71731b675c6d33bb) docs(kb): point wwise-toolchain companion note at repo path, not local cache - [`18185af`](https://github.com/rehan-remade/universal-modder/commit/18185af04887c6a76e1773c1d43b9d5e854f9d35) kb: regenerate the index on top of current main - [`0d25d43`](https://github.com/rehan-remade/universal-modder/commit/0d25d4370c896fa5a9a821ac03950c37918d08f4) kb: link the shader compiler repos and record that shader mods ship - [`a658174`](https://github.com/rehan-remade/universal-modder/commit/a658174a5e2b7682bd6fe70cf8384d485bdc8ce2) kb: restore reviewed field-note content from the policy branch - [`975b5da`](https://github.com/rehan-remade/universal-modder/commit/975b5da0fd97a38dfdc93143c260675a8b3f3751) kb: address review on credits, DRM wording and tool accuracy - [`f582f4a`](https://github.com/rehan-remade/universal-modder/commit/f582f4aadbe990df97ad3bad9b3c6bb633b453b2) kb: credit the community fork and fix compression schemes - [`c4ecf2f`](https://github.com/rehan-remade/universal-modder/commit/c4ecf2f61366ea492d1552530c11a405c675009b) kb: correct sample offsets, VMF byte parse and Havok table lengths - [`9e315b3`](https://github.com/rehan-remade/universal-modder/commit/9e315b3d0b3f5227e694b230e613a5c0201d532e) kb: mark local unpublished tooling and fix game-data claims - [`5654017`](https://github.com/rehan-remade/universal-modder/commit/56540178e080064d5ddd6903b4a989594c4f2369) kb: regenerate the knowledge index ### 📊 Changes **42 files changed** (+8303 additions, -69 deletions) <details> <summary>View changed files</summary> 📝 `knowledge/INDEX.md` (+42 -2) ➕ `knowledge/games/battlefield-4/frostbite-3-archive-and-ebx-formats.md` (+176 -0) ➕ `knowledge/games/cities-skylines/cities-skylines-modding-api-and-container-formats.md` (+112 -0) ➕ `knowledge/games/far-cry-6/dunia-engine-modding-and-swf-format.md` (+115 -0) ➕ `knowledge/games/forza-horizon-5/forzatech-carbin-modelbin-and-gamedb.md` (+256 -0) ➕ `knowledge/games/need-for-speed-most-wanted-2005/aems-abk-bnk-audio-banks.md` (+168 -0) ➕ `knowledge/games/need-for-speed-shift-2/chameleon-mesh-formats-meb-vhf.md` (+204 -0) ➕ `knowledge/games/no-mans-sky/hello-games-psar-pak-mbin-formats.md` (+145 -0) ➕ `knowledge/games/test-drive-unlimited-2/playing-tdu2-online-with-project-paradise-2.md` (+165 -0) ➕ `knowledge/games/test-drive-unlimited-2/reading-tdu2-vehicle-physics-havok-packfiles.md` (+172 -0) ➕ `knowledge/games/test-drive-unlimited-2/running-tdu2-on-modern-linux.md` (+102 -0) ➕ `knowledge/games/test-drive-unlimited-2/tdu2-archive-and-container-formats.md` (+377 -0) ➕ `knowledge/games/test-drive-unlimited-2/tdu2-savegame-and-gauge-formats.md` (+186 -0) ➕ `knowledge/games/test-drive-unlimited-2/tdu2-vmf-flash-ui-format.md` (+200 -0) ➕ `knowledge/games/test-drive-unlimited/opentdu-source-port-and-tdu1-file-formats.md` (+139 -0) ➕ `knowledge/games/test-drive-unlimited/savegame-and-config-formats.md` (+325 -0) ➕ `knowledge/games/trackmania-2/maniaplanet-content-locations-and-custom-pack-layout.md` (+126 -0) ➕ `knowledge/games/watch-dogs/engine-fundamentals-and-native-patching.md` (+266 -0) ➕ `knowledge/games/watch-dogs/shadow-engine-modding-findings.md` (+323 -0) 📝 `knowledge/index.json` (+1562 -67) _...and 22 more files_ </details> ### 📄 Description ## What this adds 47 field notes written from one reverse-engineering workspace (`~/Documents/Code/re`), plus a regenerated `INDEX.md`/`index.json`. No existing note was modified; one duplicate was dropped (see below). ### Games | Game | Note | |---|---| | Battlefield 4 | `games/battlefield-4/frostbite-3-archive-and-ebx-formats.md` | | Cities: Skylines | `games/cities-skylines/cities-skylines-modding-api-and-container-formats.md` | | Far Cry 6 | `games/far-cry-6/dunia-engine-modding-and-swf-format.md` | | Forza Horizon 5 | `games/forza-horizon-5/forzatech-archive-and-texture-formats.md` | | NFS: Most Wanted (2005) | `games/need-for-speed-most-wanted-2005/aems-abk-bnk-audio-banks.md` | | NFS: Shift 2 | `games/need-for-speed-shift-2/slightly-mad-madness-engine-formats.md` | | No Man's Sky | `games/no-mans-sky/hello-games-psar-pak-mbin-formats.md` | | Starfield | `games/starfield/starfield-animation-af-rig-and-havok-physics.md` | | TDU 1 | `games/test-drive-unlimited/savegame-and-config-formats.md`, `.../opentdu-source-port-and-tdu1-file-formats.md` | | TDU 2 | `games/test-drive-unlimited-2/reading-tdu2-vehicle-physics-havok-packfiles.md`, `.../running-tdu2-on-modern-linux.md`, `.../tdu2-savegame-and-gauge-formats.md`, `.../tdu2-archive-and-container-formats.md`, `.../playing-tdu2-online-with-project-paradise-2.md` | | Trackmania 2 / ManiaPlanet | `games/trackmania-2/maniaplanet-content-locations-and-custom-pack-layout.md` | | Watch Dogs (1) | `games/watch-dogs/engine-fundamentals-and-native-patching.md`, `.../shadow-engine-modding-findings.md` | ### Techniques `asus-aura-usb-protocol`, `bethesda-plugin-record-format-esm-esp-esl`, `bethesda-esl-light-masters-and-plugin-archive-pairing`, `disrupt-xbg-glm-mesh-format`, `disrupt-material-bin-and-xbt-textures`, `disrupt-archives-and-fcb-resource-containers`, `dunia-swf-file-format`, `dxbc-dx9bc-shader-decompilation-with-3dmigoto`, `frostbite-bundle-chunk-ebx-and-ealayer3`, `havok-hkx-chunked-packfile-family`, `madness-chameleon-binary-containers-bml-sgb`, `nintendo-wiiu-3ds-switch-archive-texture-model-formats`, `ps3-elf-analysis-in-ghidra`, `redengine-container-and-asset-format-lineage`, `reshade-rtgi-concepts-and-native-port`, `running-xedit-and-windows-modding-tools-on-linux`, `spatial-audio-hrtf-and-immerse-gamepack`, `static-address-native-hooks-ini-dll`, `synthetic-pdb-reconstruction-for-stripped-dlls`, `tdu-tdu2-community-data-tooling`, `tdu2-runtime-patching-version-dll-proxy`, `trackmania-forever-3ds-model-export-in-blender`, `wwise-soundbank-versions-and-open-toolchain`. ## Dedupe `techniques/reverse-engineering-ps3-binaries-with-ghidra.md` was a strict subset of `techniques/ps3-elf-analysis-in-ghidra.md`; the survivor absorbed the one unique link (`kakaroto/ps3ida`). ## Honesty - `agents:` on these notes records the drafting agent + model (OpenCode / DeepSeek V4.1 Flash, plus several `general` subagents of the same session). `humans:` is set to the workspace owner. - `status` is per-note and truthful — several are `abandoned` or `in-progress`, and several end in a named dead end (e.g. the Immerse `.dat` assets, `hkCompatFormats.dll`, the TDU2 filename-hash generator). - Every note has a **Verification** section saying what was and was not proven. Highlights of what was **not** verified: TDU2 Havok repacks were not loaded in-game (only the binary→XML direction was proven); one TDU2 tool's hash algorithm is marked unrecovered; the ReShade RTGI note is concept-level with an unknown motion-vector path. ## Rules check - No game content, assets, ROMs or ISOs; no download links. - No decompiled dumps — engine internals are described in prose with symbol names only. - Leaked-material knowledge (Havok SDK behaviour, Disrupt symbols) is written up in our own words with no pasted source, files or keys. License keys are explicitly out of scope. - No anti-cheat, DRM or ownership bypass: TDU2 notes state "static read-only analysis, no bypass attempted"; the community-server note documents the server's own modding rules and says the SecuROM/activation steps are deliberately excluded. - No secrets. ## Validation ``` um kb check knowledge/games/... # every new note um kb check --index # PASS: 100 notes checked ``` (47 notes added, 1 duplicate removed → 100 notes total in the tree after the change.) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 20:53:38 +00:00