Difference between revisions of "Remote Console Commands"

From Holdfast: Nations At War
Jump to navigation Jump to search
m (Finished bot section)
m (Added the emplacement limit function)
Line 139: Line 139:
  
 
''z'' (Integer): The Z co-ordinate in space for the teleport.
 
''z'' (Integer): The Z co-ordinate in space for the teleport.
 +
|-
 +
| emplacementLimit <emplacement> <side> <limit>
 +
| Sets the number of emplacements of a particular type that are buildable for each team
 +
| ''emplacement'' (List): An [[Server_Configuration_Enums#Emplacement Type|Emplacement Type]]
 +
 +
''side'' (List): Either ''attacking'' or ''defending''
 +
 +
''limit'' (Integer): The limit to set
 +
 
|}
 
|}
 
'''PAGE UNDER CONSTRUCTION'''
 
  
 
===Configuration Variables===
 
===Configuration Variables===

Revision as of 13:56, 12 July 2019

This guide covers settings that can be reached through the in-game console (bound to F1 by default). While there are more console commands possible, these are the most commonly used and useful ones.

Using The Console

Logging In As Admin

All commands will require login with the admin password first (see Server Hosting for how to set the server_admin_password). You only need to log on once per session (i.e. each time you reconnect to a server, but not on map rotation). The command to login is below and is case sensitive.

rc login <server_admin_password>

If you don’t see any console output confirming the login, hit F1 a couple of times to close and reopen the console.

Sending Remote Commands

All commands are prefixed with rc to distinguish them from console commands that run on your local game only. For example, rc help prints the list of rc commands and some descriptive help text. If you just type help you would only get the local console commands rather than the remote commands.

The console also has auto completion by pressing Tab for most commands (if not all arguments). This means that you can type a partial command, hit Tab, and it will complete the rest of the command up to the point where there is no ambiguity. This is handy if you can only remember the start of the command, or to correct the case used for commands as the console is case sensitive.

Examples:

  1. Typing rc set drawFir and pressing Tab will automatically expand the command to read rc set drawFirearmTrajectories
  2. Typing rc carbonPlayers force and pressing Tab will automatically expand the command to read rc carbonPlayers forceInput as it cannot choose between forceInputRotation or forceInputAxis.

Console Commands

Some commands take arguments that determine how they behave. You've already seen one example of this - the server_admin_password above is an argument to the login command. Another would be setting God Mode on the servers.

rc set characterGodMode true Enables god mode, the argument is true.

rc set characterGodMode false Disables god mode, the argument is false.

Where commands take arguments, they will be listed in angle brackets (<argument>). In some cases, arguments are optional. These will be surrounded by square brackets ([<optionalArgument>]). Where more than one optional argument is available, all arguments up to the desired argument must be given.

e.g. For a command of the form rc command <argument1> [<optional1>] [<optional2>] [<optional3>], to use <optional2>, we must also provide <optional1>. Arguments will be listed in the form argument (type): description, where argument is the name of the argument, type indicates the form the argument takes, and finally a description of the argument. Possible types of argument are:

String: Any amount of text
Boolean: true or false
Integer: A non-floating point number (i.e. no decimals)
Float: A floating point number (i.e. has decimals)
List: A specific list of options that will be provided (e.g. faction choices of British, Prussian, or French)

Notes:

  • Some arguments will require numbers representing a position or rotation. These can be worked out in game by typing get in the console to give the current player's position and rotation.
  • Some arguments will require the ID of a player. This is visible in the Admin/Mute Players Window (reached by pressing P by default), or by using the command rc playerlist.
  • All remote commands can be added into your Server Configuration file for each map rotation, so you can automatically run commands when the map is selected. For example, you may want to always spawn 100 bots on a certain map for training purposes.

Top Level Commands

Command Description Arguments
help [<command>] Display help text about console commands

e.g. rc help get

command (String): Optionally provide another command name to get further help on that specific command.
broadcast <message> Send an admin message to all players on the server (can also be done in Admin chat with /bc <message>)

e.g. rc broadcast Live at 18:30

