Bannerlord Twitch Viewer Guide

Bannerlord Twitch (BLT) is a Twitch Integration mod for Mount & Blade II: Bannerlord.

As a viewer you can use channel point rewards (if available), and chat commands to interact with the game while the streamer is playing.

The primary feature of BLT is allowing you to 'adopt' a hero in the game. Your hero can either be a random hero already inside the game world, or a newly created one. Your hero equipment can be upgraded, or replaced with custom items or tournament reward items; however you will always equip the best item you have available in each actual slot.

Some examples of things you can do with your hero include 'summoning' your hero into battles that the streamer is taking part in, joining viewer tournaments, selecting your heroes 'class', unlocking special class powers, or creating new viewer clans. Everything saves with the game, so you can join for entire campaigns, while your heroes level whenever the campaign is being played.

If you aren't sure where to start, start with !help and !adopt

Table of Contents

Commands

Channel Point Rewards

Classes

Infantry

Zweihander

Archer

Horseman

Horse Archer

Common Config

General

Battle

Death

XP

Kill Rewards

Battle End Rewards

Kill Streaks

Achievements

Commands

Command Description Settings
ach Show the heroes achievements and tracked stats.

Shows: Achievements, Tracked stats
bltbet Use this to bet on tournament matches, when available.
Usage is !bltbet (team) (gold), for example !bltbet red 10000 to bet 10000 gold on red. Winnings are divided up from the whole pot, based on relative bet size.
If only one team is bet upon, the bets will be refunded.
buymount Buy a randomly tiered mount for your Hero.
class Selects a new class for your hero, updating your existing equipment to match the class requirements.
Usage is !class (new class name), e.g. !class archer.

Tier costs: 1=5000⦷, 2=10000⦷, 3=20000⦷, 4=40000⦷, 5=80000⦷, 5=80000⦷, 6=160000⦷

Free if you do not already have a class

Updates equipment to match new class
customitems Shows the viewers custom item list, which is required so they know what item index to use in the custom item related commands.

Shows: Custom item storage
discarditem Throw away one of your custom items.
Usage is !discarditem (custom item index), e.g. !discarditem 3 would discard your custom item with the index 3. The custom item index is shown in the 'customs' command.
equip Upgrades your heroes equipment tier, replacing any existing equipment of lower tier, except for custom items. The cost depends on the tier you are trying to upgrade to.
Usage is !equip (blank for auto upgrade/tier number)
Example: !equip 1 or !equip

Tier costs: 1=25000⦷, 2=50000⦷, 3=100000⦷, 4=200000⦷, 5=400000⦷, 6=1000000⦷
gold Show your heroes current gold.

Shows: Gold
hero Use to adjust hero physical features
Usage is !hero (gender) (male/female)
Example: !hero gender male

Enabled Commands: Change Hero Gender

Gender Change Config: Price=50000⦷, Only on created heroes?=True
inv Shows your heroes equipped loadout and inventory, excluding custom items (do !customItems instead)

Shows: Gold, Equipment tier, Battle equipment inventory
nameitem You can use this to name your custom items.
Usage is !nameitem (custom item index) (name), for example !nameitem 3 Foehammer. The custom item index is shown in the 'customitems' command.
powers Shows your available powers

Shows: Powers
reequip Randomizes your equipment, at its current tier. It will not replace items that are higher than your current tier, or custom items. e.g. if you are equipment tier 3, but also have a tier 6 weapon won in a tournament, this command will not replace that weapon. Sometimes you will end up with some items not changing, particularly if there aren't many items of that type available at your current tier.

Re-rolls your equipment at your current tier

Tier costs: 1=10000⦷, 2=25000⦷, 3=50000⦷, 4=100000⦷, 5=200000⦷, 6=400000⦷
retinue Purchases new retinue troops, or upgrades existing ones to the next tier if you have reached the limit. Retinue will appear with you in battle when you summon, earning you money when they make kills.
Usage is !retinue (blank or all for auto upgrade/upgrade amount)
Example: !retinue 1 or !retinue all

Max retinue: 5

