OKANO SOFTWORKS

Field Manual

KingsBlade

In active development

Fight your Crusader Kings III battles, sieges, duels and tournaments in Bannerlord, with the real armies — and carry the result back into your campaign.

The battle intro over an army drawn up in a wooded valley — “Battle of Surrey”, 27th of August, 1067 AD, Kingston, Surrey
The Battle of Surrey, named as CK3 names it, before the first blow.

KingsBlade reads the fight CK3 is about to resolve — both sides, every army and regiment, the commanders and champions by name — stages it in Bannerlord with the troops and heraldry those realms actually field, and writes the outcome back. The knight who falls in front of you is the knight CK3 buries.

There is no CK3 mod. KingsBlade works with the running game and never changes CK3's files, so your achievements and Ironman are untouched. Only Bannerlord carries a module.

Every fightbattles, sieges, duels, tournaments and adventure encounters
6 agesof arms and armour, 867 to 1380
6,000soldiers on the field at once
410recordings for the commanders' speeches

Setting it up

  1. Install the app. Run the installer; it checks for the .NET 8 Desktop Runtime and points you at it if it is missing.
  2. Add the module. Put it in Bannerlord's Modules folder, so that Modules\KingsBlade holds it, and tick KingsBlade in the launcher after Harmony and CustomBattle.
  3. Run through the Prologue. The app is a book, and it opens on its Prologue until you are ready. It finds both games and the module, sends you to the Workshop mods it uses (Harmony, and optionally Dismemberment Plus and RTS Camera), checks Bannerlord's load order, builds your realms' banners and the royal weapons, and lists the six ages of equipment. Then it turns into HOME. OPTIONS → Open setup prologue brings it back.
  4. ShōgunsBlade, if you want Japan. Subscribe to Shokuho on the Steam Workshop, open ShōgunsBlade's book and press Build ShōgunsBlade from Shokuho on its Prologue, with Bannerlord closed — about two minutes. See ShōgunsBlade.

Playing a battle

  1. Open KingsBlade. Its book opens and it starts watching both games.
  2. Start CK3 and load your campaign — the app's button opens the Paradox launcher.
  3. Start Bannerlord from the app too, with KingsBlade ticked. Either order works.
  4. Open a battle with an army you own or command. The crossed swords follow CK3's battle panel.
  5. Press them. CK3 is held while the battle is read and staged, and you are on the deployment screen.
  6. Fight it out, through to the result screen. Back in CK3 the result is written and the game let go; carry on and CK3 ends the battle by its own rules.

When the button appears

A field battleon CK3's battle panel, for a battle with an army you own or command, once the fighting has begun
A siege you layon the siege window, when an army of yours is besieging the holding — even if an ally leads it
A siege of your holdingon the siege window, at any point in the siege. You fight it from the walls
A duelon CK3's duel window, on your first move, when you are one of the two fighters
A tournament bouton the tournament screen, when your bout in the duel contest reaches “Duel: Riposte”

The button follows CK3's screens as they open and shut. Grey means not yet, or not this one — a battle still pending, a duel that must stay in CK3 — and HOME and LOG say why. Ctrl + Alt + arrow keys move it; each kind keeps its own place.

What each fight brings

Field battleSiege assaultYour own wallsDuelTournament bout
The grounda field of the province's region and terraina castle of the holder's culture, at its fort levelthe same castle, from the wallsthe terrain of one fighter's capitalan arena of the county's culture
Intro and speechbothbothbothits own introits own intro
Champions' fatesboth sides', by your slidersboth sides', by your slidersboth sides', by your slidersCK3's own rule for the duelCK3's own roll for the wounds
Written backevery regiment's losses, every champion's fate, the war scoreboth sides' losses and fates, prisoners from the keep — win, and the holding falls the next daythe same, with your stationed regiment's losseswho wonwho lost

On the field

Sieges and the keep

Through the gate — Emperor Benoît ‘the Great’ of the Holy Roman Empire falls back to the keep
Through the gate: the Emperor falls back to his keep.

Duels and tournaments

Duels. Fight CK3's single combats as your character, with both men's real prowess, equipment and wounds — stripped to the waist when CK3 strips them. Whoever goes down loses. Back in CK3 pick any move: the round goes to the Bannerlord winner, and CK3 applies the duel's own story and cost. Rigged duels and children's duels stay in CK3.