message (String): The text you want to broadcast. Subsequent calls to this will immediately replace the current message.
carbonPlayers <command> [<arguments>] Bot controls. For more details see the section on Bot Commands See the section on Bot Commands
cls Clear the console. Useful if you're recording and want to clear your admin password before starting. N/A
fileReloader <fileType> Allows reloading of server configuration files without a server reboot. Useful for refreshing ban lists or tweaking map rotations.

e.g. rc fileReloader serverConfigFile

fileType (List): One of the following options.
  • serverConfigFile: The Server Configuration file
  • blackWhiteLists: The blacklist / whitelist
  • bannedPlayers: Banned players file
  • bannedMachines: Banned machines file
  • mutePlayersVoip: The VOIP muted players file
  • mutePlayersChat: The chat muted players file
  • all: Loads all but the Server Configuration.
get [<variable>] Fetches the value of a server setting (or all values if no variable provided). See Configuration Variables

e.g. rc get characterGodMode

variable (List): See Configuration Variables
mapRotation <index> Switches to the map configuration specified in the Server Configuration file.

e.g. rc mapRotation 1

index (Integer): The number of the rotation to switch to. The first in the file is 1, the second 2, etc.
playerlist List the players connected to the server N/A
scorelog Prints out a score log including a list of who killed who N/A
serverAdmin <command> <ID> Server admin commands. All generally accessible through the in-game "P" menu.

e.g. rc serverAdmin slay 14

command (List): One of the following commands.
  • ban
  • kick
  • chatMute
  • chatUnmute
  • voipMute
  • voipUnmute
  • permChatMute
  • permVoipMute
  • slay

ID (Integer): The ID of the player to affect

set <variable> <value> Sets the value of a server setting. See Configuration Variables

e.g. rc set characterGodMode true

variable (List): See Configuration Variables

value (?): The value and its type will depend on the variable used.

teleport <ID> <x> <y> <z> Teleports a specified player to a point on the map. Note that this does not currently take floating point arguments, limiting the accuracy to the nearest metre.

e.g. rc teleport 14 200 10 435

ID (Integer): The ID of the player

x (Integer): The X co-ordinate in space for the teleport.

y (Integer): The Y co-ordinate in space for the teleport. Positions the player vertically, so try to drop them gently!

z (Integer): The Z co-ordinate in space for the teleport.

emplacementLimit <emplacement> <side> <limit> Sets the number of emplacements of a particular type that are buildable for each team emplacement (List): An Emplacement Type

side (List): Either attacking or defending

limit (Integer): The limit to set

Configuration Variables

There are a number of server-side variables that can be tweaked which affect how the game behaves. These generally carry over between map rotations, so once they're set they can only be reset manually or by restarting the server. A recommendation for server owners would be to add the appropriate commands to set defaults into their starter map rotation (such as Training Grounds) so that they can restore the settings without a restart. See Server Configuration for how to do this.

Typing rc get will list the full set of variables and their current values. The ones listed below are those likely to be of use to server admins.

Game Settings

