Difference between revisions of "Admin Features"

From Holdfast: Nations At War
Jump to navigation Jump to search
Line 12: Line 12:
 
== Fire Out Of Line ==
 
== Fire Out Of Line ==
 
Fire Out Of Line only allows shooting firearms while players are within a line. To enable it, use: <pre>fol_enabled true</pre>
 
Fire Out Of Line only allows shooting firearms while players are within a line. To enable it, use: <pre>fol_enabled true</pre>
 
  
 
There are 4 different settings that you can set either globally or per player class.
 
There are 4 different settings that you can set either globally or per player class.
Line 18: Line 17:
 
{| class="wikitable"
 
{| class="wikitable"
 
|+
 
|+
!Variable Name
+
FOL Class Settings
 +
!Setting Name
 
!Description
 
!Description
 
!Default Value
 
!Default Value
Line 40: Line 40:
 
|}
 
|}
  
Below is an example of allowing Surgeons to Skirm<pre>
+
Some classes have specific default value overrides, listed here:
mod_variable AutoAdmin:Surgeon:Player,5,6,1
+
{| class="wikitable"
 +
|+FOL Class Default Overrides
 +
!Class
 +
!Setting
 +
!Override Value
 +
|-
 +
|Light Infantry
 +
|radius
 +
|5
 +
|-
 +
|Rifleman
 +
|radius
 +
|5
 +
|-
 +
|Cannoneer
 +
|artillery_radius
 +
|15
 +
|-
 +
|Rocketeer
 +
|artillery_radius
 +
|15
 +
|-
 +
|Sapper
 +
|artillery_radius
 +
|15
 +
|}
  
</pre>Below is an example of allowing Guards to Skirm around a cannon, while only allowing them to shoot in line when no cannon is near. <pre>
+
To override the defaults for all classes with your own values, use:<pre>fol_default <FOLSettingName> <value></pre>
mod_variable autoadmin:Guard:Player,1.13,2.13,2
+
 
mod_variable autoadmin:Guard:Arty,15,20,1
+
You can also override any default value for any specific class. To do this, use:<pre>fol_class <PlayerClass> <FOLSettingName> <value></pre>
</pre>Below is an example of allowing Carpenters to fire only in line, skirm around a cannon and fire on horseback.<pre>
+
 
mod_variable autoadmin:Carpenter:Player,1.13,2.13,2
+
If a player fires out of line, they will be blocked from firing again for a default duration of 2 seconds. You can change this value via this command:<pre>fol_fire_block_duration <value></pre>
mod_variable autoadmin:Carpenter:Arty,15,20,1
 
mod_variable autoadmin:Carpenter:Cav,15,20,1
 
</pre>
 
  
If a casualty occurs in the line, a “ghost” collider is placed where the player died. This will prevent people from being called out for FOL due to a casualty. The time the ghost exists for can be changed by the variable “timeToExist” (in seconds).
 
{| class="wikitable"
 
|+
 
!Variable Name
 
!Description
 
!Argument
 
!Default
 
|-
 
|timeToExist
 
|The time in seconds that a player is still considered valid after being killed.
 
|float
 
|1 (s)
 
|}
 
  
 +
When a player dies, a temporary "ghost" will spawn in their place so that the line doesn't immediately break. The default ghost lifetime is 3 seconds. You can change this via this command:<pre>fol_ghost_duration <value></pre>
 
== All Charge ==
 
== All Charge ==
 
