[PR #135] [MERGED] Add mashup technique notes, a table of mashup projects, and a route planning checklist for mashup-mods #152

New issue

Closed

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

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

Base: main ← Head: mashup-routes-contracts-and-evidence-v3

📝 Commits (10+)

bfc18cf Add mashup technique notes, cases reference and route guidance to the mashup skill
7375b85 Tighten wording in the added guides and notes
6d45785 Restore example wording in frame-compositing note
82d8356 Turn the mashup skill's pre-pattern notes into a checklist
8be2ad1 Reword checklist step 6
01bde49 Add a technique note for geometry-transfer mashups
4b16f9c Drop how-we-read lines from the geometry-transfer note
90d7670 Fill gaps in the mashup notes and cases table
a04cf20 Add a technique note for engine recreation
19669a9 Tighten wording in the new mashup additions

📊 Changes

18 files changed (+1496 additions, -25 deletions)

View changed files

📝 .agents/skills/mashup-mods/SKILL.md (+55 -8)
➕ .agents/skills/mashup-mods/references/mashup-cases.md (+45 -0)
📝 .claude/skills/mashup-mods/SKILL.md (+55 -8)
➕ .claude/skills/mashup-mods/references/mashup-cases.md (+45 -0)
📝 knowledge/INDEX.md (+10 -1)
📝 knowledge/games/gta-v/minecraft-passthrough.md (+14 -0)
📝 knowledge/index.json (+256 -0)
➕ knowledge/techniques/bridge-contracts-ownership-units-and-lifecycle.md (+151 -0)
➕ knowledge/techniques/choosing-a-mashup-route.md (+105 -0)
➕ knowledge/techniques/collision-and-combat-bridging.md (+110 -0)
➕ knowledge/techniques/engine-recreation-measures-and-fidelity.md (+106 -0)
➕ knowledge/techniques/evidence-levels-for-mashup-claims.md (+101 -0)
➕ knowledge/techniques/frame-compositing-depth-and-pose-sync.md (+97 -0)
➕ knowledge/techniques/geometry-transfer-host-draws-guest-meshes.md (+86 -0)
➕ knowledge/techniques/installers-load-order-and-loaded-code-checks.md (+63 -0)
➕ knowledge/techniques/rebuilt-guest-engine-inside-a-host.md (+97 -0)
📝 skills/mashup-mods/SKILL.md (+55 -8)
➕ skills/mashup-mods/references/mashup-cases.md (+45 -0)

📄 Description

What: Adds new knowledge-base notes on techniques for cross-game mashups, a reference table of existing mashup projects, and a "Before picking a pattern" checklist to the mashup-mods skill so agents know where to look before choosing a route.

What this adds

Nine knowledge/techniques/ notes:
1. How to choose a mashup route: seven ways to put a game inside a game.
2. How the bridge between two games handles ownership, units, data transfer, and lifecycle.
3. Frame compositing, including depth, pose syncing, lighting, and stale frames.
4. Geometry transfer, where the host renders meshes from the guest game.
5. Collision and combat between two games.
6. Rebuilding a guest engine, or one of its mechanics, inside a real host game.
7. Engine recreation: what different rebuilds measure and what counts as fidelity.
8. Installers, load order, and checking which code is actually loaded in multi-part mods.
9. Evidence levels: distinguishing between reports, source reading, proposals, synthetic tests, and real runs in the game.
skills/mashup-mods/SKILL.md:
1. A seven-step "Before picking a pattern" checklist: what the user wants from the guest, the closest route, the nearest prior project, rebuilt guests, the bridge contract, the first slice and its check, and recording the plan.
2. An update to the Skyrim example, now that SkyCraft is public. In 0.1.2 Minecraft's meshes are drawn inside Skyrim's own renderer, and only the hand, HUD and screens arrive as an image.
3. A note that the frame bridges read pixels back to the CPU and share them through memory, with links to the frame-compositing and collision notes.
skills/mashup-mods/references/mashup-cases.md: a table of existing mashup projects with route, versions, who owns the player, units and transport. A project is named without a link when its repository or release may contain game code, game files or other projects' files, or when it may target a cracked executable.
knowledge/games/gta-v/minecraft-passthrough.md: things to check before relying on the example: the pose-lag default, what install.sh --remove deletes, cleanup scope, frame-reader checks, and what ws_test.cpp asserts.
Copies and index: the skill changes are copied to .agents/skills and .claude/skills, and knowledge/INDEX.md and index.json are regenerated with um kb index.

Checklist

um kb check passes (83 notes) / uv run --with pytest pytest -q tests passes (76 passed, 1 skipped)
um kb index regenerated
no game files, extracted assets, decompiled code dumps or secrets
nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks
versions, verification and what was NOT verified are written down: creator claims are marked as reports, and nothing was run in a real game for these notes
authored by (agent + model / human): Claude Code + Opus 5.5 High / @LeiiLo

🤖 Generated by Claude Code via Opus 5.5 High, with @LeiiLo.

_{🔄 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/135 **Author:** [@LeiiLo](https://github.com/LeiiLo) **Created:** 10/7/2026 **Status:** ✅ Merged **Merged:** 10/8/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `mashup-routes-contracts-and-evidence-v3` --- ### 📝 Commits (10+) - [`bfc18cf`](https://github.com/rehan-remade/universal-modder/commit/bfc18cfac906fc14721064c08c1ca46da43aed47) Add mashup technique notes, cases reference and route guidance to the mashup skill - [`7375b85`](https://github.com/rehan-remade/universal-modder/commit/7375b855cff9239eb1032e05257d995601c65e9b) Tighten wording in the added guides and notes - [`6d45785`](https://github.com/rehan-remade/universal-modder/commit/6d457856e965928cbdb2e59387b6b8ddc15bbb82) Restore example wording in frame-compositing note - [`82d8356`](https://github.com/rehan-remade/universal-modder/commit/82d83564fb785e5e26ee0752b280ed2da15cd4f6) Turn the mashup skill's pre-pattern notes into a checklist - [`8be2ad1`](https://github.com/rehan-remade/universal-modder/commit/8be2ad1781d10177b9350579c6b40d0dcc32956e) Reword checklist step 6 - [`01bde49`](https://github.com/rehan-remade/universal-modder/commit/01bde49af17317a414c9233b2bc10a3d79e075f6) Add a technique note for geometry-transfer mashups - [`4b16f9c`](https://github.com/rehan-remade/universal-modder/commit/4b16f9cf88c99e90c2940b1c66a1c361f596ccc9) Drop how-we-read lines from the geometry-transfer note - [`90d7670`](https://github.com/rehan-remade/universal-modder/commit/90d767097e8ea7f17d87349995c3ec6d5a4868e9) Fill gaps in the mashup notes and cases table - [`a04cf20`](https://github.com/rehan-remade/universal-modder/commit/a04cf20653a3e2e2c099ec1eb4984677ff4b5d0c) Add a technique note for engine recreation - [`19669a9`](https://github.com/rehan-remade/universal-modder/commit/19669a98e42152e14ed2fb64d69170d418352617) Tighten wording in the new mashup additions ### 📊 Changes **18 files changed** (+1496 additions, -25 deletions) <details> <summary>View changed files</summary> 📝 `.agents/skills/mashup-mods/SKILL.md` (+55 -8) ➕ `.agents/skills/mashup-mods/references/mashup-cases.md` (+45 -0) 📝 `.claude/skills/mashup-mods/SKILL.md` (+55 -8) ➕ `.claude/skills/mashup-mods/references/mashup-cases.md` (+45 -0) 📝 `knowledge/INDEX.md` (+10 -1) 📝 `knowledge/games/gta-v/minecraft-passthrough.md` (+14 -0) 📝 `knowledge/index.json` (+256 -0) ➕ `knowledge/techniques/bridge-contracts-ownership-units-and-lifecycle.md` (+151 -0) ➕ `knowledge/techniques/choosing-a-mashup-route.md` (+105 -0) ➕ `knowledge/techniques/collision-and-combat-bridging.md` (+110 -0) ➕ `knowledge/techniques/engine-recreation-measures-and-fidelity.md` (+106 -0) ➕ `knowledge/techniques/evidence-levels-for-mashup-claims.md` (+101 -0) ➕ `knowledge/techniques/frame-compositing-depth-and-pose-sync.md` (+97 -0) ➕ `knowledge/techniques/geometry-transfer-host-draws-guest-meshes.md` (+86 -0) ➕ `knowledge/techniques/installers-load-order-and-loaded-code-checks.md` (+63 -0) ➕ `knowledge/techniques/rebuilt-guest-engine-inside-a-host.md` (+97 -0) 📝 `skills/mashup-mods/SKILL.md` (+55 -8) ➕ `skills/mashup-mods/references/mashup-cases.md` (+45 -0) </details> ### 📄 Description **What:** Adds new knowledge-base notes on techniques for cross-game mashups, a reference table of existing mashup projects, and a "Before picking a pattern" checklist to the `mashup-mods` skill so agents know where to look before choosing a route. ### What this adds 1. **Nine `knowledge/techniques/` notes:** 1. How to choose a mashup route: seven ways to put a game inside a game. 2. How the bridge between two games handles ownership, units, data transfer, and lifecycle. 3. Frame compositing, including depth, pose syncing, lighting, and stale frames. 4. Geometry transfer, where the host renders meshes from the guest game. 5. Collision and combat between two games. 6. Rebuilding a guest engine, or one of its mechanics, inside a real host game. 7. Engine recreation: what different rebuilds measure and what counts as fidelity. 8. Installers, load order, and checking which code is actually loaded in multi-part mods. 9. Evidence levels: distinguishing between reports, source reading, proposals, synthetic tests, and real runs in the game. 2. **`skills/mashup-mods/SKILL.md`:** 1. A seven-step "Before picking a pattern" checklist: what the user wants from the guest, the closest route, the nearest prior project, rebuilt guests, the bridge contract, the first slice and its check, and recording the plan. 2. An update to the Skyrim example, now that SkyCraft is public. In 0.1.2 Minecraft's meshes are drawn inside Skyrim's own renderer, and only the hand, HUD and screens arrive as an image. 3. A note that the frame bridges read pixels back to the CPU and share them through memory, with links to the frame-compositing and collision notes. 3. **`skills/mashup-mods/references/mashup-cases.md`:** a table of existing mashup projects with route, versions, who owns the player, units and transport. A project is named without a link when its repository or release may contain game code, game files or other projects' files, or when it may target a cracked executable. 4. **`knowledge/games/gta-v/minecraft-passthrough.md`:** things to check before relying on the example: the pose-lag default, what `install.sh --remove` deletes, cleanup scope, frame-reader checks, and what `ws_test.cpp` asserts. 5. **Copies and index:** the skill changes are copied to `.agents/skills` and `.claude/skills`, and `knowledge/INDEX.md` and `index.json` are regenerated with `um kb index`. **Checklist** - [x] `um kb check` passes (83 notes) / `uv run --with pytest pytest -q tests` passes (76 passed, 1 skipped) - [x] `um kb index` regenerated - [x] no game files, extracted assets, decompiled code dumps or secrets - [x] nothing that cheats other players or bypasses anti-cheat / DRM / ownership checks - [x] versions, verification and what was NOT verified are written down: creator claims are marked as reports, and nothing was run in a real game for these notes - [x] authored by (agent + model / human): Claude Code + Opus 5.5 High / @LeiiLo 🤖 Generated by [Claude Code](https://claude.com/claude-code) via Opus 5.5 High, with @LeiiLo. --- <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:50 +00:00