Command Description Arguments Default
characterGodMode <enable> GOD MODE for all characters enable (Boolean): true to enable, false to disable false
allowFriendlyDamageDefences <enable> If enabled, friendly players may destroy the emplacements created by their own faction enable (Boolean): true to enable, false to disable false
characterFallDamageEnabled <enable> Toggles players' fall damage enable (Boolean): true to enable, false to disable true
drawCannonPathTrajectories <enable> Draw Cannon Path Trajectories enable (Boolean): true to enable, false to disable false
drawFirearmTrajectories <enable> Broadcasts debug info to the clients when a player shoots a firearm. If you want to clear existing trajectories, get people to shoot into the ground in first person (i.e. bury the trajectories) before turning off. enable (Boolean): true to enable, false to disable false
broadcastMeleeDebugDataStrikeInfo <enable> Broadcasts hit info for the melee debug data to debug melee strikes enable (Boolean): true to enable, false to disable false
allowPreviewAnimations <enable> Allows usage of the preview animations on the clients (dance, etc...) enable (Boolean): true to enable, false to disable false
lanternsAsProjectiles <enable> Allows usage of hand held lanterns as artillery projectiles enable (Boolean): true to enable, false to disable false
maxDistanceAllowedForHealing <distance> Specifies the max distance for surgeon heals distance (Float): The healing distance 2
fullPlayerHealingProcessTime Specifies the full time in seconds for a full healing process to finish time (Float): The time in seconds 10
freeflightCameraAllowed <enable> Determines whether the clients can use the freeflight camera. DOES NOT APPEAR TO WORK enable (Boolean): true to enable, false to disable false
voiceChatEnabled <enable> Specifies whether voice chat is enabled or not enable (Boolean): true to enable, false to disable true
voiceChat3D <enable> Specifies the spatial settings of the Voice Chat players enable (Boolean): true to enable, false to disable true
attackingFactionMaterialPoints <materials> Set the material points for the attacking faction (for Sapper building) materials (Integer): The number of materials to assign 50
defendingFactionMaterialPoints <materials> Set the material points for the defending faction (for Sapper building) materials (Integer): The number of materials to assign 50
spawnSectionsCapturable <enable> Toggles the ability to make spawn capture points capturable enable (Boolean): true to enable, false to disable true
autoWeatherRotation <enable> Specifies whether the server switches the weather automatically at random intervals enable (Boolean): true to enable, false to disable false
characterRespawnTime Instructs the clients to change the respawn time. If lower than 5 may still show a 5s progress bar. time (Float): The time in seconds 5
explosionScaleMultiplier <multiplier> Specifies the explosion scale multiplier multiplier (Float): A multiplier value 1
ragdollForceMultiplier <multiplier> Specifies the ragdoll effects multiplier multiplier (Float): A multiplier value 1

Character Movement

Command Description Arguments Default
characterJumpForce <force> The jump force of the characters force (Float): A multiplier value 1
characterRunSpeed <multiplier> The run speed of the characters (multiplies with below options) multiplier (Float): A multiplier value 1
characterRunForwardSpeed <multiplier> The forward run speed of the characters multiplier (Float): A multiplier value 1
characterRunStrafeSpeed <multiplier> The strafe run speed of the characters multiplier (Float): A multiplier value 1
characterRunBackwardsSpeed <multiplier> The backwards run speed of the characters multiplier (Float): A multiplier value 1
characterWalkSpeed <multiplier> The walk speed of the characters (multiplies with below options). This will also apply when walking while holding objects (e.g. ammo boxes) multiplier (Float): A multiplier value 1
characterWalkForwardSpeed <multiplier> The forward walk speed of the characters multiplier (Float): A multiplier value 1
characterWalkStrafeSpeed <multiplier> The strafe walk speed of the characters multiplier (Float): A multiplier value 1
characterWalkBackwardsSpeed <multiplier> The backwards walk speed of the characters multiplier (Float): A multiplier value 1
ladderMoverSpeedMultiplier <multiplier> Multiplies ladder mover speed multiplier (Float): A multiplier value 1
ladderMoverRotationMultiplier <multiplier> Multiplies ladder mover rotation multiplier (Float): A multiplier value 1
rocketMoverSpeedMultiplier <multiplier> Multiplies rocket mover speed multiplier (Float): A multiplier value 1
rocketMoverRotationMultiplier <multiplier> Multiplies rocket mover rotation multiplier (Float): A multiplier value 1

Weapons

Command Description Arguments Default
characterInfiniteFirearmAmmo <enable> Toggles infinite firearm ammo for testing purposes enable (Boolean): true to enable, false to disable false
characterWeaponDamageScale <scale> Sets the scale of the damage that weapons do (NOT CURRENTLY WORKING) scale (Float): A multiplier value 1
characterWeaponApplyHorizontalDeviation <enable> Specifies whether the firearm weapons apply horizontal deviation enable (Boolean): true to enable, false to disable true
characterWeaponFirearmApplyDrop <enable> Specifies whether hand weapons can damage DamageableObjects (does not appear to be implemented) enable (Boolean): true to enable, false to disable true
characterMeleeBlockStunTime The duration of a melee block stun time (Float): The time in seconds 0.8
characterMeleeHitOpponentStunTime The duration of a melee hit stun time (Float): The time in seconds 0.35
characterMeleeInterruptedStunTime The duration of a melee interrupted stun time (Float): The time in seconds 0.4
characterMaimedTime The duration of a maim time (Float): The time in seconds 0.45
meleeChambering <enable> Toggles melee chambering enable (Boolean): true to enable, false to disable true