Tier costs: 1=25000⦷, 2=50000⦷, 3=100000⦷, 4=200000⦷, 5=400000⦷, 5=400000⦷, 6=800000⦷

Allowed: Same culture only, Basic troops, Elite troops
retinuelist Shows your current retinue troops.

Shows: Retinue unit list
smitharmor Smith a custom armor item
smithweapon Smith a custom weapon
stats Shows your heroes general information, including clan, gold, location, HP, skills, attributes and retinue.

Shows: Gold, Age, Clan, Culture, Health, Skills greater than , Attributes, Retinue count and average tier

Channel Point Rewards

Command Description Settings
Adopt a Random Hero Adopt a randomly selected Hero. Almost all other actions require an adopted hero.

Newly created wanderer

Starting Gold: 0

Starting Equipment Tier: 1

Starting Skills:

Skill Level
Melee 25 to 50
Ranged 25 to 50
Athletics 25 to 50
Riding 25 to 50
Daily Gold Adds 1,000 gold to your adopted hero.

Amount: 1000⦷
Daily XP Add 10,000 XP to your adopted hero. The skill it is applied to will be randomly choosen, but influenced by your class and existing skills and equipment.

Skills: Automatic, based on class, equipment, and existing skills

XP: 10000
Send Message In Game Sends a message in the game. If you have a hero then it will also show them next to the message.
Summon Use this when the streamer enters a battle, to spawn your adopted hero on the streamers side (along with your retinue).

Side: Streamers side

Allowed in: Field battle, Village battle, Siege battle, Friendly mission, Hide-out
Tournament Join the tournament queue with your adopted hero. You can see the queue in the overlay. Each tournament can have up to 16 heroes in it, once it is full further heroes will remain in the queue for the next tournament.
Use Class Power Activate your class power on your hero, if you have one. The power will last for a limited period of time, indicated on the overlay.

Classes

Infantry

Basic Soldier wielding sword and shield with throwing javelins

Tier 1 Tier 2 Tier 3 Tier 4 Tier 5 Tier 6
Infantry Tier 1 Example Infantry Tier 2 Example Infantry Tier 3 Example Infantry Tier 4 Example Infantry Tier 5 Example Infantry Tier 6 Example
Formation Infantry
Equipment

OneHandedSword

Iron Scimitar

Shield

Small Flat Heater Shield

ThrowingJavelins

Hooked Javelin
Passive Power

Trained

Healthy I: 125% HP

Athletic I: Athletics: +25

Healthy II: 150% HP

Athletic II: Athletics: +50

Healthy III: 200% HP

Athletic III: Athletics: +100

Shrug Off I: 15% Shrug Off
Active Power

Shield Bash

[Retribution I: Reflect 10% damage] requires CLASS LEVEL 3

Zweihander

Basic Soldier wielding two-handed sword with throwing javelins

Tier 1 Tier 2 Tier 3 Tier 4 Tier 5 Tier 6
Zweihander Tier 1 Example Zweihander Tier 2 Example Zweihander Tier 3 Example Zweihander Tier 4 Example Zweihander Tier 5 Example Zweihander Tier 6 Example
Formation Infantry
Equipment

TwoHandedSword

Wide Fullered Broad Two Hander

ThrowingJavelins

Hooked Javelin
Passive Power

Trained

Healthy I: 125% HP

Athletic I: Athletics: +25

Healthy II: 150% HP

Athletic II: Athletics: +50

Healthy III: 200% HP

Athletic III: Athletics: +100

Shrug Off I: 15% Shrug Off
Active Power

Blood Rage

[Vampiric I: Absorb 10% of damage dealt as HP] requires CLASS LEVEL 3

Archer

Basic Soldier wielding Bow with dagger for close quarters

Tier 1 Tier 2 Tier 3 Tier 4 Tier 5 Tier 6
Archer Tier 1 Example Archer Tier 2 Example Archer Tier 3 Example Archer Tier 4 Example Archer Tier 5 Example Archer Tier 6 Example
Formation Ranged
Equipment

Bow

Hunting Bow

Dagger

Xiphos

Arrows

Arrows

Arrows

Arrows
Passive Power