Tournaments. Your bouts in a tournament's duel contest, fought in an arena of the county's culture, the host's standards round the ring and the stands full and cheering. Real weapons or sparring kit, always to a knockout. Your result moves CK3's bracket on.

Large battles

Bannerlord holds 2,040 men and horses at once. Experimental engine capacity raises that to as many as 12,240, so up to 6,000 soldiers stand on the field at once and 3,000 at a siege. It is our own patch for Bannerlord 1.4.8, put into the game as KingsBlade starts it — the files on disk are never changed — and the soldier sliders never ask for more than the running engine reports.

How we can afford it. Memory is not the limit: a slot costs about 9 KB, so even 12,240 is around 100 MB. The limit is one CPU core — Bannerlord works through every soldier's AI on a single thread — so everything else here is about taking work off that core.

The frame rate is your CPU's: an 8,000-soldier test battle ran its full two minutes at about 32 FPS at 4K on an i9-13900KS and RTX 4090.

A vast battle at the edge of a wood, the lines crowded with the banners of several realms and their vassals
A great battle, every realm and vassal under its own banner.

What is written back

Losses on both sides, levies included, scaled back from the field to CK3's own regiments: killed men are hard casualties, the wounded and routed come home. Every champion's fate is decided at the moment of the blow and goes through CK3's own death, wound and maiming rules. The battle counts in its war, war score and contribution included, as one of CK3's own does. KingsBlade does not pick the winner — CK3 runs its own ending, pursuit and retreat.

Your saves are backed up before every write, whatever your settings. If anything about the campaign has changed underneath the fight, the result is refused and CK3 resolves the battle itself. A duel or a bout only sends back who won.

Every setting

The app's BATTLE SETTINGS and OPTIONS chapters, and Bannerlord's own KingsBlade menu. Settings save as you change them, and a fight keeps the ones it was staged with.

How big a battle is
Total army size25–200%, 100%. Scales the whole roster — lower for shorter fights
Most men one side may bring500–10,000, 3,500. Each side's ceiling before CK3's odds divide the field
Soldiers on the field at once200–2,000, up to 6,000 with engine capacity; 1,000. The opening wave — the rest reinforce
Soldiers at a siege at oncethe same for a siege, up to 3,000; 1,000
Levies in one group at deployment800 (600 at a siege). A bigger levy fights as even groups
Men-at-arms on the field1–6×, 1×. Above 1×, your heavy foot and pikemen are favoured over the rest
Experimental and large battle performance
Experimental engine capacity (restart Bannerlord)off. Lets Bannerlord hold more men and horses
Engine slots for next Bannerlord start — men and horses2,040–12,240; a rider and his horse count two
Experimental CPU relief (restart Bannerlord)off. Takes idle work off the CPU in KingsBlade battles
Lighter plants and shorter-lived blood marks (restart Bannerlord)shorter draw distances for grass and trees, blood marks two minutes at most
Use lighter graphics in large battleslighter graphics from 2,000 soldiers; yours come back after
Clear loose horses away from youriderless horses fade after 30 s, never near you
Reduce distant soldier detailsoldiers far from the camera drawn in less detail
Far-away animation detailsmoother, balanced, lighter on CPU or lightest on CPU
Settle distant fallen bodies soonerfar-off bodies stop their physics sooner
Bodies on the fieldyour Bannerlord setting, clear after reinforcements arrive, or keep throughout the battle
Record battle frame rate and timingslogs every frame-rate dip and what it was spent on

The performance choices show, and act, only while engine capacity is ticked.