Artillery

Command Description Arguments Default
cannonsBypassFiringInterval <enable> Specifies whether the cannons should bypass their firing interval (for fun) enable (Boolean): true to enable, false to disable false
cannonMoverSpeedMultiplier <multiplier> Multiplies cannon mover speed. Note this will also affect cannon recoil! multiplier (Float): A multiplier value 1
cannonMoverRotationMultiplier <multiplier> Multiplies cannon mover rotation multiplier (Float): A multiplier value 1
allowAmmoSelectorUIDebugShow <enable> Allows players to use the debugging ammo selector panel. This is bound to O by default and will open an instant artillery ammo selection panel. enable (Boolean): true to enable, false to disable false
pathProjectileVelocity <value> Sets the path velocity of the rocket projectile with given input value (Float): Value to set 145
rocketProjectileVelocity <value> Sets the velocity of the rocket projectile with given input value (Float): Value to set 22
rocketProjectileGravity <value> Change gravity of the rocket value (Float): Value to set 40
rocketProjectileDamageRadius <value> The radius of the rocket projectile's impact value (Float): Value to set 3
rocketProjectileRandomizedInterval <value> The frequency of random positioning of the projectile in seconds value (Float): Value to set 2
rocketProjectileDeviation <value> Set a positive value that can be used to randomize the flight deviation value (Float): Value to set 5
mortarProjectileDamageRadius <value> Set a positive value that can be used for mortar aoe damage value (Float): Value to set 3.5
mortarProjectileVelocity <value> Set a positive value that can be used for mortar projectile velocity value (Float): Value to set 60
artyProjectileBounceSpeedReduction <value> Set a positive value that can be used for bounce slowdowns value (Float): Value to set 0.666

Naval

Command Description Arguments Default
shipDrivingFieldsScale <scale> Specifies the scale of the fields that are used when driving ships scale (Float): A multiplier value 1
shipFlyMode <enable> Ship fly mode… enable (Boolean): true to enable, false to disable false
windDirectionAffectsShipSpeed <enable> Specifies whether the wind direction affects the speed of the ships enable (Boolean): true to enable, false to disable true
rowboatSpawnHoldInteractionTime Rowboat spawning action duration time (Float): The time in seconds 5
rowboatSpawnHoldInteractionTimeWhileSinking Rowboat spawning action duration while sinking time (Float): The time in seconds 0.5
rowboatCooldownBetweenSpawns Rowboat spawning delay between spawns time (Float): The time in seconds 120
rowboatCooldownBetweenSpawnsWhileSinking Rowboat spawning delay between spawns while sinking time (Float): The time in seconds 5
shipSailWindUnitMultiplier <multiplier> Wind affect potency on the sails multiplier multiplier (Float): A multiplier value 1
renderOcean <enable> Toggles the ocean rendering enable (Boolean): true to enable, false to disable true

Nature Settings

These settings will allow you to change the time of day and weather of the current map.

Time

These commands should be prefixed with rc nature time.

e.g. To enable dynamic time, rc nature time dynamicTime true

Command Description Arguments
timeOfDay Sets the time of day to the specified hour time (Float): The hour in a 24 hour clock. i.e. 12 is midday, 23 is 11pm midnight
dynamicTime <enable> Enabled dynamic time enable (boolean): true to enable, false to disable
dynamicTimeSpeed <speed> Sets the rate of change of dynamic time speed (Float): Looks to be a scale of hours per second. Set it to 12 and watch night turn into day into night into day ...

Weather

These commands should be prefixed with rc nature weather.

e.g. To set the wind direction to North, rc nature weather wind direction North

Command Description Arguments
preset <name> [<transitionTime>] Set the weather to one of the defined presets name (List): The name of the preset to select from the list here

transitionTime (Float): The length of time in s for the change to happen over (defaults to 1s)

