Mount & Blade II: Bannerlord Updated May 11, 2026

Bannerlord Server Configuration File

Complete reference for the Bannerlord dedicated server config file — all parameters, valid values, and recommended settings.

BannerlordConfigurationConfig FileServerSettings

Config File Location

Bannerlord server config files are plain .txt files placed in:

Modules\Native\

The file is referenced at startup via the /dedicatedcustomserverconfigfile argument:

DedicatedCustomServer.Starter.exe /dedicatedcustomserverconfigfile default.txt /dedicatedcustomserverauthtoken YOUR_TOKEN

The server reads each line of the file as a command and executes them sequentially at startup. Any command valid in the server console is also valid in this file.

Full Parameter Reference

ServerName "My Bannerlord Server"
GamePassword ""
AdminPassword "YourAdminPassword"
GameType Siege
Map mp_siege_map_005
MaxNumberOfPlayers 16
MinNumberOfPlayersForMatchStart 2
MapTimeLimit 20
WarmupTimeLimit 2
CultureTeam1 Battania
CultureTeam2 Vlandia
AllowPollsToKickPlayers 1
AllowPollsToBanPlayers 1
AllowPollsToChangeMaps 1
NumberOfBotsTeam1 0
NumberOfBotsTeam2 0
UnlimitedGold 1
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
enable_automated_battle_switching

Parameter Descriptions

Parameter Value Notes
ServerName String in quotes Displayed in the multiplayer browser
GamePassword String in quotes Leave empty ("") for a public server
AdminPassword String in quotes Players enter this in-game to claim admin
GameType See game modes article Must match the maps in the pool
Map Map name string Starting map; must be compatible with GameType
MaxNumberOfPlayers Integer Hard cap on concurrent players
MinNumberOfPlayersForMatchStart Integer Minimum before a match begins
MapTimeLimit Integer (minutes) Time per map before rotation
WarmupTimeLimit Integer (minutes) Pre-match warmup duration
CultureTeam1 / CultureTeam2 Faction name Battania, Vlandia, Sturgia, Aserai, Khuzait, Empire
AllowPollsToKickPlayers 0 or 1 Enables player-initiated kick votes
AllowPollsToBanPlayers 0 or 1 Enables player-initiated ban votes
AllowPollsToChangeMaps 0 or 1 Enables player map change votes
NumberOfBotsTeam1 / Team2 Integer AI bot count per team (0 = no bots)
UnlimitedGold 0 or 1 Disables gold economy in supported modes
add_map_to_automated_battle_pool Map name Adds a map to the rotation pool
enable_automated_battle_switching (no value) Activates the map rotation pool

Map Compatibility Warning

Maps are mode-specific. Using a siege map with GameType Captain will crash clients when they attempt to load in. Always confirm your maps match your GameType. See the map list article for the full breakdown.

Edit Workflow

Always stop the server before editing the config file. Changes take effect only on the next server start — the file is not re-read while the server is running.

  1. Stop server.
  2. Edit the .txt file.
  3. Start server.
  4. Type start_game in the console.

Listing Available Commands

In the server console, type:

list

This prints all valid commands for the running version. Use this to discover parameters not listed here if TaleWorlds adds new options in a patch.

Back to Knowledgebase
Need help? Submit a Ticket →