{| class="wikitable"
 
{| class="wikitable"

Revision as of 13:43, 22 March 2024

Unless stated otherwise, all server config commands listed in this page are global rotation commands, which means that they can either be placed inside a map rotation to apply to that rotation only, or else before the map rotations section to apply to all map rotations.

Ray-Gun System

When logged in as admin, you can access the ray gun by looking (in free roam or spawned in) at a player and hitting Alt + Q. If a player is found in the direction you are looking, then the player information panel will open up giving fast access to message, revive, slay and slap. These can be accessed via the number keys (1,2,3,4).

Artillery Priority System

This panel allows admins to see who has claimed artillery pieces. Artillery can only be claimed by a cannoneer or a sapper. This can be disabled by:

mod_variable autoadmin:ArtilleryPrioritySystemEnabled:false

Fire Out Of Line

Fire Out Of Line only allows shooting firearms while players are within a line. To enable it, use:

fol_enabled true

There are 4 different settings that you can set either globally or per player class.

FOL Class Settings
Setting Name Description Default Value
radius The farthest distance (in metres) a player can be from a player line in order to be considered part of the line. 1.5 (m)
mounted_radius Same as "radius" but only relevant while the player is mounted on a horse. 25 (m)
artillery_radius If a player is within this distance to an artillery piece, they can fire even if not within a line. 0 (disabled)
players_needed The minimum number of players needed - including the local player - to form a valid line. 3

Some classes have specific default value overrides, listed here:

FOL Class Default Overrides
Class Setting Override Value
Light Infantry radius 5
Rifleman radius 5
Cannoneer artillery_radius 15
Rocketeer artillery_radius 15
Sapper artillery_radius 15

To override the defaults for all classes with your own values, use:

fol_default <FOLSettingName> <value>

You can also override any default value for any specific class. To do this, use:

fol_class <PlayerClass> <FOLSettingName> <value>

If a player fires out of line, they will be blocked from firing again for a default duration of 2 seconds. You can change this value via this command:

fol_fire_block_duration <value>


When a player dies, a temporary "ghost" will spawn in their place so that the line doesn't immediately break. The default ghost lifetime is 3 seconds. You can change this via this command:

fol_ghost_duration <value>

All Charge

Config Command Description Arguments Default
allChargeVisableWarning The amount warning time given to players before an all charge. Eg if an all charge would be triggered for 10:00, then a 30 second warning means the broadcast will occur at 10:30 letting them know. int 30 (s)
allChargeTimeTrigger In an all charge mode which considers time, when this time is reached, all charge will be called. Eg setting it to 600 will call all charge at 10:00. int 360 (s)
allChargeTriggerDelay The time between a percentage-based trigger and when its called. Eg the percentage-based trigger is met at 11:00, the game will then wait this time before announcing all charge. Eg 11:00 trigger, 10:30 announcement, 10:00 activation. int 30 (s)
minimumNumbersOfPlayers Minimum number of players on the server to trigger a percentage based all charge. int 15
allChargeMinPercentageAlive When the round goes below this value of current players alive compared to the amount spawned, then an all charge will be called if using a percentage based automatic all charge trigger float 0.52
allChargeMessage The message sent when calling an all charge string All charge! Cavalry dismount. Weapon and Artillery Firing is disabled!
Mode Description
None Auto admin will not call all charge automatically (default state).
TimeOnly When the time set in allChargeTimeTrigger is reached, all charge will be called. Will give a warning in advance up to the number of seconds set in allChargeVisableWarningTime
PercentageOnly When the number of players alive on the server is lower than this percentage, all charge will be called. Must have at least minimumNumbersOfPlayers connected to the server or will not call all charge.
TimePercentageConstant Will have percentage and time conditions. If either condition are met will call all charge. Therefore will use percentage based unless the round goes on for a while where it will call it based on time. This is recommended setting for automatic all charge.

Artillery Settings

Config Command Description Arguments Default
ArtilleryLiveTimer If set, then will automatically enable artillery firing at this time (in seconds). This is easier than manually putting "rc delayed XX set allowArtyFiring" in your config for every rotation. int -1
ArtyOnArtyTime The time (in seconds) for when Arty on Arty is live. If an Arty on Arty shot is detected before this time, a broadcast message will be posted notifying the admin who shot the cannon. int 3600
ArtilleryPrioritySystemEnabled Determines if the game will record and show via the F5 menu who claimed an artillery piece first. Most useful public servers. bool true
CannonClaimedMessage This is the message messaged to players after they claim an artillery piece string You have claimed the Artillery piece and have priority while you remain using it. If someone else takes control of it, then type in recruitment chat to notify an admin