wind strength <value> Set the strength of the wind Z value (Float): The wind strength to set
wind direction <value> Set the direction of the wind Z value (List): One of North, NorthEast, East, SouthEast, South, SouthWest, West, NorthWest
atmosphere temperature <value> Set the temperature. Affects snow cover on ground and type of precipitation (snow, rain) value (Float): Degrees
atmosphere fallIntensity <value> Set the rainfall intensity value (Float): A range between 0 and 1
fog enabled <enable> Toggle fog on the map enable (boolean): true to enable, false to disable
fog visibility <value> The level of visibility in fog. The larger the number, the thinner the fog. value (Float): Visibility in m
ocean choppinesss <value> Ocean choppiness value (Float): The rollin' of the ocean
ocean depth <value> Ocean depth value (Float): How low can you go
Weather Presets
  • Custom
  • Calm
  • Storm
  • Fog
  • Snowy
  • CalmRain
  • Calm2
  • Calm3
  • Calm4
  • Fog2
  • Fog3
  • Random

Bot Commands

Holdfast has some fairly dumb bots. While they won't put up a fight, they are useful for testing ranges, or just satisfying your need to kill. All commands are prefixed with rc carbonPlayers . Note that most commands apply to all bots, except where a bot could literally not follow the command (non-flagbearers switching to a BearingFlag for example).

e.g. To spawn 50 bots you would issue the command rc carbonPlayers spawn 50.

Command Description Arguments
spawn <number> [<interval>] Spawn a number of bots on the server. Bots spawn (and respawn) as random classes and factions distributed across spawn points. number (Integer): The number of bots to spawn

interval (Integer): Seconds between each spawn. Defaults to 0.

disperse Randomly disperse bots over the map N/A
join Join all of the bots in the centre of the map N/A
forceInputAxis <enable> Toggles whether the bots shuffle around randomly, or respond to the value set by inputAxis enable (boolean): true to enable, false to disable
forceInputRotation <enable> Toggles whether the bots spin around randomly, or respond to the value set by inputRotation enable (boolean): true to enable, false to disable
inputAxis <sideways> <forwards> Sets the movement inputs for ALL bots sideways (Float): The amount of strafe input in the range -1 to +1. Positive is to the right.

forwards (Float): The amount of forward/backward input in the range -1 to +1. Positive is forwards.

inputRotation <rotation> Sets the direction for ALL bots to face direction (Float): The direction in degrees taken from North. i.e. 90 is East, 180 South, etc.
playerAction <action> Tells all bots to take a certain action action (List): See the list of actions.
switchWeapon [<weapon>] Tell all bots to switch to this weapon (if they have it in their loadout) weapon (List): See the list of weapons. With no argument will switch between fists and firearm.
voicePhrase <phrase> Bots will should this phrase phrase (List): See the list of voice phrases.
voicePhraseRandom Bots will each shout a random phrase N/A
meleeAttack <attack> Bots will do the specified melee attack (if holding a melee weapon). attack (List): One of MeleeStrikeHigh, MeleeStrikeLow, MeleeStrikeLeft, MeleeStrikeRight
Bot Actions
Action Description
ShipAutoMove
Jump
StartAimingFirearm
StopAimingFirearm
FireFirearm
FireCannon
Driveship
Run
Crouch
PlayerAutoWalk
SwitchWeapon
StartReloadFirearm
InterruptReloadFirearm
FinishReloadFirearm
EnableCombatStance
DisableCombatStance
StartMeleeWeaponHold
StopMeleeWeaponHold
ExecuteMeleeWeaponStrike
MeleeStrikeHigh
MeleeStrikeLow
MeleeStrikeLeft
MeleeStrikeRight
Action Description
StartMeleeBlock
StopMeleeBlock
ChangeMeleeBlock
MeleeBlockHigh
MeleeBlockLow
MeleeBlockLeft
MeleeBlockRight
FireDryFirearm
StartCrouching
StopCrouching
StopPreviewAnimation
Dance_GanGamStyle
Dance_HipHop
Dance_Thriller
PreviewAnim_Dance_Belly
PreviewAnim_MusketKick
PreviewAnim_MusketCrouch
PreviewAnim_Instrument_Bass
PreviewAnim_Instrument_Guitar
PreviewAnim_Instrument_Drums
PreviewAnim_Salute
PreviewAnim_Pointing
PreviewAnim_LookingHorizon
PreviewAnim_MaleLayingDownPose

Naval

Command Description Arguments
shipList