Server Configuration - Revision history

Xarkanoth at 17:48, 11 July 2026

2026-07-11T17:48:33Z

@@ Line 1: / Line 1: @@
-<div class="hf-relpage">
+<div class="hf-relpage hf-reference-page hf-server-configuration-page">
 {{Release_page_header|title=Server Configuration}}
 <div class="hf-relpage-body">
@@ Line 15: / Line 15: @@
 }}
 <div class="hf-relpage-content">
 {{Release_section

Creator: adding more basic command descriptions

2026-07-08T13:19:35Z

adding more basic command descriptions

← Older revision		Revision as of 15:19, 8 July 2026
Line 181:		Line 181:

	Most map rotation commands can now be placed at the top of the server config file, before the map rotations section, and they will be applied to all map rotations that don't already have the same command. Some exceptions are commands that are map-specific such as map_name and game_mode.		Most map rotation commands can now be placed at the top of the server config file, before the map rotations section, and they will be applied to all map rotations that don't already have the same command. Some exceptions are commands that are map-specific such as map_name and game_mode.

			=== Maps ===
			Visit [[Maps\|Maps]] or [[Server Configuration Enums\|Server Configuration Enums]] for a full list of all maps.

			General map rotation commands:
			* <code>map_name</code> - the map for this rotation
			* <code>game_mode</code> - the game mode for this rotation (ArmyBattlefield, CoastalSiege etc)
			* <code>game_type</code> - the game type for this rotation (Standard or Hardcore)
			* <code>faction_attacking</code> - the attacking faction for this rotation
			* <code>faction_defending</code> - the defending faction for this rotation
			* <code>round_time_minutes</code> - round length, in minutes
			* <code>allow_midround_spawning</code> - whether players can spawn after the round has started
			* <code>allow_faction_switching</code> - whether players may switch faction mid round
			* <code>minimum_players</code> - minimum players required before the round starts
			* <code>reinforcements_per_faction</code> - shared respawn tickets available to each faction
			* <code>max_accumulated_faction_points</code> - cap on faction points that can accumulate in a round
			* <code>deathmatch_max_kills</code> - kills required to win in deathmatch mode
			* <code>max_player_respawns</code> - maximum times a player can respawn (-1 for unlimited)

	Randomly assign a faction to the chosen side(s) each round:		Randomly assign a faction to the chosen side(s) each round:
Line 219:		Line 237:
	Countdown before a round begins:		Countdown before a round begins:
	<pre class="hf-code">round_countdown_timer_seconds 10</pre>		<pre class="hf-code">round_countdown_timer_seconds 10</pre>

	~~=== Maps ===~~
	~~Visit [[Maps\|Maps]] or [[Server Configuration Enums\|Server Configuration Enums]] for a full list of all maps.~~

	=== Officer Orders ===		=== Officer Orders ===
Line 235:		Line 250:
	Enable/disable hoist flag order in naval:		Enable/disable hoist flag order in naval:
	<pre class="hf-code">hoist_flag_order_enabled <true/false></pre>		<pre class="hf-code">hoist_flag_order_enabled <true/false></pre>

			Have officers spawn mounted on horses:
			<pre class="hf-code">officers_spawn_mounted <true/false></pre>

	=== Abilities ===		=== Abilities ===
Line 281:		Line 299:
	Set whether muskets start with their bayonets attached or not on spawn:		Set whether muskets start with their bayonets attached or not on spawn:
	<pre class="hf-code">start_bayonet_attached <true/false></pre>		<pre class="hf-code">start_bayonet_attached <true/false></pre>

			Restrict players to melee weapons only:
			<pre class="hf-code">melee_weapons_only <true/false></pre>

			Allow players to enter spectate mode:
			<pre class="hf-code">allow_spectating <true/false></pre>

	Set whether enemy players should still show their name tags:		Set whether enemy players should still show their name tags:
	<pre class="hf-code">show_enemy_player_name_tags <true/false></pre>		<pre class="hf-code">show_enemy_player_name_tags <true/false></pre>

	Enable or disable use of the in-game admin console on this rotation:		Enable or disable use of the in-game admin console on this rotation (if disabled, admins can only use P menu actions):
	<pre class="hf-code">admin_console_allowed <true/false></pre>		<pre class="hf-code">admin_console_allowed <true/false></pre>

Line 433:		Line 457:
	Set whether port spawners spawn gunboats instead of rowboats (default true):		Set whether port spawners spawn gunboats instead of rowboats (default true):
	<pre class="hf-code">gunboat_spawner_enabled <true/false></pre>		<pre class="hf-code">gunboat_spawner_enabled <true/false></pre>

			Seconds before a destroyed ship respawns:
			<pre class="hf-code">ships_respawn_timer <Seconds></pre>

			Rowboat spawner cooldown timers:
			<pre class="hf-code">rowboat_cooldown_timer <Seconds>
			rowboat_cooldown_while_sinking_timer <Seconds></pre>

	==== Health Override For Ships ====		==== Health Override For Ships ====
Line 490:		Line 521:
	Parameter 4: Percentage reduction in ship speed when ramming.		Parameter 4: Percentage reduction in ship speed when ramming.

	==== Ship ~~Spacemode~~ ====		==== Ship Space Mode ====
	<pre class="hf-code">ships_spacemode true</pre>		<pre class="hf-code">ships_spacemode true</pre>

Creator at 12:54, 8 July 2026

2026-07-08T12:54:33Z

@@ Line 106: / Line 106: @@
 Example:
 <pre class="hf-code">network_broadcast_mode Standard</pre>
 '''Population thresholds''' (gate maps by player counts):
@@ Line 172: / Line 175: @@
 game_type
 round_time_minutes
 faction_balancing
 faction_attacking
 faction_defending
-max_tickets
+max_tickets</pre>
 Most map rotation commands can now be placed at the top of the server config file, before the map rotations section, and they will be applied to all map rotations that don't already have the same command. Some exceptions are commands that are map-specific such as map_name and game_mode.

Creator at 12:25, 8 July 2026

2026-07-08T12:25:03Z

← Older revision		Revision as of 14:25, 8 July 2026
Line 7:		Line 7:
	<div>[[#import-files\|Importing Config Files]]</div>		<div>[[#import-files\|Importing Config Files]]</div>
	<div>[[#server-wide\|Server-Wide Settings]]</div>		<div>[[#server-wide\|Server-Wide Settings]]</div>
	~~<div>[[#frontlines-commands\|Frontlines Commands]]</div>~~
	<div>[[#auto-shutdown\|Auto Shutdown/Restart]]</div>		<div>[[#auto-shutdown\|Auto Shutdown/Restart]]</div>
	<div>[[#map-rotations\|Map Rotations]]</div>		<div>[[#map-rotations\|Map Rotations]]</div>

Creator at 12:23, 8 July 2026

2026-07-08T12:23:40Z

← Older revision		Revision as of 14:23, 8 July 2026
Line 351:		Line 351:
	Categories: BaseSpawn, FortifiedPosition, OpenPlains, Farm, Field, Village, Camp, Lodge, Church, Ruins, Port, Ship.		Categories: BaseSpawn, FortifiedPosition, OpenPlains, Farm, Field, Village, Camp, Lodge, Church, Ruins, Port, Ship.

	=== Exclusive Modded Uniforms ===		==== Exclusive Modded Uniforms ====
	Restrict specific factions to using only uniforms from the currently loaded mods.		Restrict specific factions to using only uniforms from the currently loaded mods.
	<pre class="hf-code">exclusive_modded_uniforms british french</pre>		<pre class="hf-code">exclusive_modded_uniforms british french</pre>
Line 379:		Line 379:
	<pre class="hf-code">weapon_class_ammo_override <Faction> <Class> <WeaponClass> <StartingAmmo> <LoadedInBarrel> <MaxCarry></pre>		<pre class="hf-code">weapon_class_ammo_override <Faction> <Class> <WeaponClass> <StartingAmmo> <LoadedInBarrel> <MaxCarry></pre>

	==== Sapper Buildable Defences — Limits ====		==== Sapper Buildable Defences - Limits ====
	<pre class="hf-code">sappers_buildlimit <EmplacementType> <attacking\|defending> <Limit></pre>		<pre class="hf-code">sappers_buildlimit <EmplacementType> <attacking\|defending> <Limit></pre>

Creator at 12:21, 8 July 2026

2026-07-08T12:21:15Z

@@ Line 62: / Line 62: @@
 !map_rotation end</pre>
 }}
 {{Release_section
@@ Line 227: / Line 226: @@
 Spawn immunity (max 5s):
 <pre class="hf-code">spawn_immunity_timer 5</pre>
 === Melee Arena Settings ===
@@ Line 374: / Line 346: @@
 <pre class="hf-code">spawn_inclusive_override A Carpenter 20</pre>
-'''exclusive_modded_uniforms''' — restrict to mod uniforms:
+==== Spawn Overrides (Land) ====
 <pre class="hf-code">exclusive_modded_uniforms british french</pre>
@@ Line 417: / Line 395: @@
 sappers_defending_starting_materials 200</pre>
-==== Spawn Overrides (Land) ====
+=== Artillery Dynamic Spawn Sections ===
-<pre class="hf-code">objects_override spawnsection &lt;Position&gt; &lt;Rotation&gt; &lt;ID&gt;,&lt;Spawn_Name&gt;,&lt;Category&gt;,&lt;Attacking|Defending|Neutral&gt;,&lt;SizeX&gt;,&lt;SizeY&gt;</pre>
-Categories: BaseSpawn, FortifiedPosition, OpenPlains, Farm, Field, Village, Camp, Lodge, Church, Ruins, Port, Ship.
+Set whether dynamic artillery come with cannoneer spawn sections or not, and whether they should be locked to their owners or usable by anyone (Note: If disabled, you may want to use spawn overrides to add cannoneer slots to the HQ spawns, since they don’t come with cannoneer slots any more on default maps.)
 === Naval ===

Creator at 12:14, 8 July 2026

2026-07-08T12:14:34Z

← Older revision		Revision as of 14:14, 8 July 2026
Line 202:		Line 202:

	Most map rotation commands can now be placed at the top of the server config file, before the map rotations section, and they will be applied to all map rotations that don't already have the same command. Some exceptions are commands that are map-specific such as map_name and game_mode.		Most map rotation commands can now be placed at the top of the server config file, before the map rotations section, and they will be applied to all map rotations that don't already have the same command. Some exceptions are commands that are map-specific such as map_name and game_mode.

			Randomly assign a faction to the chosen side(s) each round:
			<pre class="hf-code">faction_randomiser <Attacking/Defending/Both></pre>

	=== Faction Balancing ===		=== Faction Balancing ===
	When <code>faction_balancing</code> is enabled, players ~~are moved between factions~~ to ~~keep~~ the ~~teams even~~. <code>faction_balancing_discrepancy_amount</code> sets how large the player-count difference between factions is allowed to get before balancing kicks in.		When <code>faction_balancing</code> is enabled, players will be prevented to join a faction that has a significantly higher player count than the other faction. <code>faction_balancing_discrepancy_amount</code> sets how large the player-count difference between factions is allowed to get before balancing kicks in.

	The allowed discrepancy can also be set individually per population bracket, overriding the global value at that bracket:		The allowed discrepancy can also be set individually per population bracket, overriding the global value at that bracket:
Line 212:		Line 215:
	faction_balancing_discrepancy_amount_high 10</pre>		faction_balancing_discrepancy_amount_high 10</pre>

	~~Set~~ a target population ratio between attackers and defenders (both values must be above 0). Useful on asymmetric maps where one side should hold more players:		You can also set a target population ratio between attackers and defenders (both values must be above 0). Useful on asymmetric maps where one side should hold more players:
	<pre class="hf-code">faction_balancing_ratio <attackers> <defenders>		<pre class="hf-code">faction_balancing_ratio <attackers> <defenders>
	faction_balancing_ratio 3 2</pre>		faction_balancing_ratio 3 2</pre>
Line 329:		Line 332:
	Set whether enemy players should still show their name tags:		Set whether enemy players should still show their name tags:
	<pre class="hf-code">show_enemy_player_name_tags <true/false></pre>		<pre class="hf-code">show_enemy_player_name_tags <true/false></pre>

	~~Randomly assign a faction to the chosen side(s) each round (works with <code>faction_attacking</code> / <code>faction_defending</code>):~~
	~~<pre class="hf-code">faction_randomiser <Attacking/Defending/Both></pre>~~

	Enable or disable use of the in-game admin console on this rotation:		Enable or disable use of the in-game admin console on this rotation:

Creator: exclude from map voting history

2026-07-08T12:11:27Z

exclude from map voting history

← Older revision		Revision as of 14:11, 8 July 2026
Line 583:		Line 583:
	map_voting_history_count_medium 4		map_voting_history_count_medium 4
	map_voting_history_count_high 10</pre>		map_voting_history_count_high 10</pre>

			The map-voting history normally stops recently-played maps from reappearing in votes. You can use this command to exclude specific game modes from the history, so maps of those modes can be voted for again without waiting:
			<pre class="hf-code">exclude_from_map_voting_history <GameMode> <GameMode> ...</pre>

	=== Can I Manually Trigger Map Voting? ===		=== Can I Manually Trigger Map Voting? ===

Creator: global officer chat

2026-07-08T12:08:16Z

global officer chat

← Older revision		Revision as of 14:08, 8 July 2026
Line 108:		Line 108:
	Example:		Example:
	<pre class="hf-code">network_broadcast_mode Standard</pre>		<pre class="hf-code">network_broadcast_mode Standard</pre>

	~~'''Frontlines'''~~
	~~Use this to set the game type to Frontlines (defaults to false):~~
	~~<pre class="hf-code">frontlines_mode true</pre>~~

	~~'''Artillery respawn''' (seconds, defaults are 120s):~~
	~~<pre class="hf-code">artillery_fieldgun_respawn_timer 120~~
	~~artillery_rocketlauncher_respawn_timer 120</pre>~~

	'''Population thresholds''' (gate maps by player counts):		'''Population thresholds''' (gate maps by player counts):
Line 125:		Line 117:
	<pre class="hf-code">show_serverperformance_warning true		<pre class="hf-code">show_serverperformance_warning true
	map_rotation_start_randomise true</pre>		map_rotation_start_randomise true</pre>

			'''Global officer chat''' (Enable a separate chat channel that officers can speak in globally):
			<pre class="hf-code">include_officer_only_chat true
			include_sergeants_in_officer_chat true</pre>

	'''Objective capture''' (Conquest/flag modes):		'''Objective capture''' (Conquest/flag modes):
Line 131:		Line 127:
	conquest_stealthcap_reqplayers_medium 3		conquest_stealthcap_reqplayers_medium 3
	conquest_stealthcap_reqplayers_high 4</pre>		conquest_stealthcap_reqplayers_high 4</pre>

			=== Frontlines ===
			Use this to set the game type to Frontlines (defaults to false):
			<pre class="hf-code">frontlines_mode true</pre>
	}}		}}

Creator: moved artillery spawn sections to map rotations

2026-07-08T11:54:43Z

moved artillery spawn sections to map rotations

@@ Line 116: / Line 116: @@
 <pre class="hf-code">artillery_fieldgun_respawn_timer 120
 artillery_rocketlauncher_respawn_timer 120</pre>
 '''Population thresholds''' (gate maps by player counts):
@@ Line 248: / Line 224: @@
 Spawn immunity (max 5s):
 <pre class="hf-code">spawn_immunity_timer 5</pre>
 Set whether dynamic artillery come with cannoneer spawn sections or not, and whether they should be locked to their owners or usable by anyone (Note: If disabled, you may want to use spawn overrides to add cannoneer slots to the HQ spawns, since they don’t come with cannoneer slots any more on default maps.)
@@ Line 262: / Line 262: @@
 <pre class="hf-code">amount_of_rounds 50</pre>
-Countdown before a round begins (Melee Arena only):
+Countdown before a round begins:
 <pre class="hf-code">round_countdown_timer_seconds 10</pre>

← Older revision		Revision as of 14:25, 8 July 2026
Line 7:		Line 7:
	<div>[[#import-files\|Importing Config Files]]</div>		<div>[[#import-files\|Importing Config Files]]</div>
	<div>[[#server-wide\|Server-Wide Settings]]</div>		<div>[[#server-wide\|Server-Wide Settings]]</div>
	~~<div>[[#frontlines-commands\|Frontlines Commands]]</div>~~
	<div>[[#auto-shutdown\|Auto Shutdown/Restart]]</div>		<div>[[#auto-shutdown\|Auto Shutdown/Restart]]</div>
	<div>[[#map-rotations\|Map Rotations]]</div>		<div>[[#map-rotations\|Map Rotations]]</div>