This guide covers admin setup, player management, server console commands, map rotation management, game mode switching, modding support, and troubleshooting for your Mount & Blade II: Bannerlord dedicated server. For initial server setup, game mode configuration, map selection, faction settings, and connection instructions, see Mount and Blade II Bannerlord Server Setup Guide.
1. Admin Setup
Setting the Admin Password
The admin password is set via the ADMIN_PASSWORD startup variable in GPanel, or in the config file using the AdminPassword command:
AdminPassword YourAdminPassword
This password is required for both the web admin interface and in-game admin access.
Accessing the Web Admin Panel
Bannerlord includes a built-in web admin panel powered by the DedicatedCustomServerHelper module.
- Find your server's IP address and port in GPanel's Network tab.
- Open a web browser and navigate to:
http://<your-server-ip>:<port>The web panel runs on the same port as the game server (default UDP 7210). Check your GPanel Network tab for the exact port.
- Enter your admin password when prompted.
In-Game Admin Access
- Join your server as a normal player.
- Open the game console with Alt + ~ (tilde key).
- Type
Helpto see available commands. - You may need to authenticate with the admin password through the in-game admin menu if prompted.
2. Server Console Commands
The following commands can be used in the server console (GPanel console) or the web admin panel. Type Help or list in the console to see all available commands.
Server Management Commands
| Command | Description |
|---|---|
ServerName <name> |
Changes the server display name. |
GameType <mode> |
Changes the game mode (Siege, TeamDeathmatch, Captain, Skirmish, Duel, Battle). |
WelcomeMessage <text> |
Sets the message shown to players on join. |
start_game |
Makes the server visible in the server browser and allows connections. |
start_mission |
Begins the current mission/match. Players can start fighting. |
start_game_and_mission |
Combined command: starts the server and immediately begins gameplay. |
add_map_to_usable_maps <MapName> <GameType> |
Registers a map as playable for a given game mode. |
add_map_to_automated_battle_pool <MapName> |
Adds a map to the automatic rotation pool. |
enable_automated_battle_switching |
Enables automatic map rotation after each match. |
set_automated_battle_count <number> |
Sets how many matches to play before the server shuts down. Useful for scheduled restarts. |
list |
Displays all available commands. |
3. Player Management
Kicking Players
To remove a player from the server:
- Web Admin: Navigate to the Players section in the web admin panel, find the player, and click Kick.
- Chat command: Open the in-game chat and type:
!kick <playername>
Kicked players can rejoin immediately unless you also ban them or set a server password.
Banning Players
To permanently prevent a player from joining:
- Web Admin: Use the ban option in the Players section of the web admin panel.
- Chat command: Open the in-game chat and type:
!ban <playername>
Bans persist across server restarts.
Unbanning Players
To remove a ban and allow a player to rejoin:
!unban <playername>
Muting Players
To prevent a player from using the in-game chat:
- Use the mute option in the web admin panel.
- Muted players can still play but cannot send chat messages.
4. Map Rotation Management
Changing the Current Map
To change the map during gameplay, use the web admin panel or modify the config file and restart the server. Maps must match the current game mode.
Editing the Map Rotation
The map rotation is defined in your game mode config file. To change it:
- Stop the server from GPanel.
- Open the config file (e.g.,
Modules/Native/siege_config.txt). - Modify the
add_map_to_automated_battle_poollines to add or remove maps. - Ensure
enable_automated_battle_switchingis present if you want automatic rotation. - Save and restart the server.
Single Map Mode
To run a single map without rotation, include only one add_map_to_automated_battle_pool line and omit enable_automated_battle_switching. The same map will replay each round.
5. Game Mode Switching
Changing the game mode requires updating both the GameType setting and the map pool, since maps are mode-specific.
- Stop the server from GPanel.
- Open the config file and change the
GameTypeline:GameType Siege - Replace the
add_map_to_automated_battle_poollines with maps compatible with the new mode. See the Setup Guide for map lists. - Save the file and start the server.
6. Modding Support
Bannerlord supports custom modules (mods) on dedicated servers. Mods can add new maps, game modes, weapons, troop types, and gameplay mechanics.
Installing Mods
- Stop the server from GPanel.
- Connect to your server via SFTP. See How to Upload Files via SFTP for instructions.
- Navigate to the
Modules/directory. - Upload the mod folder into
Modules/. Each mod should be in its own directory with aSubModule.xmlfile. - Update the server's startup command or batch file to include the mod in the modules list. The
_MODULES_parameter in the startup configuration must reference all active modules:Native*Multiplayer*DedicatedCustomServerHelper*YourModNameModules are separated by asterisks (
*). The load order matters -- place dependent mods after their prerequisites. - Start the server.
Steam Workshop Mods
Bannerlord supports Steam Workshop for mod distribution. To install Workshop mods on a dedicated server:
- Subscribe to the mod on Steam Workshop from a regular Bannerlord installation.
- Locate the downloaded mod folder in your local Bannerlord installation's
Modules/directory. - Upload the mod folder to your dedicated server's
Modules/directory via SFTP. - Add the module name to the startup modules list.
DedicatedCustomServerHelper Module
This built-in module provides the web admin panel. It must always be included in the modules list. If you encounter version mismatch errors after a game update:
- Stop the server.
- Navigate to
Modules/DedicatedCustomServerHelper/. - Open
SubModule.xml. - Update the
Versionvalue to match the current game version. - Update any
DependedModuleversion values accordingly. - Save and restart the server.
7. Troubleshooting
Server Crashes on Startup
- Check the console output for error messages. Common causes include:
- Missing or expired authentication token -- contact support if you see token errors.
- Invalid
AdminPasswordconfiguration -- ensure theAdminPasswordline exists and has a value. - Malformed config file syntax -- each command must be on its own line with no trailing characters.
- Module version mismatch after a game update -- update
SubModule.xmlversion numbers.
- Try removing all custom mods and running with only the default modules (
Native*Multiplayer*DedicatedCustomServerHelper). - Delete the config file and let the server regenerate defaults to rule out config issues.
Players Cannot Connect
- Verify the server is running in GPanel.
- Confirm the player is using the correct IP and port from the GPanel Network tab.
- Check that the game password is correct (case-sensitive).
- Ensure the player has the same game version and mods installed.
- If using mods, verify the player has the exact same module versions.
- Check the console for "player rejected" messages which may indicate the specific reason.
Server Not Appearing in Browser
- Confirm the server has fully started and the console shows it is accepting connections.
- Check that the config file includes
start_gameorstart_game_and_mission-- without this, the server will not register with the master server list. - The server browser may take several minutes to update. Try direct connect while waiting.
- If the authentication token is expired, the server may start but not appear in the browser. Contact support for token renewal.
Mod Conflicts
- If the server crashes after adding a mod, remove it and test again to confirm it is the cause.
- Check that the mod's
SubModule.xmllists correct dependencies and the load order in your modules list is correct. - Verify the mod is compatible with the current version of Bannerlord. Mods from older versions may cause crashes.
- Some mods conflict with each other. Check the mod documentation and community forums for known incompatibilities.
- Clear the server's shader cache and temp files if you experience graphical issues or loading errors after mod changes.
Player Desync
- Desync occurs when a player's game state diverges from the server. Symptoms include players appearing to teleport, hits not registering, or rubber-banding.
- The most common cause is high latency. Encourage affected players to check their internet connection.
- Mods that modify gameplay mechanics (movement speed, physics, weapon stats) are more likely to cause desync.
- If desync is widespread, try reducing
MaxNumberOfPlayersor switching to a lighter game mode (Duel or Skirmish instead of Siege). - Restarting the server can resolve persistent desync issues.
Authentication Token Issues
- Bannerlord requires a valid authentication token to run a dedicated server. Tokens expire after approximately 3 months.
- If you see token-related errors in the console, the token likely needs renewal.
- Open a support ticket to have your server's authentication token refreshed.
8. Log Files
Bannerlord server logs are useful for diagnosing crashes, connection issues, and player activity.
- Log files are stored in the server's log directory, typically accessible through GPanel's Files tab or via SFTP.
- Check log files for detailed error messages when the console output alone is not sufficient.
- Include relevant log excerpts when opening a support ticket for faster resolution.
Related Articles
- Mount and Blade II Bannerlord Server Setup Guide
- 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, any mods installed, and relevant error messages from the GPanel console or log files.