Changes between Version 22 and Version 23 of Console Commands


Ignore:
Timestamp:
Apr 18, 2015, 3:31:42 PM (10 years ago)
Author:
Christian Illy
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Console Commands

    v22 v23  
    99== admins.xml and in game console ==
    1010
    11 === Unmodified server code ===
    12 Each command has to have a permission level set in ''admins.xml'' and the player who wants to use the command must have the appropriate level, i.e. the permission level of the player must be lower or equal to the permission level of the command to be executed. All commands that are not defined in the ''admins.xml'' can not be executed at all.
     11* Any player not given a specific permission level in ''admins.xml'' will have a default level of 1000
     12* A command with permission level of >=1000 can be executed by '''any''' player that is either defined with a permission level of <=1000, even those not listed in the ''admins.xml'' at all
     13* Any command not having an permission level set in ''admins.xml'' will automatically have a permission level of 0
     14* Commands defined in the ''admins.xml'' affect both short and long versions
    1315
    1416'''Example:'''
    … …  
    3840  * ''mem'' -> ok
    3941  * ''admin'' -> ok
    40   * ''sg'' (which is the short version of ''setgameprefs'') -> denied (not in list exactly like this)
    41   * ''shutdown'' -> denied (not in list at all)
    42 * Player with ID 987654 (permission level 4):
    43   * ''dm'' -> denied (dm requires permission level of 3 or less)
    44   * ''mem'' -> ok
    45   * ''kick'' -> ok
    46   * ''le'' -> ok
    47 * Any other player with no defined permission level:
    48   * ''le'' -> denied (permission level 1000 is just an arbitrary number)
    49   * any other command -> denied
    50 
    51 
    52 === Running a server with the [[Server fixes]] installed ===
    53 
    54 Mostly the same applies as without the fixes. Changes are:
    55 * A command with permission level of >=1000 can be executed by '''any''' player, even those not listed in the ''admins.xml'' at all
    56 * Any command not having an permission level set in ''admins.xml'' will automatically have a permission level of 0
    57 * Commands defined in the ''admins.xml'' affect both short and long versions
    58 
    59 '''Example:'''
    60 Considering the same ''admins.xml'' as before:
    61 * Player with ID 123456 (permission level 0):
    62   * ''dm'' -> ok
    63   * ''mem'' -> ok
    64   * ''admin'' -> ok
    6542  * ''sg'' (which is the short version of ''setgameprefs'') -> '''ok''' (''setgameprefs'' is defined so it also affects ''sg'')
    6643  * ''shutdown'' -> '''ok''' (implicitly defined as permission level 0)
    … …  
    8057These are:
    8158* admin: Manage the list of players which should be admins
    82 * mod: Same for moderators. As it seems there currently is no difference between moderators and admins. Only the permission level set is of interest.
    8359* cp: Manage command permission level definitions (in the XML those are the ''permissions''->''permission''-elements)
    8460* whitelist: Whitelisted players. '''Note:''' if there is at least one whitelisted player '''only''' players on this list can join the server whatsoever.
    8561* ban: Ban a player (XML: ''blacklist'' elements)
    8662
    87 All but the ''ban'' command have three subcommands given as their first parameter:
    88 * add: Add a player to the given list
     63All commands have three subcommands given as their first parameter:
     64* add: Add/update a player/command to/on the given list
    8965* remove: Remove a player from the given list
    90 * update: Set a new permission level on the given list for the given player
     66* list: List all currently defined entries
    9167
    9268
    … …  
    9672|| admin add || <playername> <permissionLevel> || Add a player as admin with the given permissionlevel ||
    9773|| admin remove || <playername> || Remove the admin rights of a player ||
    98 || admin update || <playername> <permissionLevel> || Set a new permissionlevel for a player who is already an admin ||
    9974|| aiddebug || || Toggles AIDirector debug output ||
    10075|| ban || <playername> <duration> <unit> || Bans user for period specified by ''duration'' and ''unit''. ''Unit'' can be anything of: ''minutes'', ''hours'', ''days'', ''weeks'', ''months'', ''years'' ||
    … …  
    10479|| cp add || <command> <permissionLevel> || Add the definition of a permission level for a given command ||
    10580|| cp remove || <command> || Remove the command permission level definition ||
    106 || cp update || <playername> <permissionLevel> || Set a new permissionlevel for an already defined command ||
    107 || creativemenu, cm || <0/1> || Disable/Enable the creative menu for the current server session (Added by the [[Server fixes]]) ||
     81|| creativemenu, cm || <0/1> || Disable/Enable the creative menu for the local player ||
    10882|| debuff || <buffName> || Removes a buff from the local player ||
    10983|| debugmenu, dm || || Enables/disables debug menu for a client ||
    … …  
    11185|| gameover, go || || Sets the game state to GameOver ||
    11286|| generatemap, gm || || Generates a 2D map image of the current world. ||
    113 || getgamepref, gg || [<match>] || Get all preferences that contain the given string or all preferences if no string is given (Added by the [[Server fixes]]) ||
    114 || gettime, gt || || Retrieves current ingame time (Added by the [[Server fixes]]) ||
     87|| getgamepref, gg || [<match>] || Get all preferences that contain the given string or all preferences if no string is given ||
     88|| gettime, gt || || Retrieves current ingame time ||
    11589|| give || <playername|entityid> <itemname> <amount> || Give an item to a player (check for possible item names with ''listitems'') (Added by the [[Server fixes]]) ||
    11690|| kick || <playername> [<reason>] || Kicks user with optional reason ||
    117 || kill || <playername or entityId> || Kill the given player (Added by the [[Server fixes]]) ||
     91|| kill || <playername or entityId> || Kill the given player ||
    11892|| listents, le || || List all entities ||
    11993|| listitems, li || <searchString> || List all items that can be given with ''give'' that match contain the ''searchString'' (Added by the [[Server fixes]]) ||
    … …  
    12195|| listlandprotection, llp || nearby [<entityid>] || ^INGAME ONLY^ Lists all land protection blocks and their owners that are placed near the current player. Default distance is 32 in both x and z. Can optionally be passed another distance (Added by the [[Server fixes]]) ||
    12296|| listlandprotection, llp || [summary | <steamid> | <entityid> | <playername>] || Lists all land protection blocks and their owners. If ''summary'' is passed it only shows the number of keystones per player, if any of the other is passed it only shows the keystones of the given player (Added by the [[Server fixes]]) ||
    123 || listplayersextended, lpe || || Lists all players with extended attributes (Added by the [[Server fixes]]) ||
    12497|| listplayers, lp || || List all players ||
    12598|| listthreads, lt || || Lists all game threads ||
    12699|| mem || || Print information about current memory consumption of the server and call garbage collector ||
    127 || mod add || <playername> <permissionLevel> || Add a player as moderator with the given permissionlevel ||
    128 || mod remove || <playername> || Remove the moderator rights of a player ||
    129 || mod update || <playername> <permissionLevel> || Set a new permissionlevel for a player who is already a moderator ||
    130100|| removelandprotection, rlp || <steamid>  OR  <x> <y> <z> || Removes the given land protection block or all blocks of a given player. Note that the chunk which contains the keystones has to be loaded at that moment (i.e. get close to the keystones before executing this command) (Added by the [[Server fixes]]) ||
    131101|| rendermap, rm || || Render the map as far as it was visited by players (Added by the [[Server fixes]]) '''READ INFORMATION ON THIS ON THE SERVER FIXES PAGE! ||
    … …  
    135105|| sayplayer, pm || <playerName or entityId> <message> || Send a message to a single player (Added by the [[Server fixes]]) ||
    136106|| setgamepref, sg || [<prefName> [<value>]] || Retrieves (if no value given) or sets a game preference. If both parameters are left out all preferences are shown. Does not work with most settings! ||
    137 || settimereal, str || <days> <hours> <minutes> || Set current ingame time (Added by the [[Server fixes]]) ||
    138 || settime, st || [<time>] || Set the time. If no time is given it will set to Day 1, 08:00. ''time'' can be "day" which will set to Day 1, 16:00, or "night" which will set it to Day 2, 05:00. Or it can be an integer value greater or equal to -8000, specifying the time relative to Day 1, 16:00 ||
     107|| settime, st || [<time>] or <day> <hour> <minute> || Set the time. If no time is given it will set to Day 1, 08:00. ''time'' can be "day" which will set to Day 1, 16:00, or "night" which will set it to Day 2, 05:00. Or it can be a positive integer value, specifying the time relative to Day 1, 08:00 ||
    139108|| showchunkdata, sc || || Shows some data of the current chunk ||
    140109|| showinventory, si || <steamid or playerName or entityId> || List inventory of the given player (Added by the [[Server fixes]]) ||
    … …  
    148117|| spawnwanderinghorde || || Spawns a wandering horde of zombies ||
    149118|| teleportplayer, tele || <steamid or playerName or entityId> {<steamid or playerName or entityId> OR <x> <y> <z>} || Teleport the player to the given location or to the given player (Added by the [[Server fixes]]) ||
    150 || unban || <steamid> || Remove the ban for the given SteamID (Added by the [[Server fixes]]) ||
    151 || version || || Get the currently running version of the server fixes (Added by the [[Server fixes]]) ||
     119|| version || || Get the currently running version of the game and loaded mods ||
    152120|| whitelist add || <playername> <permissionLevel> || Add a player to the whitelist with the given level ||
    153121|| whitelist remove || <playername> || Remove a player from the whitelist ||
    154 || whitelist update || <playername> <permissionLevel> || Update the permission level of a player on the whitelist ||