Trained

Healthy I: 125% HP

Ranger I: AI Shoot Frequency: 200% AI Wait Before Shoot Factor: 50% Ranged: 125%

Healthy II: 150% HP

Ranger II: AI Shoot Frequency: 200% AI Wait Before Shoot Factor: 50% Ranged: 150%

Healthy III: 200% HP

Ranger III: AI Shoot Frequency: 200% AI Wait Before Shoot Factor: 50% Ranged: 200%

Heavy Projectiles I: Add: 10% Knock Down, 10% Mount Rear, 10% Dismount / 25% Unblockable / 25% Cut Through from Ranged
Active Power

Blasting Arrow

[Explosive Projectiles I: AoE: 50dmg in 4m from Ranged] requires CLASS LEVEL 3

Horseman

Basic Horse Soldier wielding two-handed lance and sword

Tier 1 Tier 2 Tier 3 Tier 4 Tier 5 Tier 6
Horseman Tier 1 Example Horseman Tier 2 Example Horseman Tier 3 Example Horseman Tier 4 Example Horseman Tier 5 Example Horseman Tier 6 Example
Formation Cavalry
Equipment

TwoHandedLance

Courser Lance

OneHandedSword

Iron Scimitar
Mount

Horse

Valanby Courser
Passive Power

Trained

Healthy I: 125% HP

Better Mount I: Mount Speed: 110% Top Speed Reach Duration: 90% Armor Torso: +20 (on mount)

Healthy II: 150% HP

Better Mount II: Mount Speed: 125% Top Speed Reach Duration: 75% Armor Torso: +40 (on mount)

Healthy III: 200% HP

Better Mount III: Mount Speed: 150% Top Speed Reach Duration: 50% Armor Torso: +80 (on mount)

Charge I: Mount Charge Damage: 150% Mount Maneuver: 125% (on mount)
Active Power

Trample

[Charge AoE I: AoE: 25dmg in 2m from Charge] requires CLASS LEVEL 3

Horse Archer

Mounted ranged unit, with a good horse, that can use exposive arrows.

Tier 1 Tier 2 Tier 3 Tier 4 Tier 5 Tier 6
Horse Archer Tier 1 Example Horse Archer Tier 2 Example Horse Archer Tier 3 Example Horse Archer Tier 4 Example Horse Archer Tier 5 Example Horse Archer Tier 6 Example
Formation Horse Archer
Equipment

Bow

Hunting Bow

Arrows

Arrows

Arrows

Arrows

OneHandedSword

Iron Scimitar
Mount

Horse

Valanby Courser
Passive Power

Mounted Archery

Healthy I: 125% HP

Better Mount I: Mount Speed: 110% Top Speed Reach Duration: 90% Armor Torso: +20 (on mount)

Healthy II: 150% HP

Better Mount II: Mount Speed: 125% Top Speed Reach Duration: 75% Armor Torso: +40 (on mount)

Healthy III: 200% HP

Better Mount III: Mount Speed: 150% Top Speed Reach Duration: 50% Armor Torso: +80 (on mount)

Ranger I: AI Shoot Frequency: 200% AI Wait Before Shoot Factor: 50% Ranged: 125%

Active Power

Heavy Arrows

[Heavy Hitting I: 125.0% dmg] requires CLASS LEVEL 3

Common Config

General

Sub Boost

1.75

 Multiplier applied to all rewards for subscribers (less or equal to 1 means no boost). NOTE: This is only partially implemented, it works for bot commands only currently.

Battle

Start With Full Health

Enabled

 Whether the hero will always start with full health
Start Health Multiplier

2

 Amount to multiply normal starting health by, to give heroes better staying power vs others
Start Retinue Health Multiplier

2

 Amount to multiply normal retinue starting health by, to give retinue better staying power vs others
Morale Loss Factor (not implemented)

0.5

 Reduces morale loss when summoned heroes die
Summon Cooldown In Seconds

60

 Minimum time between summons for a specific hero
Summon Cooldown Use Multiplier

