[PR #267] [MERGED] skills: Binding of Isaac engine playbook (Lua mods, REPENTOGON, anm2, console, automation) #267

New issue

Closed

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

Original PR: https://github.com/rehan-remade/universal-modder/pull/267
Author: @FraserDuncan
Created: 10/12/2026
Status: ✅ Merged
Merged: 10/14/2026
Merged by: @rehan-remade

Base: main ← Head: skills/isaac-playbook

📝 Commits (4)

86e8df0 skills: Binding of Isaac engine playbook (Lua mods, REPENTOGON, anm2, console, automation)
2ce1bab skills(isaac): verify in game and widen the sources
feca469 skills(isaac): review fixes
cd39b6e Merge remote-tracking branch 'origin/main' into land/pr-267

📊 Changes

9 files changed (+475 additions, -7 deletions)

View changed files

📝 .agents/skills/mod-any-game/SKILL.md (+4 -2)
➕ .agents/skills/mod-any-game/references/engines/isaac.md (+150 -0)
📝 .claude/skills/mod-any-game/SKILL.md (+4 -2)
➕ .claude/skills/mod-any-game/references/engines/isaac.md (+150 -0)
📝 README.md (+1 -1)
📝 skills/mod-any-game/SKILL.md (+4 -2)
➕ skills/mod-any-game/references/engines/isaac.md (+150 -0)
📝 tests/test_um.py (+8 -0)
📝 um/scan.py (+4 -0)

📄 Description

Adds skills/mod-any-game/references/engines/isaac.md, a single-game playbook in the style of genie-aoe2.md and bannerlord.md, and routes The Binding of Isaac: Rebirth to it from um scan (recon previously reported "Unknown native engine" and suggested proxy DLLs for a game with a full Lua API).

What it covers: identify; the Lua route and when REPENTOGON is needed; mod anatomy (metadata.xml, alphabetical load order, require vs include, SaveData and where it lands, resources vs resources-dlc3, the extractor); the Repentance+ changes that broke mods and how REPENTOGON installs; the facts that bite first (entity id ranges and runtime resolution, Isaac.Spawn vs Game():Spawn, callback rates, MC_PRE_ENTITY_SPAWN semantics and crash rules, anm2 sheet paths, UI sheet sizes, MC_EXECUTE_CMD, input edge detection, log truncation); tools (Basement Renovator, the shipped editors, Mod Config Menu, ModUploader); console workflow; and a stock-launch file bridge for automated testing.

Sources: IsaacDocs, Isaac Blueprints, the REPENTOGON and Basement Renovator repos, Zamiel's isaac-faq, and the Binding of Terraria field note (#248, #264). Where a one-session observation differs from the docs (spawn-callback ordering, the console command callback on 1.9.7.17, the anm2 path rule) the text gives both and says which is which; the anm2 rule was checked against the extracted vanilla files, which name sheets relative to the anm2's own folder.

Checks: pytest (139 passed), um publish check . clean, skill copies in .claude/skills and .agents/skills synced.

🤖 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/267 **Author:** [@FraserDuncan](https://github.com/FraserDuncan) **Created:** 10/12/2026 **Status:** ✅ Merged **Merged:** 10/14/2026 **Merged by:** [@rehan-remade](https://github.com/rehan-remade) **Base:** `main` ← **Head:** `skills/isaac-playbook` --- ### 📝 Commits (4) - [`86e8df0`](https://github.com/rehan-remade/universal-modder/commit/86e8df0346c1fd2db32515a3bd93b06a9e5d42dc) skills: Binding of Isaac engine playbook (Lua mods, REPENTOGON, anm2, console, automation) - [`2ce1bab`](https://github.com/rehan-remade/universal-modder/commit/2ce1bab1bb996d2bcb6598134677f6dae727dd28) skills(isaac): verify in game and widen the sources - [`feca469`](https://github.com/rehan-remade/universal-modder/commit/feca46981156859adb69c283149e074e936c0787) skills(isaac): review fixes - [`cd39b6e`](https://github.com/rehan-remade/universal-modder/commit/cd39b6e4d4ef076fc2f529dd20069daafed12aa9) Merge remote-tracking branch 'origin/main' into land/pr-267 ### 📊 Changes **9 files changed** (+475 additions, -7 deletions) <details> <summary>View changed files</summary> 📝 `.agents/skills/mod-any-game/SKILL.md` (+4 -2) ➕ `.agents/skills/mod-any-game/references/engines/isaac.md` (+150 -0) 📝 `.claude/skills/mod-any-game/SKILL.md` (+4 -2) ➕ `.claude/skills/mod-any-game/references/engines/isaac.md` (+150 -0) 📝 `README.md` (+1 -1) 📝 `skills/mod-any-game/SKILL.md` (+4 -2) ➕ `skills/mod-any-game/references/engines/isaac.md` (+150 -0) 📝 `tests/test_um.py` (+8 -0) 📝 `um/scan.py` (+4 -0) </details> ### 📄 Description Adds `skills/mod-any-game/references/engines/isaac.md`, a single-game playbook in the style of `genie-aoe2.md` and `bannerlord.md`, and routes The Binding of Isaac: Rebirth to it from `um scan` (recon previously reported "Unknown native engine" and suggested proxy DLLs for a game with a full Lua API). What it covers: identify; the Lua route and when REPENTOGON is needed; mod anatomy (metadata.xml, alphabetical load order, `require` vs `include`, `SaveData` and where it lands, `resources` vs `resources-dlc3`, the extractor); the Repentance+ changes that broke mods and how REPENTOGON installs; the facts that bite first (entity id ranges and runtime resolution, `Isaac.Spawn` vs `Game():Spawn`, callback rates, `MC_PRE_ENTITY_SPAWN` semantics and crash rules, anm2 sheet paths, UI sheet sizes, `MC_EXECUTE_CMD`, input edge detection, log truncation); tools (Basement Renovator, the shipped editors, Mod Config Menu, ModUploader); console workflow; and a stock-launch file bridge for automated testing. Sources: IsaacDocs, Isaac Blueprints, the REPENTOGON and Basement Renovator repos, Zamiel's isaac-faq, and the Binding of Terraria field note (#248, #264). Where a one-session observation differs from the docs (spawn-callback ordering, the console command callback on 1.9.7.17, the anm2 path rule) the text gives both and says which is which; the anm2 rule was checked against the extracted vanilla files, which name sheets relative to the anm2's own folder. Checks: `pytest` (139 passed), `um publish check .` clean, skill copies in `.claude/skills` and `.agents/skills` synced. 🤖 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:59 +00:00

closed this issue
added the
pull-request
label

No labels

pull-request

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

rehan-remade/universal-modder#267

No description provided.

Rows
Columns