Menu
Use before patching, overriding, or adapting a TaleWorlds type — `taom-src path <Type>` decompiles + caches the installed engine, returning an absolute path.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
Root-cause native Bannerlord CTDs (AccessViolation in TaleWorlds.Native.dll) via Event Log offsets, offline disassembly, and live debugger forensics. No symbols needed.
Dispatch an independent Codex verification job directly via `codex exec` Bash call, then retrieve and present results
Inspect all changed files, group by logical concern, and guide atomic per-concern commits following TAOM's 50/72 rule and commit trailer convention.
Load a snapshot saved by /context-save and present it so this session can pick up where the last one left off without re-deriving decisions.
Launch parallel deep-dive agents to review completed work for quality, standards, compatibility, completeness, and cross-system data flow
Respond to a Bannerlord engine update (Steam force-bump or deliberate migration) — preserve the decompile baseline, regen, diff, re-verify bindings and creature data, control-battle.
| name | taom-src |
| description | Use before patching, overriding, or adapting a TaleWorlds type — `taom-src path <Type>` decompiles + caches the installed engine, returning an absolute path. |
Wraps ilspycmd against the installed DLLs (auto-detects the engine version from Version.xml — currently v1.4.7) and caches at ~/.taom-src/<version>/. Inspired by vercel-labs/opensrc. Use this before every [HarmonyPatch], GameModel override, or adapter that touches a TaleWorlds type — never guess signatures from the E:\Decompiled_Bannerlord\ dump (it can lag the installed engine after a bump).
# Decompile + cache (first call) or print cached path (subsequent calls)
pwsh tools/taom-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel
# Compose with grep/cat/rg — exactly like opensrc
rg "GetCharacterWage" $(pwsh tools/taom-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel)
cat $(pwsh tools/taom-src.ps1 path TaleWorlds.MountAndBlade.Formation)
Progress goes to stderr, path goes to stdout — safe in $(...).
| Command | Behavior |
|---|---|
path <Type> | Print absolute path to cached .cs. Decompiles on miss. |
path <Type> -Dll <Name> | Skip namespace heuristic; force a specific DLL. |
list | Show all cached types as a table. --json for raw output. |
remove <Type> | Delete one cache entry. |
clean | Nuke the entire cache. |
~/.taom-src/dll-index.json remembers type → dll from prior lookups. Instant hit.TaleWorlds.CampaignSystem.X.Y probes TaleWorlds.CampaignSystem.X.dll, then TaleWorlds.CampaignSystem.dll, then TaleWorlds.dll. Catches ~99% of cases on the first probe.*.dll in bin/Win64_Shipping_Client alphabetically. ~30 probes max.| Situation | Action |
|---|---|
About to write [HarmonyPatch(typeof(X), nameof(X.Y))] | taom-src path X first — verify Y exists with the expected signature |
About to override GetCharacterWage on DefaultPartyWageModel | taom-src path DefaultPartyWageModel — copy the exact base signature |
| About to call a TaleWorlds API from an adapter | taom-src path <Type> — confirm the method exists in the installed engine with the expected signature |
| Bug investigation: "vanilla does X, what does its code actually look like?" | taom-src path <ClassName> then rg for the symptom |
| Want to know what's already cached | taom-src list |
| Situation | Use instead |
|---|---|
| Looking for a class but don't know the FQN | grep -r "ClassName" E:/Decompiled_Bannerlord/ to find namespace, then taom-src path to verify against the installed engine |
| Need to browse a whole namespace tree | ls E:/Decompiled_Bannerlord/<area>/ (the dump is fine for browsing patterns) |
| Need full type list of a DLL | mcp__ilspy__list_types (the ILSpy MCP is purpose-built for this) |
The recurring failure mode (caught by Codex review 2026-05-06, see feedback_codex_caught_api_misread.md in memory): two agents disagreed on a TaleWorlds API; the more confident one was wrong because it inferred from the decompile folder rather than the installed DLLs. A single primitive that always lands on the installed engine version — and caches so the cost is paid once per type — removes the temptation to skip verification.
$env:BANNERLORD_GAME_DIR set to the Bannerlord install root (e.g. E:\Steam\steamapps\common\Mount & Blade II Bannerlord).ilspycmd on PATH (dotnet tool install -g ilspycmd).Both are reported with actionable error messages if missing (per .claude/rules/environment-failures.md).
.claude/skills/research/SKILL.md — broader "decompile and analyze before implementing" workflow. Use that for full analysis sessions; use taom-src for one-shot signature lookups.CLAUDE.md "TaleWorlds Research — Lookup Order" — high-level routing.