A Lord of the Rings total conversion mod for Mount & Blade II: Bannerlord v1.5.7.
TAOM reimagines Bannerlord as Middle-earth during the War of the Ring. More than twenty kingdoms wage war across a custom map — hundreds of unique troops, rideable war beasts (war elephants, giant spiders, wargs), race-specific lifespans, alignment-driven diplomacy, a full career/class progression system, per-kingdom special resources, and dozens of other systems. Every kingdom, clan, lord, and troop has been replaced or rewritten to fit Tolkien's world.
Development happens on
bannerlord-1.5.x(Bannerlord v1.5.7), which is also the GitHub default branch.bannerlord-1.4.5is the legacy v1.4.8 line and shows its own README.
Start any AI client with AGENTS.md and the
shared workflow. Any provider can build, review or adjudicate;
the task determines the role. For Codex, use the
operating guide and the five
repository skills under .agents/skills/. Claude imports the same shared rules.
Paid reviewers run only when explicitly requested. Review and verification work uses the non-deploying checks, not the deploying build commands in the developer quick start below.
Prerequisites
- Mount & Blade II: Bannerlord v1.5.7 installed (the Steam beta branch)
- Visual Studio 2022 (or the .NET SDK + MSBuild) — targets .NET Framework 4.7.2
BANNERLORD_GAME_DIRenvironment variable pointing at your game install (thesetup-dev-env.ps1script configures this)
Two machines. Development happens on a desktop that holds the full content set and a laptop that deliberately does not. Absolute paths in
docs/are the desktop'sE:\layout; the laptop resolves its own throughBANNERLORD_GAME_DIRandTAOM_DECOMPILE_ROOT. A machine without the completeTAOM_MapandLOTRLOME_Armoryinstalls will report thousands of broken content references that are not repo defects, so check which machine you are on before believing one. See docs/reference/development-machines.md.
Build & test
git clone -b bannerlord-1.5.x https://github.com/haterade22/TAOM
cd TAOM
.\setup-dev-env.ps1 # set BANNERLORD_GAME_DIR (asks for your install path)
.\build.ps1 # build the mod
.\build.ps1 -RunTests # build + run the test suite
dotnet test TAOM.Tests -p:DisableModuleCopy=true -p:ModuleId= # tests only, no deployA successful build deploys the module into your game's Modules/ folder. Enable TAOM in the
Bannerlord launcher and start a new campaign (existing saves are not supported).
TAOM.sln at the root contains Main (mod code), Client (TAOM.Client, the UI half), Dependencies
(TAOM.Dependencies) and TAOM.Tests. Tests run with MSTest +
NSubstitute. Shared build settings live in Directory.Build.props.
TAOM/
├── Main/ # Mod source (.NET Framework 4.7.2)
│ ├── Features/ # Feature modules (CareerSystem, SpecialResources, LotrIssues, Elephant, …)
│ ├── Core/ # Core infrastructure + IoC
│ ├── Adapters/ # Sealed-type adapters (IHeroAdapter, etc.)
│ └── _Module/ # Bannerlord module files (SubModule.xml, ModuleData, GUI)
├── Client/ # TAOM.Client: the UI a dedicated server cannot load (widgets, MapViews, MissionViews)
├── Dependencies/ # TAOM.Dependencies: Harmony, ButterLib, UIExtenderEx and MCM bundled with the mod
├── TAOM.Tests/ # Unit tests (MSTest + NSubstitute)
├── docs/
│ ├── adrs/ # Architecture Decision Records
│ ├── features/ # Feature documentation
│ └── migration/ # Bannerlord version-migration tracking
├── tools/ # Validators, generators and asset pipelines (tools/README.md)
├── .ai/ # Shared AI policy, roles, scope and review packets
├── .agents/skills/ # Codex-discoverable TAOM workflow instructions
├── .claude/ # Claude Code config (skills, agents, rules, hooks)
├── .codex/ # Codex configuration and onboarding pointer
├── CLAUDE.md # Shared AGENTS.md import + Claude-specific workflows
├── AGENTS.md # Provider-neutral AI instruction entry point
└── build.ps1 # Build script
All mod logic follows one pattern:
[HarmonyPatch / GameModel / CampaignBehavior] → IHookInterface → Service → IAdapter
Services never touch TaleWorlds sealed types directly — they work through adapter interfaces, which keeps business logic fully unit-testable.
The rules are in AGENTS.md: test first, thin entry points, adapters for sealed types, no #region, [Obsolete] or #if outside IoC.cs, and research before guessing.
See the Architecture Decision Records for the full set of design constraints.
| Free Peoples | Dark Powers | Independent |
|---|---|---|
| Gondor · Rohan · Erebor · Dale · Rivendell · Lothlórien · Mirkwood · Lindon · Arthedain · Ered Luin | Mordor · Isengard · Dol Guldur · Gundabad · Misty Mountain Orcs · Goblin-town · Blue Craig · Dunland · Easterlings (Rhûn) · Harad · Khand | Umbar (corsairs) · Shaghâna · Âbanissa · Cardolan · Rhudaur · Anduin Vale · Angáladh · Dorwinion · South Rhovanion |
Over 100 clans and 800+ unique troop definitions across all factions. Settlements like Erebor are hand-kitbashed in the editor — see the build reference.
- Career System — culture-specific careers; pick one at character creation, progress a tiered choice tree, unlock passive bonuses + an active battlefield ability (press V).
- Legendary War Beasts — ride wargs, Harad war elephants (trample + tusk auto-attacks), and Dol Guldur giant spiders (auto-bite); each driven by behavior-tree AI and fielded as cavalry.
- Special Resources — 11 per-kingdom resources (War Spoils, Gems, Elven Wine, …) that gate elite troop upgrades; XML-driven with many-to-one kingdom/culture mappings.
- Cultural Feats — lore-driven per-culture bonuses (Rohan cavalry speed, Erebor smithing, Mordor raid damage, Gondor loyalty, …), each backed by a dedicated GameModel override.
- Culture Conversion — conquered towns, castles, and their villages gradually adopt the conqueror's culture, switching recruitment pools to match.
- Smart Battle AI — coordinated cavalry line-charges, companion-led formation tactics, and mixed formations that interleave unit types instead of segregating them.
- War of the Ring — scripted phased escalation into permanent total war between Free Peoples and Dark Powers; configurable via JSON + MCM.
- Race & Age System — race-appropriate lifespans and fertility (immortal elves, 250-year dwarves, fast-breeding orcs, ageless Nazgûl).
- Named Companions: 17 lore companions (Aragorn, Legolas, Gimli, …) as recruitable wanderers.
- Bandit Management — five LOTR bandit cultures replace vanilla hideouts, with configurable density and themed encounter flavor.
- Localization — full text support across 12 languages with graceful English fallback.
…and dozens more systems (castle recruitment, culture marketplace, troop-weight balancing,
messengers, quick-action inventory, banner color persistence, settlement guards, custom battles,
siege defense, tournament armor, and more). Each is documented under
docs/features/. LOTR rules are enforced through GameModel overrides and
Harmony patches, both catalogued in harmony-patch-registry.md and gamemodel-registry.md.
TAOM is developed with a structured, AI-assisted engineering pipeline.
- Claude Code is integrated as more than a code generator: custom slash-command skills, specialized agents, automated hooks, path-scoped rule files, persistent cross-session memory, and project MCP servers (decompilation, ModuleData queries, image and voice generation). AGENTS.md, with Claude's CLAUDE.md layer, is the authoritative reference every session loads.
- Codex (OpenAI) runs as an independent adversarial reviewer — it shares no session context with Claude, so it provides a genuine second opinion. Review instructions live in AGENTS.md.
- Completion workflow: build and tests, then an internal
/deep-review, then closeout (issue, feature doc, commit body as the changelog entry). The maintainer can add a Codex review, which is paid and runs only on his word.
TAOM ships as four modules, all at the same version: TAOM, TAOM.Dependencies, TAOM_Map and
LOTRLOME_Armory. TAOM.Dependencies carries Harmony, ButterLib, UIExtenderEx and Mod
Configuration Menu (MCM) inside it, so none of those is installed separately: a standalone Workshop
or Nexus copy of any of them must be removed before TAOM is enabled.
Bannerlord v1.5.7 is required (the Steam beta branch). Place the four modules
in your Bannerlord Modules/ directory, enable them in the launcher, and start a new campaign:
existing saves are not supported.
Pull requests go to bannerlord-1.5.x, or bannerlord-1.4.5 for 1.4.8 bug fixes. CONTRIBUTING.md covers the route, what a
PR needs and the checks every PR goes through.
Read AGENTS.md for the coding rules.
TAOM is licensed in parts. LICENSE-CONTENT.md is the overview and carries the path-by-path scope; LICENSE is kept as plain MIT text so license detection keeps working.
| What | License |
|---|---|
| Code (C# source, tests, tooling, build scripts, Gauntlet UI definitions) | MIT |
| Content (art, 3D and 2D assets, the world map, game data, lore text) | CC BY-NC-SA 4.0: non-commercial, attribution required, share-alike |
| Audio, fonts, and third-party binaries | Not TAOM's to license. See THIRD-PARTY-LICENSES.txt |
| The TAOM name, "Tales From the Age of Men", and the branding | Granted by neither license. See TRADEMARK.md |
Forks are welcome and the code is genuinely free to use. Two things it does not come with: the audio and fonts (which are not ours to pass on) and the project's name (which no open license grants). "A fork of TAOM" is fine and always will be. Calling your fork TAOM is not.
Provenance record for the content: docs/reference/asset-provenance.md.
This mod is a fan project and is not affiliated with or endorsed by the Tolkien Estate, New Line Cinema, Middle-earth Enterprises, or TaleWorlds Entertainment.