Battle AI, commanders and troops
Battle and siege AIKingsBlade AI (default), Bannerlord AI or RBM AI. The armies, banners and result are the same in all three
Damage you receive0%, 50% or 75% reduction — Bannerlord's own player setting
What a commander's martial is worth1–4×, 2×. Tactics = Martial × this
An army CK3 gave no commandernobody in charge — they charge (default), or a basic battle plan
How good your troops areoff, as the pack says, or by era (default) — a level step for each age
How well armed the levies areas CK3 says — peasants (default), follow RBM, by era, or always. Both sides get it
Commander speeches and intros
Speech after deploymentvoice and subtitles, subtitles only, or off
Speech morale impact · Speech health impact0–200%, 100%. 0% switches that effect off
Minimum Martial for a positive speech0–100, 15
Enable Battle Introson. The intro before a battle, a siege, a duel or a bout
Bannerlord Music on Introson. Your culture's battle theme through the intro and deployment
KingsBanners, KingsGuard and KingsArms
A bannerman in every regimenton. One of its own men in every 200 carries its banner; his group takes 10–20% less of a morale hit
Kingdom bannerson. A kingdom's standard flies with its knights or guard; the whole realm takes 30% less of a morale hit
Vassal realm levy bannerson. Levies fly the arms of the vassals who raised them
Kings & Emperors field a Royal Guardon. 5 to 50 picked men by court grandeur; riding from level 6. Needs Royal Court
Your Royal Guard follows you as your bodyguardoff. On, it forms up round you at Ready and charges if you fall
Use royal weapons when readyon. Kings and emperors on both sides carry their culture's royal weapons
Court grandeur · Prowess for royal weaponsgrandeur 9–10 or prowess 40–50 by default; either is enough
Deaths, wounds, prisoners and confirmations
Die · wound · maiming chances5%, 20%, 10% for a champion who goes down — one set for your people, one for the enemy
Your champions and commanders can dieon. Off, nothing happens to them, either side
You can dieoff
You only die once wounded (CK3 Rules)on
Prowess makes a champion harder to killoff
Decapitation = Deathoff. With Dismemberment Plus, a lost head is a death
Siege Keep % chance to take/taken champions prisoner100%. For a keep fight lost, either side
Bouts are fought with real weaponson. Off, blunt sparring kit
Show what CK3 gave me, before the battleoff. Shows what was read, before anything is staged
Show what I will write back, after the battleoff. Shows the write and waits for your yes
Options
Start KingsBlade with Windows · Start minimisedoff
Music when KingsBlade opens · Open KingsBlade Book on starton
Keep the button on screenoff. Useful for placing it
Load the custom battle while Bannerlord is parkedon. The first fight's loading done ahead of time
Enable ShōgunsBladeloads ShōgunsBlade when KingsBlade starts Bannerlord
Enable Realistic Battle Soundson. Carióceco's sounds, part of KingsBlade's module
Debug log · Intro camera debugoff. For reporting a problem
Bannerlord's KingsBlade menu
Enable cut-through · Player cut-through · AI cut-throughon, on, off. A cutting swing can carry on into the next man
Player friendly fire (melee) · AI friendly fire (melee)off
Weapons and swing directionswhich weapons and swings can cut through
Minimum inflicted damage · Maximum armour absorption · Momentum kept per target10, 80%, 70%
Missile hits heard only nearby · Insults shouted in battleon — Realistic Battle Sounds
Heads come off · AI takes heads · Critical blows onlyon — KingsBlade's head cuts
Head chance · Slow motion, your cuts100%, 100%

Adventure Encounters

CK3's adventurer contracts, fought in Bannerlord — criminal duels, raids, ambushes, escorts and prison breaks. All 65 contracts are mapped to the fights they become, built on KingsBlade's duels.

ShōgunsBlade

Japan, as KingsBlade fights it — Japan's own troops through every age from 867 to 1380, its battlefields, castles, duel grounds and arenas, built on your PC from Shokuho. It is part of KingsBlade. Read about ShōgunsBlade.

Requirements

Crusader Kings III1.20.1 & 1.20.1.2 “Crozier”. KingsBlade checks the game and refuses a build it does not know
Mount & Blade II: Bannerlordv1.4.8, with Native, SandBoxCore and CustomBattle, and Bannerlord.Harmony v2.4.2
.NET 8 Desktop Runtime (x64)the installer checks for it
Royal CourtCK3 DLC, optional — the KingsGuard
Realistic Battle Modoptional, tested with v4.4.6
Dismemberment Plusoptional, tested with v2.0.8.8 — head cuts; load it before KingsBlade
XIIIc Armory · Ben's Ultimate Armoryoptional — the arms and armour of 1259 and of 1380
ShōgunsBladeShokuho — Bannerlord Mod
All Under Heaven — CK3 DLC

If something goes wrong

HOME and LOG say in plain words what KingsBlade is waiting for and why a button is grey. Un-freeze CK3 releases a held game, Fight again restages a live battle, and Clear cache lets KingsBlade find everything afresh. To report a problem, tick Debug log in OPTIONS, fight it again, and send the logs.