1.5

 How much to multiply the cooldown by each time summon is used. e.g. if Summon Cooldown is 20 seconds, and UseMultiplier is 1.1 (the default), then the first summon has a cooldown of 20 seconds, and the next 24 seconds, the 10th 52 seconds, and the 20th 135 seconds. See https://www.desmos.com/calculator/muej1o5eg5 for a visualization of this.
Retinue Use Heroes Formation

Disabled

 Whether an adopted heroes retinue should spawn in the same formation as the hero (otherwise they will go into default formations)

Death

Allow Death

Enabled

 Whether an adopted hero is allowed to die
Final Death Chance Percent

0.5

 Final death chance percent (includes vanilla chance)
Apply Death Chance To All Heroes

Enabled

 Whether to apply the Death Chance changes to all heroes, not just adopted ones
Retinue Death Chance Percent

2.5

 Retinue death chance percent (this determines the chance that a killing blow will actually kill the retinue, removing them from the adopted hero's retinue list)

XP

Use Raw XP

Enabled

 Use raw XP values instead of adjusting by focus and attributes, also ignoring skill cap. This avoids characters getting stuck when focus and attributes are not well distributed.
Raw XP Skill Cap

330

 Skill cap when using Raw XP. Skills will not go above this value. 330 is the vanilla XP skill cap.

Kill Rewards

Gold Per Kill

500

 Gold the hero gets for every kill
XP Per Kill

500

 XP the hero gets for every kill
XP Per Killed

200

 XP the hero gets for being killed
Heal Per Kill

20

 HP the hero gets for every kill
Retinue Gold Per Kill

250

 Gold the hero gets for every kill their retinue gets
Retinue Heal Per Kill

50

 HP the hero's retinue gets for every kill
Relative Level Scaling

0.5

 How much to scale the kill rewards by, based on relative level of the two characters. If this is 0 (or not set) then the rewards are always as specified, if this is higher than 0 then the rewards increase if the killed unit is higher level than the hero, and decrease if it is lower. At a value of 0.5 (recommended) at level difference of 10 would give about 2.5 times the normal rewards for gold, xp and health.
Level Scaling Cap

5

 Caps the maximum multiplier for the level difference, defaults to 5 if not specified

Battle End Rewards

Win Gold

10000

 Gold won if the heroes side wins
Win XP

10000

 XP the hero gets if the heroes side wins
Lose Gold

5000

 Gold lost if the heroes side loses
Lose XP

5000

 XP the hero gets if the heroes side loses
Difficulty Scaling On Players Side

Enabled

 Apply difficulty scaling to players side
Difficulty Scaling On Enemy Side

Enabled

 Apply difficulty scaling to enemy side
Difficulty Scaling

1

 End reward difficulty scaling: determines the extent to which higher difficulty battles increase the above rewards (0 to 1)
Difficulty Scaling Min

0.2

 Min difficulty scaling multiplier
Difficulty Scaling Max

3

 Max difficulty scaling multiplier

Kill Streaks

Name Kills Required Reward
Killing Spree 5

5000⦷

Achievements

Name Requirements Reward
Loyal

Consecutive Summons >= 50

250000⦷

50000XP

Item: Weapon: 100% Custom: 100% {=IvV04W31}{ITEMNAME} of Fealty (1x)
Rebellious

Consecutive Attacks >= 5

20000⦷

Item: Armor: 100% Tier 2: 33%, Tier 3: 33%, Tier 4: 33%
Reliable

Consecutive Summons >= 5

20000⦷

Item: Armor: 100% Tier 2: 33%, Tier 3: 33%, Tier 4: 33%
Renegade

Consecutive Attacks >= 50

250000⦷

50000XP

Item: Weapon: 100% Custom: 100% {=UQtSgnog}Renegades {ITEMNAME} (1x)
Stream Sniper

Total Streamer Kills >= 5
Traitorous

Consecutive Attacks >= 20

50000⦷

Item: Armor: 100% Tier 4: 33%, Tier 5: 33%, Tier 6: 33%
Trusted

Consecutive Summons >= 20

50000⦷

Item: Armor: 100% Tier 4: 33%, Tier 5: 33%, Tier 6: 33%