[PR #210] [MERGED] kb: Super Smash Bros. Melee's decompiled engine inside Terraria, plus 6 technique notes (Terraria) #213

New issue

Closed

opened 2026-10-15 20:54:24 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 20:54:24 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/210
Author: @DarkameMaster
Created: 10/10/2026
Status: ✅ Merged
Merged: 10/11/2026
Merged by: @rehan-remade

Base: main ← Head: kb/melee-in-terraria-notes-2026-10-10

📝 Commits (4)

2bf9f77 kb: Super Smash Bros. Melee's decompiled engine inside Terraria, plus 7 technique notes
e550aa9 kb: Melee in Terraria notes: review fixes
7e8b1eb Merge remote-tracking branch 'origin/main' into land/pr-210
de18cd0 Merge remote-tracking branch 'origin/main' into land/pr-210

📊 Changes

11 files changed (+1815 additions, -6 deletions)

View changed files

📝 knowledge/INDEX.md (+9 -2)
➕ knowledge/games/terraria/super-smash-bros-melee-s-decompiled-engine-inside-terraria-a.md (+416 -0)
📝 knowledge/index.json (+264 -2)
➕ knowledge/techniques/bit-exact-decomp-ports-reproduce-the-original-compiler-s-and.md (+227 -0)
➕ knowledge/techniques/hosting-a-decompiled-console-engine-as-a-native-dll-inside-a.md (+282 -0)
📝 knowledge/techniques/oracles-how-agents-know-a-mod-works.md (+5 -0)
➕ knowledge/techniques/prove-your-replay-bench-can-fail-mutant-builds-exposed-four-.md (+99 -0)
📝 knowledge/techniques/recording-game-footage.md (+25 -2)
➕ knowledge/techniques/running-several-isolated-tmodloader-test-instances-in-parall.md (+163 -0)
➕ knowledge/techniques/skinned-3d-models-inside-tmodloader-posed-by-an-external-eng.md (+238 -0)
➕ knowledge/techniques/when-the-first-real-run-fails-suspect-the-oracle-re-deriving.md (+87 -0)

📄 Description

Field notes from Melee 1:1 in Terraria, a tModLoader mod that runs Super Smash Bros. Melee's decompiled engine (a PC build of the community decomp) as a native DLL inside Terraria, with the fighters drawn in 3D.

One game note and seven technique notes:

Game note (games/terraria, Melee in games_also)

Super Smash Bros. Melee's decompiled engine inside Terraria: route, engine facts, verification, gotchas and today's state (integration, first real lab run, a replayed CPU match identical to the engine frame for frame).

Technique notes

Hosting a decompiled console engine as a native DLL inside another game (updated)
Bit-exact decomp ports reproduce the original compiler's rounding (updated)
Skinned 3D models inside tModLoader posed by an external engine (updated)
Running several isolated tModLoader test instances in parallel (new)
When the first real run fails, suspect the oracle (new)
Prove your replay bench can fail: mutant builds exposed four false greens (new)
Recording game footage: three new gotchas (per-app mixer mute silences process loopback, an emulator frame dump that gave nothing usable, "minimized, not activated" still taking the foreground)

Notes on scope and honesty:

Nothing from the game is included (no game files, extracted assets, decompiled code or hashes). Every player needs their own copy of Melee NTSC-U 1.02.
Status is honest: each note lists what was verified, at which evidence level (synthetic, source inspection, real run), what was not verified, and open questions. Work still in progress is marked as such.
um kb check passes on all eight notes; the index was regenerated with um kb index.

Credits: DarkameMaster (human direction), built with Claude Code and agents, with Grok as a read-only reviewer.

🤖 Generated with Claude Code

_{🔄 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/210 **Author:** [@DarkameMaster](https://github.com/DarkameMaster) **Created:** 10/10/2026 **Status:** ✅ Merged **Merged:** 10/11/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `kb/melee-in-terraria-notes-2026-10-10` --- ### 📝 Commits (4) - [`2bf9f77`](https://github.com/rehan-remade/universal-modder/commit/2bf9f776642f81b23a4922937371e36592aae152) kb: Super Smash Bros. Melee's decompiled engine inside Terraria, plus 7 technique notes - [`e550aa9`](https://github.com/rehan-remade/universal-modder/commit/e550aa911faa84368173f82e78c1a3839ec991f4) kb: Melee in Terraria notes: review fixes - [`7e8b1eb`](https://github.com/rehan-remade/universal-modder/commit/7e8b1eb6736b316a51c40a0d9e21b1ebc0d51ed0) Merge remote-tracking branch 'origin/main' into land/pr-210 - [`de18cd0`](https://github.com/rehan-remade/universal-modder/commit/de18cd0bfd3baf988877340ea3bebf4fe9700adf) Merge remote-tracking branch 'origin/main' into land/pr-210 ### 📊 Changes **11 files changed** (+1815 additions, -6 deletions) <details> <summary>View changed files</summary> 📝 `knowledge/INDEX.md` (+9 -2) ➕ `knowledge/games/terraria/super-smash-bros-melee-s-decompiled-engine-inside-terraria-a.md` (+416 -0) 📝 `knowledge/index.json` (+264 -2) ➕ `knowledge/techniques/bit-exact-decomp-ports-reproduce-the-original-compiler-s-and.md` (+227 -0) ➕ `knowledge/techniques/hosting-a-decompiled-console-engine-as-a-native-dll-inside-a.md` (+282 -0) 📝 `knowledge/techniques/oracles-how-agents-know-a-mod-works.md` (+5 -0) ➕ `knowledge/techniques/prove-your-replay-bench-can-fail-mutant-builds-exposed-four-.md` (+99 -0) 📝 `knowledge/techniques/recording-game-footage.md` (+25 -2) ➕ `knowledge/techniques/running-several-isolated-tmodloader-test-instances-in-parall.md` (+163 -0) ➕ `knowledge/techniques/skinned-3d-models-inside-tmodloader-posed-by-an-external-eng.md` (+238 -0) ➕ `knowledge/techniques/when-the-first-real-run-fails-suspect-the-oracle-re-deriving.md` (+87 -0) </details> ### 📄 Description Field notes from **Melee 1:1 in Terraria**, a tModLoader mod that runs Super Smash Bros. Melee's decompiled engine (a PC build of the community decomp) as a native DLL inside Terraria, with the fighters drawn in 3D. One game note and seven technique notes: **Game note (`games/terraria`, Melee in `games_also`)** - Super Smash Bros. Melee's decompiled engine inside Terraria: route, engine facts, verification, gotchas and today's state (integration, first real lab run, a replayed CPU match identical to the engine frame for frame). **Technique notes** - Hosting a decompiled console engine as a native DLL inside another game (updated) - Bit-exact decomp ports reproduce the original compiler's rounding (updated) - Skinned 3D models inside tModLoader posed by an external engine (updated) - Running several isolated tModLoader test instances in parallel (new) - When the first real run fails, suspect the oracle (new) - Prove your replay bench can fail: mutant builds exposed four false greens (new) - Recording game footage: three new gotchas (per-app mixer mute silences process loopback, an emulator frame dump that gave nothing usable, "minimized, not activated" still taking the foreground) Notes on scope and honesty: - Nothing from the game is included (no game files, extracted assets, decompiled code or hashes). Every player needs their own copy of Melee NTSC-U 1.02. - Status is honest: each note lists what was verified, at which evidence level (synthetic, source inspection, real run), what was **not** verified, and open questions. Work still in progress is marked as such. - `um kb check` passes on all eight notes; the index was regenerated with `um kb index`. Credits: DarkameMaster (human direction), built with Claude Code and agents, with Grok as a read-only reviewer. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 20:54:24 +00:00