This guide covers how to set up your Mount & Blade II: Bannerlord dedicated server on Legion Hosting, configure startup variables, set up game modes and map rotations, configure factions, and connect to your server. Bannerlord offers competitive and team-based medieval combat across multiple game modes including Siege, Captain, Skirmish, Team Deathmatch, Duel, and Battle. For admin controls, modding, player management, and troubleshooting, see Mount and Blade II Bannerlord Admin Setup.
1. First Start
- Log in to GPanel and select your Bannerlord server.
- Go to the Startup tab and review the configurable variables (see the table in Section 2).
- Set AUTH_TOKEN to your Bannerlord dedicated server authentication token. See the TaleWorlds guide for how to generate one.
- Server name, game mode, and other settings are configured in the config file (see Section 3).
- Return to the Console tab and click Start.
- Wait for the console to confirm the server has started. The first launch generates configuration files and may take a minute to initialize.
AUTH_TOKEN) tied to a TaleWorlds/Steam account. You must generate this token yourself and enter it in the GPanel Startup tab. See this TaleWorlds guide for instructions. If you encounter token-related errors, open a support ticket.
2. GPanel Startup Variables
The following variables are available in the GPanel Startup tab. These are passed to the server on each start.
| Variable | Required | Description |
|---|---|---|
AUTH_TOKEN |
Yes | Dedicated server authentication token from TaleWorlds. See this guide for how to generate one. |
AUTO_UPDATE |
No | Auto-update the server on restart. 1 = enabled, 0 = disabled. Default is 1. |
3. Server Configuration File
Bannerlord servers use a text-based configuration file that contains one command per line. The server executes each line sequentially on startup. Stop your server before making changes.
File Location
The config file is located in the Native module directory:
Modules/Native/<gamemode>_config.txt
For example, tdm_config.txt for Team Deathmatch, siege_config.txt for Siege, or skirmish_config.txt for Skirmish. Open the file using the Files tab in GPanel or connect via SFTP.
Key Configuration Commands
| Command | Description |
|---|---|
ServerName My Server |
Server name shown in the multiplayer browser. |
GamePassword secret |
Password required to join. Omit the line for a public server. |
AdminPassword adminpass |
Password for admin access. Required for the web interface and admin commands. |
GameType TeamDeathmatch |
Game mode. See Section 4 for all available modes. |
WelcomeMessage Welcome to our server! |
Greeting shown when players join. |
MaxNumberOfPlayers 120 |
Maximum concurrent players. |
MinNumberOfPlayersForMatchStart 2 |
Minimum players needed to start a match. |
CultureTeam1 empire |
Faction for Team 1 (attackers). See Section 6. |
CultureTeam2 sturgia |
Faction for Team 2 (defenders). See Section 6. |
NumberOfBotsTeam1 0 |
Number of AI bots on Team 1. Set to 0 for players only. |
NumberOfBotsTeam2 0 |
Number of AI bots on Team 2. |
RoundTimeLimit 180 |
Time limit per round in seconds. |
MapTimeLimit 900 |
Total time limit per map before rotation, in seconds. |
MinScoreToWinMatch 3 |
Number of round wins needed to win the match. |
EnableAntiCheat true |
Enable or disable anti-cheat. Recommended to keep enabled. |
FriendlyFireDamageMeleeSelfPercent 0 |
Self-damage percentage from friendly fire melee. 0 disables. |
add_map_to_automated_battle_pool <MapName> |
Adds a map to the automatic rotation. Add multiple lines for multiple maps. |
enable_automated_battle_switching |
Enables automatic rotation through the map pool after each match. |
start_game_and_mission |
Starts the server and immediately begins gameplay. Place this at the end of the config file. |
Example Configuration (Team Deathmatch)
ServerName Legion TDM Server
AdminPassword YourAdminPassword
GameType TeamDeathmatch
WelcomeMessage Welcome to the Legion Hosting TDM server!
MaxNumberOfPlayers 60
MinNumberOfPlayersForMatchStart 2
CultureTeam1 vlandia
CultureTeam2 battania
NumberOfBotsTeam1 0
NumberOfBotsTeam2 0
MapTimeLimit 600
EnableAntiCheat true
add_map_to_automated_battle_pool mp_tdm_map_001_spring
add_map_to_automated_battle_pool mp_tdm_map_003
add_map_to_automated_battle_pool mp_tdm_map_004
add_map_to_automated_battle_pool mp_tdm_map_005
enable_automated_battle_switching
start_game_and_mission
AdminPassword line is missing or empty, the server may fail to start or the web admin interface will not function. Always set a strong admin password.
4. Game Modes
Bannerlord supports six multiplayer game modes. Set the mode using the GameType config command or the GAME_TYPE startup variable.
| Game Mode | Config Value | Description |
|---|---|---|
| Team Deathmatch | TeamDeathmatch |
Two teams fight to score the most kills within the time limit. Fast-paced combat with instant respawns. |
| Siege | Siege |
Attackers assault a castle while defenders hold it. Includes siege equipment, capture points, and large-scale battles. Supports the most players. |
| Captain | Captain |
Each player commands a squad of AI troops. Strategic mode where you lead soldiers into battle with formation commands. |
| Skirmish | Skirmish |
Small team objective-based mode with flag capture. Round-based with limited lives per class. |
| Duel | Duel |
One-on-one combat. Players challenge each other to honorable duels in an arena setting. |
| Battle | Battle |
Large-scale team battles with one life per round. Eliminates respawns for tactical, high-stakes combat. |
5. Map Selection and Rotation
Maps are added to the server's rotation pool using the add_map_to_automated_battle_pool command in the config file. Each game mode has its own set of compatible maps.
Team Deathmatch Maps
| Map Name | Internal ID |
|---|---|
| Harbour of Ovsk (Winter) | mp_tdm_map_001 |
| Harbour of Ovsk | mp_tdm_map_001_spring |
| Tsagaan Castle | mp_tdm_map_003 |
| Nord Town | mp_tdm_map_004 |
| Nord Town (Alt) | mp_tdm_map_004a |
| Baravenos Encirclement | mp_tdm_map_005 |
Siege Maps
| Map Name | Internal ID |
|---|---|
| Skala Landing | mp_siege_map_003 |
| Baravenos Encirclement | mp_siege_map_005 |
| Castle of Fen Altai | mp_siege_map_007_battania |
| Ayzar Stronghold | mp_siege_map_009 |
| Domogtul Castle | mp_siege_map_012 |
Skirmish Maps
| Map Name | Internal ID |
|---|---|
| Town Outskirts | mp_skirmish_map_002f |
| Xauna | mp_skirmish_map_007 |
| Echerion | mp_skirmish_map_010 |
| Urikskalaar | mp_skirmish_map_014 |
| Sharis | mp_skirmish_map_020 |
Captain Maps
| Map Name | Internal ID |
|---|---|
| Ruins of Jawwali | mp_sergeant_map_007 |
| Druimmor Forest | mp_sergeant_map_008 |
| Cliffs of Akkalat | mp_sergeant_map_009 |
| Pendaric | mp_sergeant_map_010 |
| Isle of Deriad | mp_sergeant_map_011 |
Duel Maps
| Map Name | Internal ID |
|---|---|
| Proving Grounds | mp_duel_mode_map_004 |
| Proving Grounds (Night) | mp_duel_mode_map_004_night |
Battle Maps
| Map Name | Internal ID |
|---|---|
| Cypegos Blockage | mp_battle_map_001 |
| Osrac Insurrection | mp_battle_map_002 |
| Skolder Hideout | mp_battle_map_003 |
GameType you have configured. Note that Captain mode maps use the mp_sergeant_ prefix internally.
Map Rotation Example
To set up automatic map rotation, add multiple maps to the pool and enable automated switching:
add_map_to_automated_battle_pool mp_siege_map_003
add_map_to_automated_battle_pool mp_siege_map_005
add_map_to_automated_battle_pool mp_siege_map_007_battania
add_map_to_automated_battle_pool mp_siege_map_009
add_map_to_automated_battle_pool mp_siege_map_012
enable_automated_battle_switching
start_game_and_mission
The server will cycle through these maps in order after each match completes.
6. Culture and Faction Settings
Bannerlord features six playable factions (cultures) that determine the troop types, equipment, and visual appearance for each team. Set factions using CultureTeam1 and CultureTeam2 in the config file.
| Faction | Config Value | Style |
|---|---|---|
| Empire | empire |
Roman-inspired heavy infantry and cavalry with strong armor and discipline. |
| Vlandia | vlandia |
Western European-style knights with powerful crossbowmen and heavy cavalry. |
| Sturgia | sturgia |
Norse/Slavic-inspired warriors with strong infantry, axes, and shield walls. |
| Battania | battania |
Celtic-inspired faction with excellent archers, skirmishers, and woodland troops. |
| Khuzait | khuzait |
Mongol-inspired nomadic warriors with powerful mounted archery and cavalry. |
| Aserai | aserai |
Arabian-inspired faction with versatile cavalry, camel troops, and desert warriors. |
CultureTeam1 vlandia
CultureTeam2 khuzait
7. How to Connect
Option A -- In-Game Server Browser
- Launch Mount & Blade II: Bannerlord.
- From the main menu, select Multiplayer.
- Ensure the standard mods/modules are activated when prompted.
- Select Custom Server List (or Dedicated Server List depending on your game version).
- Use the search bar or scroll to find your server by name.
- Select your server and click Join. Enter the game password if one is set.
Option B -- Direct Connect
- Launch Mount & Blade II: Bannerlord.
- From the main menu, select Multiplayer.
- Open the console with Alt + ~ (tilde key).
- Enter the following command using your server's IP and port from GPanel's Network tab:
open <your-server-ip>:<port> - Enter the game password if prompted.
8. Round and Match Settings
Fine-tune the match experience with these settings in your config file:
| Setting | Recommended Value | Description |
|---|---|---|
RoundTimeLimit |
180 |
Maximum duration of each round in seconds. 180 (3 minutes) is standard for most modes. |
MapTimeLimit |
900 |
Total time on a single map before rotation. 900 (15 minutes) allows several rounds per map. |
MinScoreToWinMatch |
3 |
Number of round wins needed to win the overall match. |
MinNumberOfPlayersForMatchStart |
2 |
Minimum players needed before a match begins. Set to 1 for testing. |
Related Articles
- Mount and Blade II Bannerlord Admin Setup
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide
Need Help?
If you run into issues with your Bannerlord server that are not covered here, open a support ticket and include your server IP, the game mode you are running, and any relevant error messages from the GPanel console.