Difference between revisions of "Remote Console Commands"

From Holdfast: Nations At War
Jump to navigation Jump to search
m (Minor edit to standardise argument notation for the login command)
m (Updated post reviewer feedback)
Line 1: Line 1:
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, the below are the more commonly used and useful ones.
+
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==
 
==Using The Console==
 
===Logging In As Admin===
 
===Logging In As Admin===
All commands will require login with the admin password first (see [[Server Hosting#Basic Configuration & Starting the Server|Server Hosting]] for how to set the <code>server_admin_password</code>).  You only need to log on once per session (i.e. each time you reconnect to a server, but not on map rotation).
+
All commands will require login with the admin password first (see [[Server Hosting#Basic Configuration & Starting the Server|Server Hosting]] for how to set the <code>server_admin_password</code>).  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.
 
<pre>
 
<pre>
 
rc login <server_admin_password>
 
rc login <server_admin_password>
Line 10: Line 10:
  
 
===Sending Remote Commands===
 
===Sending Remote Commands===
All commands  are prefixed with <code>rc </code> to distinguish them from console commands that run on your local game only.  For example, <code>rc help</code> prints the list of rc commands and some descriptive help text.
+
All commands  are prefixed with <code>rc </code> to distinguish them from console commands that run on your local game only.  For example, <code>rc help</code> prints the list of rc commands and some descriptive help text.  If you just type <code>help</code> you would only get the ''local'' console commands rather than the remote commands.
  
The console also has tab completion for most commands (if not all arguments).  This means that you can type a partial command, hit <code>Tab</code>, 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.
+
The console also has auto completion by pressing <code>Tab</code> for most commands (if not all arguments).  This means that you can type a partial command, hit <code>Tab</code>, 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:''
 
''Examples:''
Line 19: Line 19:
  
 
==Console Commands==
 
==Console Commands==
Some commands take arguments that determine how they behave.  The command for God Mode takes an argument of either <code>true</code> or <code>false</code> to switch it on or off. Where commands take arguments, they will be contained in angle brackets (<code><argument></code>).  In some cases, arguments are optional.  These will be surrounded by square brackets (<code>[<optionalArgument>]</code>).  Where more than one optional argument is available, all arguments up to the desired argument must be given.
+
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.
 +
 
 +
<code>rc set characterGodMode true</code>   Enables god mode, the argument is ''true''.
 +
 
 +
<code>rc set characterGodMode false</code> Disables god mode, the argument is ''false''.  
 +
 
 +
Where commands take arguments, they will be listed in angle brackets (<code><argument></code>).  In some cases, arguments are optional.  These will be surrounded by square brackets (<code>[<optionalArgument>]</code>).  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 <code>rc command <argument1> [<optional1>] [<optional2>] [<optional3>]</code>, to use <code><optional2></code>, we must also provide <code><optional1></code>.
 
e.g. For a command of the form <code>rc command <argument1> [<optional1>] [<optional2>] [<optional3>]</code>, to use <code><optional2></code>, we must also provide <code><optional1></code>.
 
Arguments will be listed in the form <code>''argument'' (type): description</code>, 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:
 
Arguments will be listed in the form <code>''argument'' (type): description</code>, 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:

Revision as of 18:29, 6 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.

Top Level Commands

Command Description Arguments
rc help [<command>] Display help text about console commands command (String): Optionally provide another command name to get further help on that specific command. e.g. rc help get
broadcast <message> Send an admin message to all players on the server (can also be done in Admin chat with /bc <message>) 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. 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 [<argument>] Fetches the value of a server setting (or all values if no argument provided). See Configuration Variables argument (List): See Configuration Variables
mapRotation <index> Switches to the map configuration specified in the Server Configuration file. 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. 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

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. 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.

PAGE UNDER CONSTRUCTION

Configuration Variables

Game Settings

Character Movement

Weapons

Artillery

Nature Settings

Bot Commands

Naval

Admin Controls