Difference between revisions of "Server Configuration"

From Holdfast: Nations At War
Jump to navigation Jump to search
(Replaced content with "{{DISPLAYTITLE:Server Configuration}} {{ContentTemplateModernInline | welcome = link=|left|alt=Server Configuration | blurb...")
Tag: Replaced
 
(93 intermediate revisions by 14 users not shown)
Line 1: Line 1:
−
=Override Commands & Server-Side Modding=
+
{{DISPLAYTITLE:Server Configuration}}
 +
{{ContentTemplateModernInline
 +
| welcome            = [[File:Forum Logo.png|link=|left|alt=Server Configuration]]
 +
| blurb              = Configure Holdfast servers: globals, rotations, overrides, map voting, mods, and webhooks
 +
| sections_title    = On this page
 +
| sections_content  =
 +
* [[#Server-Wide Settings|Server-Wide Settings]]
 +
* [[#Frontlines specific commands|Frontlines specific commands]]
 +
* [[#Auto Shutdown/Restart System|Auto Shutdown/Restart System]]
 +
* [[#Map Rotations|Map Rotations]]
 +
** [[#Basic Map Settings|Basic Map Settings]]
 +
** [[#Melee Arena Settings|Melee Arena Settings]]
 +
** [[#Maps|Maps]]
 +
* [[#Officer orders|Officer orders]]
 +
* [[#Conquest config|Conquest config]]
 +
* [[#Weather and time of day|Weather and time of day]]
 +
* [[#Friendly fire|Friendly fire]]
 +
* [[#Frontlines|Frontlines]]
 +
* [[#Automatic Console Commands|Automatic Console Commands]]
 +
* [[#Override Commands|Override Commands]]
 +
** [[#Land|Land]]
 +
** [[#Naval|Naval]]
 +
** [[#Object Override|Object Override]]
 +
* [[#Map Voting|Map Voting]]
 +
* [[#Workshop Mods|Workshop Mods]]
 +
* [[#Discord Admin Webhook Logger|Discord Admin Webhook Logger]]
  
−
Server administrators are able to create and customise their own roleplay scenarios through various server-side configuration settings. [[Server_Configuration#Override Commands & Server-Side Modding|Override commands]] can be used to create a unique experience that is not limited by the usual confines of [[Holdfast: Nations At War|Holdfast: NaW’s]] original gameplay design. Configure limits for classes, define the allowed spawnable classes per spawn point, select the equipment they spawn with, equip weapons from racks, replenish ammunition, spawn various props, interactable objects and artillery pieces per map rotation and more.
+
  | featured_title    = Server Configuration
−
 
+
  | featured_content  = {{:{{FULLPAGENAME}}/Body}}
−
Here’s how you can make use of override commands and any other related commands that can prove useful to help you get started or create your own scenarios.
+
| image_content      =
−
 
+
| layout            = auto
−
== Land ==
+
| left_width        = 320px
−
===Class Limit Override On Spawn Points===
+
| aside_width        = 320px
−
 
+
| gap                = 0.5rem
−
Spawn override commands provide administrators with the ability to define which classes to spawn on which spawn location and their limitations as well. By using the following override, you can also have classes that are only playable on naval and coastal scenarios be present on army-based game modes.
+
| show_toc          = no
−
 
+
  | show_section_edit  = yes
−
''Note: This will overwrite (not add to!) the classes available at a spawn point.''
+
}}
−
 
 
−
[[File:200 Carpenters vs 200 Rifleman.png|thumb|right|Tahir Desert Army Battlefield 200 Carpenters vs 200 Rifleman ]]
 
−
 
 
−
;<code>'''spawn_override <Spawn Point> <[[Server_Configuration_Enums#Class|Class]]> <Class Limit>'''</code>
 
−
 
 
−
: '''<Spawn Point>''' correlates to the spawn present in the spawn menu for instance Barricade (A) on Spanish Farm. Values are defined as letters for <Spawn Point> A B C D E F G H etc...
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Class|Class]]>''' The name of the class being added to the spawn point
 
−
 
 
−
: '''<Class Limit>''' An integer value between 1 and 999 - Set the number of players allowed to spawn as the specified class
 
−
 
 
−
'''Example'''
 
−
 
 
−
These commands will give 1 team 200 of the carpenter class and the other team 200 Riflemen:
 
−
<pre>
 
−
# Override Commands (This is a comment and will be ignored by the game)
 
−
spawn_override A Carpenter 200
 
−
spawn_override B Rifleman 200
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Starting Weapon Override===
 
−
Make use of the following override command to define the weapons each and every class for a particular faction spawn with. Due to the introduction of weapon racks that allow players to equip weapons irrespective of their class, a particular class can now spawn with multiple different firearm or melee weapon types.
 
−
 
 
−
To use this command for yourself it must be added after !map_rotation start and before !map_rotation end in the following format...
 
−
 
 
−
;<code>starting_weapons_override <[[Server_Configuration_Enums#Faction|Faction]]> <[[Server_Configuration_Enums#Class|Class]]> <Maximum Firearm Weapons> <Maximum Melee Weapons> <[[Server_Configuration_Enums#Weapon|Starting Weapon]]></code>
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Faction|Faction]]>''' The Faction of the Class you wish to customize
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Class|Class]]>''' The name of the class you wish to customize
 
−
 
 
−
: '''<Maximum Firearm Weapons>''' An integer value between 0 and 50. The Maximum amount of Firearms that the class can possess through either the starting weapons commands or weapon racks.
 
−
 
 
−
: '''<Maximum Melee Weapons>''' An integer value between 0 and 50. The Maximum amount of Melee Weapons that the class can possess through either the starting weapon commands or weapon racks.
 
−
:: Bayoneted Muskets count both as a firearm and a melee weapon
 
−
:: Allowing unarmed combat with fists also counts as a melee weapon
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Weapon|Starting Weapon]]>''' - The weapon(s) that the class will spawn with
 
−
 
 
−
For multiple weapons add a space then another '''<[[Server_Configuration_Enums#Weapon|Starting Weapon]]>''':
 
−
;<code>starting_weapons_override <[[Server_Configuration_Enums#Faction|Faction]]> <[[Server_Configuration_Enums#Class|Class]]> <Maximum Firearm Weapons> <Maximum Melee Weapons> <[[Server_Configuration_Enums#Weapon|Starting Weapon]]> <[[Server_Configuration_Enums#Weapon|Starting Weapon]]> <[[Server_Configuration_Enums#Weapon|Starting Weapon]]> <[[Server_Configuration_Enums#Weapon|Starting Weapon]]></code>
 
−
 
 
−
'''Example'''
 
−
 
 
−
Give the British grenadiers a rifle and give the French grenadiers a rifle, pike & sabre:
 
−
<pre># Override Commands (This is a comment and will be ignored by the game)
 
−
starting_weapons_override British Grenadier 4 2 BakerRifle
 
−
starting_weapons_override French Grenadier 4 3 BakerRifle Pike Sabre
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Firearm Ammo Override===
 
−
Use the following override command to configure firearm ammunition related settings as well as limitations. As the functionality for pickable weapons through weapon racks and ammo boxes exists within the game, through these settings we allow you to configure ammunition related settings for each and every weapon based on the class a firearm is being equipped by.
 
−
 
 
−
Input the below commands per map rotation in the server configuration file.
 
−
 
 
−
<code>firearm_ammo_override <[[Server_Configuration_Enums#Faction|Faction]]> <[[Server_Configuration_Enums#Class|Class]]> <Firearm> <Starting Ammo> <Loaded Ammo In Barrel> <Maximum Carryable Ammo></code>
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Faction|Faction]]>''' The Faction of the Class you wish to customize
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Class|Class]]>''' The name of the class you wish to customize
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Firearm|Firearm]]>''' The type of firearm that you are customizing
 
−
 
 
−
: '''<Starting Ammo>''' An integer between 0 and 999 - The amount of ammunition the firearm will start with
 
−
 
 
−
: '''<Loaded Ammo>''' An integer defined as a numerical value between 0 and 999 - How much ammunition is preloaded into the firearm for the weapons
 
−
:: Using values of 2 and above will act as temporary increase in clip size until the ammunition is drained and a reload is required.
 
−
 
 
−
: '''<Maximum Carryable Ammo>''' An integer between 0 and 999 - The maximum amount of ammunition able to be carried for a firearm.
 
−
:: This value can be larger than <Starting Ammo> for game-modes that use the ammo box object
 
−
 
 
−
'''Example'''
 
−
 
 
−
Give the British light infantry two rounds but none in the barrel and give the French light infantry a musket with one loaded round but none in reserve:
 
−
<pre># Override Commands (This is a comment and will be ignored by the game)
 
−
firearm_ammo_override British LightInfantry Musket 2 0
 
−
firearm_ammo_override French LightInfantry Musket 0 1
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
== Naval ==
 
−
===Class Limit Override On Ships===
 
−
By using the following override commands, you can define your own selection of classes to spawn on which ship. It also provides you with the option of allowing players to spawn with army-based classes on ships. IE. If you’re looking at allowing players to spawn with the Line Infantry Class on the 13-Gun Brig-Sloop, you can do just that.
 
−
 
 
−
Input the below commands per map rotation in the server configuration file.
 
−
 
 
−
<code>ship_spawn_detail_override <[[Server_Configuration_Enums#ShipType|Ship Type]]> <[[Server_Configuration_Enums#Faction|Faction]]> <[[Server_Configuration_Enums#Class|Class]]> <Class Limit></code>
 
−
 
 
−
: '''<[[Server_Configuration_Enums#ShipType|Ship Type]]>''' Ship type of which to override the spawn point of
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Faction|Faction]]>''' The Faction of the ship
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Class|Class]]>''' The name of the class being added to the spawn point
 
−
 
 
−
: '''<Class Limit>''' An integer value between 1 and 999
 
−
 
 
−
'''Example'''
 
−
 
 
−
"Only" allow 200 Riflemen for British and French frigates.
 
−
<pre>
 
−
# Override Commands (This is a comment and will be ignored by the game)
 
−
ship_spawn_detail_override Frigate50gun British Rifleman 200
 
−
ship_spawn_detail_override Frigate50gun French Rifleman 200
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Ship Spawning & Custom Ship Presets===
 
−
 
 
−
Make use of the commands below to define the ship types to spawn in a particular map rotation. Through the same command, you can also define the number of ships to spawn, for which faction as well as their paint scheme. It works on both the Naval Battlefield, Naval Assault & Coastal Siege game modes. You must make sure to set ‘ships_preset’ index to 37 per map rotation before using the command below. This preset index doesn’t contain any ships so you retain further control over the ships you want to spawn. IE. You can spawn in 1 50-Gun Frigate with a yellow and black color scheme for the British faction while having 3 8-Gun Schooners for the French with a random color variation
 
−
 
 
−
Input the below commands per map rotation in the server configuration file.
 
−
 
 
−
<code>ships_spawn <[[Server_Configuration_Enums#ShipType|Ship Type]]> <Amount Of Ships> <[[Server_Configuration_Enums#Faction|Faction]]> <Color></code>
 
−
 
 
−
: '''<[[Server_Configuration_Enums#ShipType|Ship Type]]>''' Ship type to spawn
 
−
 
 
−
: '''<Amount Of Ships>''' An integer between 0 and 50 - Amount of ships to spawn
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Faction|Faction]]>''' The Faction of the ship
 
−
 
 
−
: '''<Color>''' Color is defined as a numerical value between 0 and 5
 
−
 
 
−
'''Example'''
 
−
 
 
−
Spawn 1 British frigate and 10 French rocketboats.
 
−
<pre>
 
−
# Override Commands (This is a comment and will be ignored by the game)
 
−
# Set ship_preset to 37 (doesn't spawn any ships)
 
−
ships_preset 37
 
−
# Spawn ships
 
−
ships_spawn Frigate50gun 1 British 0
 
−
ships_spawn Rocketboat 10 French 4
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Health Override For Ships===
 
−
 
 
−
Administrators can define health points for each and every naval vessel type within the game. This addition could prove useful for organised events or perhaps even the creation of unique scenarios featuring flagships.
 
−
 
 
−
Input the below commands per map rotation in the server configuration file.
 
−
 
 
−
<code>ships_health_detail_override <[[Server_Configuration_Enums#ShipType|Ship Type]]> <[[Server_Configuration_Enums#Faction|Faction]]> <Health Points></code>
 
−
 
 
−
: '''<[[Server_Configuration_Enums#ShipType|Ship Type]]>''' Ship type to spawn
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Faction|Faction]]>''' The Faction of the ship
 
−
 
 
−
: '''<Health Points>''' An integer value between 0 and 99999 - Health Points of the ship
 
−
 
 
−
'''Example'''
 
−
 
 
−
Set British frigate HP to 20000 and French frigate HP to 69 because Britannia rules the waves.
 
−
<pre>
 
−
# Override Commands (This is a comment and will be ignored by the game)
 
−
ships_health_detail_override Frigate50gun British 20000
 
−
ships_health_detail_override Frigate50gun French 69
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
==Object Override==
 
−
===Weapon Racks===
 
−
Weapon Racks are interactable objects that can hold specific amounts of weapons. Players can interact with a weapon rack by holding E to take a weapon from the rack and add it to their characters inventory. Taking a weapon depletes the amount left on the rack allowing for a limited supply of weapons if the server host wishes.
 
−
 
 
−
;<code>objects_override Weapon Rack <Object Position> <Object Rotation> <[[Server_Configuration_Enums#Weapon|Weapon]]> <Number Of Weapons In Rack></code>
 
−
 
 
−
:'''<Object Position>''' A set of values in the format x y z = 0 0 0 - The location of where the Weapon Rack will be spawned onto the map using x, y, and z coordinates
 
−
:: Enter <code>get playerPosition</code> into the [[Console|console]] ingame to display your character's position.
 
−
 
 
−
:'''<Object Rotation>''' A set of values in the format x y z = 0 0 0 - The orientation that the Weapon Rack will be rotated when spawned onto the map
 
−
:: Enter <code>get playerRotation</code> into the [[Console|console]] ingame to display your character's rotation.
 
−
 
 
−
: '''<[[Server_Configuration_Enums#Weapon|Weapon]]>''' The type of weapon that will be on the weapon rack
 
−
 
 
−
: '''<Number Of Weapons In Rack>''' An integer value between 0 and 999 - The number of weapons that can be obtained from the rack before its depleted
 
−
 
 
−
'''Example'''
 
−
 
 
−
Spawn a weapon rack at position (1 2 3) with rotation (7 8 9) with 4 rifles on it:
 
−
<pre># Override Commands (This is a comment and will be ignored by the game)
 
−
objects_override WeaponRack 1 2 3 7 8 9 BakerRifle 4
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Firearm Ammoboxes===
 
−
 
 
−
Customizable Ammobox for role-play and custom events. Through this, players can replenish their ammunition.
 
−
 
 
−
<code>objects_override firearmammobox <Object Position> <Object Rotation> <[[Server_Configuration_Enums#Firearm|Firearm]]> <Maximum Interactions Until Depletion> <Ammo Given> <Maximum Interactions Allowed Per Player></code>
 
−
 
 
−
:'''<Object Position>''' A set of values in the format x y z = 0 0 0 - The location of where the firearmammobox will be spawned onto the map using x, y, and z coordinates
 
−
:: Enter <code>get playerPosition</code> into the [[Console|console]] ingame to display your character's position.
 
−
 
 
−
:'''<Object Rotation>''' A set of values in the format x y z = 0 0 0 - The orientation that the firearmammobox will be rotated when spawned onto the map
 
−
:: Enter <code>get playerRotation</code> into the [[Console|console]] ingame to display your character's rotation.
 
−
 
 
−
:'''<[[Server_Configuration_Enums#Firearm|Firearm]]>''' Which Firearm will the ammunition box replenish
 
−
 
 
−
:'''<Maximum Interactions Until Depletion>''' An integer value between 0 and 999 - The amount of times players can retrieve ammunition from the box
 
−
 
 
−
:'''<Ammo Given>''' An integer value between 0 and 999 - The amount ammunition given to a player on each interaction
 
−
 
 
−
:'''<Maximum Interactions Allowed Per Player>''' An integer value between 0 and 999 - The Maximum times a specific player may retrieve ammunition from the box
 
−
:: Useful to prevent a player from hogging all the ammo
 
−
 
 
−
'''Example'''
 
−
 
 
−
Spawn a weapon rack at position (1 2 3) with rotation (7 8 9) with 20 total rounds depleted at a rate of 2 rounds per usage.
 
−
<pre># Override Commands (This is a comment and will be ignored by the game)
 
−
objects_override firearmammobox 1 2 3 7 8 9 20 2 1
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 
−
 
 
−
===Artillery and Other Props===
 
−
This command allows server hosts to add a massive assortment of objects such as extra artillery equipment, barricades, and pianos.  
 
−
 
 
−
<code>objects_override <[[Server_Configuration_Enums#Spawnable_Objects_Enums|Spawnable Object]]> <Object Position> <Object Rotation></code>
 
−
 
 
−
:'''<[[Server_Configuration_Enums#Spawnable_Objects_Enums|Spawnable Object]]>''' Object which to spawn
 
−
 
 
−
:'''<Object Position>''' A set of values in the format x y z = 0 0 0 - The location of where the object will be spawned onto the map using x, y, and z coordinates
 
−
:: Enter <code>get playerPosition</code> into the [[Console|console]] ingame to display your character's position.
 
−
 
 
−
:'''<Object Rotation>''' A set of values in the format x y z = 0 0 0 - The orientation that the object will be rotated when spawned onto the map
 
−
:: Enter <code>get playerRotation</code> into the [[Console|console]] ingame to display your character's rotation.
 
−
 
 
−
'''Example'''
 
−
 
 
−
Spawn a chair at position (1 2 3) with rotation (7 8 9).
 
−
Spawn a 9 Pounder cannon at position (5 6 7) with rotation (9 11 23).
 
−
<pre># Override Commands (This is a comment and will be ignored by the game)
 
−
objects_override Chair1 1 2 3 7 8 9
 
−
objects_override CannonFieldGun9Pdr 5 6 7 9 11 23
 
−
</pre>
 
−
 
 
−
To use this command, it must be added after <code>!map_rotation start</code> and before <code>!map_rotation end</code>.
 

Latest revision as of 09:29, 19 September 2025


Server Configuration

Configure Holdfast servers: globals, rotations, overrides, map voting, mods, and webhooks

Retrieved from "https://wiki.holdfastgame.com/index.php?title=Server_Configuration&oldid=3591"

Navigation menu