Revision as of 14:31, 18 October 2013

What Is Shrubbot

Shrubbot is an invention of Ryan Mannion. Shrubbot is an admin system that identifies the admin leveled players from PunkBuster GUIDs without the need for passwords. Shrubbot is also very flexible and allows creating many different admin levels with entirely different command sets. ETPub tries to clone shrubbot as accurately as possible, both in user interface and in the shrubbot configuration file called "shrubbot.cfg". silEnT shrubbot is based on the work of the ETPub team. silEnT extends the functionality of the shrubbot where ever it is needed. Including user database that holds all the players that have visited the server. To access this database, new commands have been added to the original shrubbot command set. Some commands have been renamed to ease their use and so that they resemble commands from other ET mods that have advanced admin systems.

If you want to use shrubbot, the cvar g_dbDirectory must be set. If it is not set, the shrubbot will not be in use. If you want to edit the default levels, you must create or copy existing shrubbot.cfg file to the folder defined by g_dbDirectory setting. In case shrubbot command like !ban is used against a player and shrubbot.cfg file does not already exist, a new shrubbot.cfg file is created to store the needed data.

The created file will also have the default level settings written to it. This file can be freely edited by hand and then after !readconfig command has been issued, the changes take effect on the server.

Shrubbot Commands

!admintest

Prints out player's current shrubbot admin level in global chat. When the NAME or SLOT are added and the user has the right shrubbot permission, the level of another player will be shown. However, if the target has incognito shrubbot flag, then 0 level is displayed regardless who does !admintest on him/her.

Syntax: !admintest [NAME|SLOT]

Permission Flag: a

Requires g_tyranny: No

Minimum required version: 0.2.0

!aliases

Prints out player's stored aliases. Aliases are printed in the last seen first order.If there are more stored aliases then fit in one page, optional page parameter can be used to access different pages. The number of stored aliases depends of the g_dbMaxAliases cvar.

Syntax: !alises [NAME|SLOT]

Permission Flag: e

Requires g_tyranny: No

Minimum required version: 0.6.0

!ban

Kicks the player in slot number SLOT or with name containing NAME off the server and will not let them connect again for SECONDS seconds, or, if a modifier (m, h, d, or w) is used, a given amount of time. For example:

90 = 90 seconds

15m = 15 minutes

3h = 3 hours

5d = 5 days

1w = 1 week

Syntax: !ban (NAME|SLOT) (SECONDS|TIME_WITH_MODIFIER) REASON

Permission Flag: b

Requires g_tyranny: No

Minimum required version: 0.2.0

!baninfo

Shows detailed information of a ban in the ban list. Find the ban number with !showbans command.

Syntax: !baninfo (BAN NUMBER)

Permission Flag: e

Requires g_tyranny: No

Minimum required version: 0.3.0

!burn

Sets the player in slot number SLOT or with name containing NAME on fire. REASON will be center-printed to the victim.

Syntax: !burn (NAME|SLOT) [REASON]

Permission Flag: U

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!cancelvote

Makes a vote in progress fail.

Syntax: !cancelvote

Permission Flag: c

Requires g_tyranny: No

Minimum required version: 0.2.0

!country

Displays the country of the player. This command works only if GeoIP is enabled on server g_countryFlags

Syntax: !country

Permission Flag: i

Requires g_tyranny: No

Minimum required version: 0.8.0

!crazygravity

Enables random g_gravity changes with 30 second interval. If enabled, the crazy gravity is automatically disabled at map end.

Syntax: !crazygravity (ON|OFF)

Permission Flag: C

Requires g_tyranny: No

Minimum required version: 0.6.2

!crazyspeed

Enables random g_speed changes with 30 second interval. If enabled, the crazy speed is automatically disabled at map end.

Syntax: !crazyspeed (ON|OFF)

Permission Flag: C

Requires g_tyranny: No

Minimum required version: 0.6.2

!dewarn

Shows all the warnings of a user. When warning number is used, the warning with that number will be removed.

Syntax: !dewarn (NAME|SLOT) [WARNING#]

Permission Flag: R

Requires g_tyranny: No

Minimum required version: 0.2.0

!disorient

Turns the view upside down for the client in slot number SLOT or with name containing NAME. If REASON is specified it is printed to the client.

Syntax: !disorient (NAME|SLOT) [REASON]

Permission Flag: d

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!finger

Display the slot, partial guid, ip and clientversion of a player.

NOTE: This command should be available only to the highest server admins!

Syntax: !finger (NAME|SLOT)

Permission Flag: e

Requires g_tyranny: No

Minimum required version: 0.2.0

!freeze

Freezes the client in slot number SLOT or with name containing NAME. If no parameter is provided it freezes all players. Frozen player(s) cannot receive damage during this time. If REASON is specified it is printed to the client.

Syntax: !freeze [NAME|SLOT] [REASON]

Permission Flag: F

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!gib

Kills and gibs the player in slot number SLOT or with name containing NAME. If name is -1 or all or if no name is entered, everybody will be gibbed.

Syntax: !gib (NAME|SLOT|-1|all)

Permission Flag: g

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!giba

Kills and gibs all players.

Syntax: !giba

Permission Flag: Q

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!help

Lists all the available shrubbot commands. If COMMAND is given, then prints the help of that specific command. !help is always available to all clients.

Syntax: !help [COMMAND]

Permission Flag: None

Requires g_tyranny: No

Minimum required version: 0.2.0

!howfair

Prints a simple summary to everyone on the chat of team fairness based on player kill rating.

Syntax: !howfair

Permission Flag: I

Requires g_tyranny: No

Minimum required version: 0.2.0

!kick

Kicks the player in slot number SLOT or with name containing NAME off of the server. REASON is given to the client as the drop message. The client will be banned for 2 minutes.

Syntax: !kick (NAME|SLOT) REASON

Permission Flag: k

Requires g_tyranny: No

Minimum required version: 0.2.0

!levinfo

Lists all the details of the specific admin level. The listed information includes The name of the level, the greeting, the greeting sound path and the privilege flags for the level.

Syntax: !levinfo (Admin Level)

Permission Flag: s

Requires g_tyranny: No

Minimum required version: 0.5.2

!levlist

Lists all the admin levels loaded from the shrubbot.cfg.

Syntax: !levlist

Permission Flag: s

Requires g_tyranny: No

Minimum required version: 0.5.2

!list

Prints out a list of information about the connected players. The columns are:

slot number

team R=axis B=allies S=spectator C=connecting

first letter of fireteam name

admin level (and level name)

last 8 digits of guid

M if muted

W if warned

name

Syntax: !list

Permission Flag: i

Requires g_tyranny: No

Minimum required version: 0.2.0

!listteams

Prints out a list of statistical information about each team. This lists ends with ratings information based on how likely each team is to win the current map. The team with more points is LESS likely to win, therefore a good way to balance the teams is to join the team with more points, or move people to that team, until the points are about even.

Syntax: !listteams

Permission Flag: I

Requires g_tyranny: No

Minimum required version: 0.2.0

!lock

Locks the specified team. Recognized values are r=AXIS b=ALLIES s=SPECTATORS all=ALL.

Syntax: !lock (r|b|s|all)

Permission Flag: K

Requires g_tyranny: No

Minimum required version: 0.2.0

!lol

Makes all players drop grenades. If NAME or SLOT is provided only that player will drop grenades. GRENADES is the number of grenades to be dropped (default is 1, maximum is 16).

Syntax: !lol [NAME|SLOT] [GRENADES]

Permission Flag: x

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!mute

Mutes a player in a slot number SLOT or with a name containing NAME. TIME and REASON are optional. See !ban for more information on modifiers

Syntax: !mute (NAME|SLOT) [SECONDS|TIME_WITH_MODIFIER] REASON

Permission Flag: m

Requires g_tyranny: No

Minimum required version: 0.2.0

!news

Plays the map specific news audio to all players if it is available.

Syntax: !news

Permission Flag: W

Requires g_tyranny: No

Minimum required version: 0.2.0

!nextmap

Moves to the next map in campaign or in the objective cycle end game intermission is skipped. With mapvoting gametype it is possible to go to the intermission if g_mapVoteFlags flag 16 is set.

Syntax: !nextmap

Permission Flag: n

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog

0.4.0 The !nextmap will go to the intermission map voting when the gametype is set to 7 and the g_mapVoteFlags bitmask has flag 16 set.

!orient

Reverses the action of !disorient for the client in slot number SLOT or with name containing NAME.

Syntax: !orient (NAME|SLOT)

Permission Flag: d

Requires g_tryanny: Yes

Minimum required version: 0.2.0

!panzerwar

Enables panzerwar game mode. All the players will have their main weapon changed to panzerfaust.

Syntax: !panzerwar [on|off]

Permission Flag: q

Requires g_tyranny: No

Minimum required version: 0.2.0

!passvote

Makes a vote in progress pass.

Syntax: !passvote

Permission Flag: V

Requires g_tyranny: No

Minimum required version: 0.2.0

!pause

Pauses the match.

Syntax: !pause

Permission Flag: Z

Requires g_tyranny: No

Minimum required version: 0.2.0

!pip

Draws sparks (pixie dust) around the player in slot number SLOT or with name containing NAME. Does it to all players if NAME/SLOT is not providied.

Syntax: !pip [NAME|SLOT]

Permission Flag: z

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!pop

Pops the helmet off from a player in a slot number SLOT or with a name containing NAME. If no parameter is provided, it pops the helmets off from all the players.

Syntax: !pop [NAME|SLOT]

Permission Flag: z

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!putteam

Moves a player in a slot number SLOT or with a name containing NAME to the indicated team.

r - Allies

b - Axis

s - Spectators

Syntax: !putteam (NAME|SLOT) (r|b|s)

Permission Flag: p

Requires g_tryanny: No

Minimum required version: 0.2.0

!readconfig

Reads shrubbot.cfg file from the directory set by g_dbDirectory cvar.

Syntax: !readconfig

Permission Flag: G

Requires g_tyranny: No

Minimum required version: 0.2.0

!rename

Sets the player in slot number SLOT or with name containing NAME to NEWNAME. The name change will not be persistent. The user database will store the renamed name for the player.

Syntax: !rename (NAME|SLOT) NEWNAME

Permission Flag: N

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!reset

Resets the match.

Syntax: !reset

Permission Flag: r

Requires g_tyranny: No

Minimum required version: 0.2.0

!resetmyxp

Clears all XP and skillpoints for the player who runs this command.

Syntax: !resetmyxp

Permission Flag: M

Requires g_tyranny: No

Minimum required version: 0.2.0

!resetxp

Clears all XP and skillpoints for the player in the slot number SLOT or with the name containing NAME. If reason is provided it is printed to the client.

Syntax: !resetxp (NAME|SLOT) [REASON]

Permission Flag: X

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!restart

Restarts the match.

Syntax: !restart

Permission Flag: r

Requires g_tyranny: No

Minimum required version: 0.2.0

!riflewar

Enables riflewar game mode. All the players will have their main weapon changed to either K43 or Garand.

Syntax: !riflewar [on|off]

Permission Flag: q

Requires g_tyranny: No

Minimum required version: 0.2.0

!rmsubnetban

Removes subnet ban. The given subnet ban number can be found using !subnets command.

Syntax: !rmsubnetban [ban number]

Permission Flag: .

Requires g_tyranny: No

Minimum required version: 0.4.0

!setlevel

Sets the connected player in the slot number SLOT or with name containing NAME to the level indicated by LEVEL. A player cannot !setlevel another player to a lever higher than him/herself.

Syntax: !setlevel (NAME|SLOT) LEVEL

Permission Flag: s

Requires g_tyranny: No

Minimum required version: 0.2.0

!showbans

Lists up to 30 shrubbot bans currently in effect. The columns are:

ban number

banned player's name

date of the ban

name of the banning admin

when the ban will expire

reason for the ban

If SKIP is provided, that number of bans are skipped before printing starts. SKIP can also be negative (e.g. '!showbans -10' would display the last 10 bans.

Syntax: !showbans [SKIP]

Permission Flag: B

Requires g_tyranny: No

Minimum required version: 0.2.0

!shuffle

Shuffles teams, but does NOT restart (see !restart).

Syntax: !shuffle

Permission Flag: S

Requires g_tyranny: No

Minimum required version: 0.2.0

!slap

Does DAMAGE (default 20) damage to player in slot SLOT or with name containing NAME. If REASON is specified it's center-printed to the victim.

Syntax: !slap (NAME|SLOT) [DAMAGE] [REASON]

Permission Flag: A

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!sniperwar

Enables sniperwar game mode. All the players will have their main weapon changed to sniper rifles.

Syntax: !sniperwar [on|off]

Permission Flag: q

Requires g_tyranny: No

Minimum required version: 0.2.0

!spec999

Moves all the players with a ping of 999 to the spectators team.

Syntax: !spec999

Permission Flag: P

Requires g_tyranny: No

Minimum required version: 0.2.0

!spree

Show the players current killing spree count.

Syntax: !spree

Permission Flag: E

Requires g_tyranny: No

Minimum required version: 0.2.0

!spreerecord

Displays the map and the overall spreerecord.

Syntax: !spreerecord

Permission Flag: E

Requires g_tyranny: No

Minimum required version: 0.2.0

!stats

Displays the Thompson, MP40 and PPSh total kills and deaths, kills and deaths during the map and accuracy, headshotratio and headshot distance during the map. Lists all connected players.

Syntax: !stats

Permission Flag: t

Requires g_tyranny: No

Minimum required version: 0.2.0

!subnets

This command displays all the issued subnet bans.

Syntax: !subnets (start at)

Permission Flag: B

Requires g_tyranny: No

Minimum required version: 0.4.0

!subnetban

With this command admin can issue subnet ban. Subnet ban is a ban where the connecting player IP is matched against a larger IP range. The command accepts only subnets between range x.* - x.x.x.*. If the admin attempts to issue subnet ban that would ban himself the command refuses to add the subnet. This can be circumvented using rcon commands. If admin wants to add a subnet that would ban himself he must first whitelist himself with !userwl command. If silEnT can confirm the admin can connect the subnet ban is added. The command accepts full IP as it's parameter in which case the subnet is created to the x.x.x.* address. To remove subnet bans admin can use the !rmsubnetban command. The syntax with this commnd is the same kind with ban and userban commandand reason andtime can be given. The reason should be given so that any player connecting would know the reason for not being able to connect.

Syntax: !subnetban [subnet] (time) (reason)

Permission Flag: .

Require g_tyranny: No

Minimum required version: 0.4.0

Changelog:

0.6.2 - Octets can be cut from inside with 'x'. For example, "!subnetban 12x" will ban all IP addresses matching 12x.xxx.xxx.xxx.

!swap

Swaps the players to the opposite team.

Syntax: !swap

Permission Flag: w

Requires g_tyranny: No

Minimum required version: 0.2.0

!time

Prints out localtime of the client in the chat. No other client can see this time message. The command doesn't have a flag but it is available to all clients always.

Syntax: !time

Permission Flag: No permission required

Requires g_tyranny: No

Minimum required version: 0.2.0

!throw

Send the player in slot number SLOT or with name containing NAME flying.

Syntax: !throw (NAME|SLOT)

Permission Flag: l

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!tspree

Show the top n current killing spree (default top 5).

Syntax: !tspree [amount]

Permission Flag: E

Requires g_tyranny: No

Minimum required version: 0.2.0

!unban

Removes the ban that !showbans lists as BAN_NUMBER.

Syntax: !unban BAN_NUMBER

Permission Flag: b

Requires g_tyranny: No

Minimum required version: 0.2.0

!unfreeze

Unfreezes the client in slot number SLOT or with name containing NAME. If no parameter is provided it unfreezes all players.

Syntax: !unfreeze [NAME|SLOT]

Permission Flag: F

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!unpause

Unpauses the match.

Syntax: !unpause

Permission Flag: Z

Requires g_tyranny: No

Minimum required version: 0.2.0

!unmute

Unmutes the player in slot number SLOT or with name containing NAME.

Syntax: !unmute (NAME|SLOT)

Permission Flag: m

Requires g_tyranny: No

Minimum required version: 0.2.0

!unlock

Unlocks the team specified. Recognized values are r=AXIS b=ALLIES s=SPECTATORS all=ALL.

Syntax: !unlock (r|b|s|all)

Permission Flag: K

Requires g_tyranny: No

Minimum required version: 0.2.0

!uptime

Show how long the server has been up and running.

Syntax: !uptime

Permission Flag: u

Requires g_tyranny: No

Minimum required version: 0.2.0

!fling

Send the player in slot number SLOT or with name containing NAME flying.

Syntax: !fling (NAME|SLOT)

Permission Flag: l

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!launch

Send the player in slot number SLOT or with name containing NAME flying.

Syntax: !launch(NAME|SLOT)

Permission Flag: l

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!throwa

Sends all players flying.

Syntax: !throwa

Permission Flag: L

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!flinga

Sends all players flying.

Syntax: !flinga

Permission Flag: L

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!launcha

Sends all players flying.

Syntax: !launcha

Permission Flag: L

Requires g_tyranny: Yes

Minimum required version: 0.2.0

!warn

Plays the whistle sound and center-prints WARNING to the player in slot number SLOT or with name containing NAME.

Syntax: !warn (NAME|SLOT) [WARNING]

Permission Flag: R

Requires g_tyranny: No

Minimum required version: 0.2.0

User Database & Commands

User database is intended to store information of all the players that connect to the server. To enable user database g_dbDirectory must be set. The database stores information to identify different players and also XP data, rating data, overall stats data and shrubbot admin data. PunkBuster GUIDs are used to identify single players. If a player joining the server doesn't have a PB GUID, data about that player can not be saved. However, the user database can still be used to store data of those players who have enabled punkbuster on the client side.

Shrubbot includes functionality for server admins to handle database userdata. All commands that handle users in the database will take the last 8 characters of the player PunkBuster GUID to identify the player to edit. This is not an unique identification but because EvenBalance has seen this to have enough uniqueness, it is good for the use of the database commands. Internally, the full GUID is used to identify the players.

!aliasesdel

Command removes all the aliases from the player identified by the 8 character silEnT ID.

Syntax: !aliasesdel [silEnT ID]

Permission Flag: [

Requires g_tyranny: No

Minimum required version: 0.6.0

!aliassearch

This command searches the whole aliases database for the pattern in the names. Note, this command is the most resource intensive shrubbot command of all commands, and it is not recommended to be used without a reason. How fast it performs in practice depends of the aliases database size.

For each player the following information is shown:

identity information (silEnT ID)

each used alias that fits the search pattern

for each alias when it was first seen

for each alias when it was last seen

for each alias the total playtime with it

To see all the aliases of the found player, you can use "!userinfo aliases" command. In the case of all the data not fitting in one page, you can give an optional start parameter. The start parameter corresponds to the numbers shown in the first column of the results. So that each player has its own number and under that number, all the matching aliases from that player are printed.

Syntax: !aliassearch [name] [start]

Permission Flag: ]

Requires g_tyranny: No

Minimum required version: 0.6.0

!confirm

Confirms the player identity with a protected admin level. As a result, the confirmed player and the server will transfer authentication information allowing the player to use admin commands from thereafter. Unconfirmed players are players with admin level that is protected but the server can not ensure the identity. This usually happens when players admin level changes with offlinecommands or the protected levels are extended. This command does not give the player admin levels, it only confirms the identity of a player whos admin level is already set. Also, if the player loses his admin level identification, this command can not be used to reinstate it.

This command is safe to be given even to the lower levels of admins.

Syntax: !confirm [SLOT]

Permission Flag: :

Requires g_tyranny: No

Minimum required version: 0.5.0

!userlist

Lists all users in the database. If PAGE is given, the list starts from that page. If PAGE is not given the first page of the database is printed. The command prints all users, including clients that have connected during the level time and are not yet in the database. The connected clients are always printed first and then the rest of the userbase.

The printed rows have the following columns:

'#' ; This is the serial number of the user in the printout. The number doesn't correspond to anything in the database.

'silEnT ID' ; This is the 8 character silEnT GUID of the player. This is used to identify different players in the database.

'PBGUID' ; This is the 8 character PB GUID of the user. This is used to identify different users in the database.

'Last Seen' ; This tells how long time ago the user was last seen on the server. For connected clients, this will print "connected".

'IP' ; This tells the last IP address user has had on the server.

'Ban' ; This is the ban number if the player is banned from the server. If the player is whitelisted from IP bans, this column reads white capital W.

'Name' ; This tells the last name with user has been saved on the server.

With userlist command an admin can list all the users saved in the database and those that are connected page by page. Optional page number can be given to the command to tell which page is to be displayed about the users. One page can have up to 20 players printed.

Syntax: !userlist [PAGE]

Permission Flag: ]

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.4.0 - New column 'Ban' is added to the output.

0.5.0 - New column 'silEnT ID' is added to the output.

!userinfo

Displays all information that is stored about the user in the database.

This information includes:

identity information (name, IP, 8 character PunkBuster GUID, silEnT ID, Client Identification)

admin level

personal greeting

personal greeting sound

personal shrubbot flags

saved XP per skill

rating values

total kills and deaths with SMG weapons

the ban number of the player or whitelisting

list of stored aliases if the aliases database is enabled on the server

Command can optionally print player's stored aliases if the optional aliases parameter is given and the aliases database is enabled by setting g_dbMaxAliases to a positive integer. If printed aliases don't fit in one page, optional page parameter can be used to access different pages.

Command requires the last 8 characters of the player silEnT GUID. This GUID can be found with !userlist or !usersearch commands. This command works for both online and offline players.

Syntax: !userinfo [silEnT ID] [aliases [page]]

Permission Flag: ]

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.4.0 - Information of possible ban and whitelisting is added.

0.5.0 - silEnT ID is added.

0.6.0 - Aliases option is added.

!useredit

Command is used to edit explicit userdata in the database. The command format is:

!useredit [silEnT ID] [add|remove|level|greeting|sound] [new value]

The command parameters in detail:

silEnT ID - This is the last 8 characters of the silEnT GUID of the player. This is needed to identify the player to edit.

add - If the command is given this parameter, the value(s) in the [new value] field will be added to the player's personal flags.

remove - If the command is given this parameter, the value(s) in the [new value] field will be removed from the player's personal flags.

level - If the command is given this parameter, the value in the [new value] field will be set as the players new level. The level may not be higher then the level of the player executing the command.

greeting - If the command is given this parameter, the value in the [new value] field will be the players new personal greeting. If the [new value] field is empty, the personal greeting is cleared.

sound - If the command is given this parameter, the value in the [new value] field will be the file path to the players new personal greeting sound. If the [new value] field is empty, the personal greeting sound is cleared.

new value - This field is used to give values to the command.

If the optional new value field is not set with greeting or sound parameter, the value will be set to empty and level values will be used again with these players.

This command works with online and offline players.

Syntax: !useredit [silEnT ID] [add|remove|level|greeting|sound] [new value]

Permission Flag: [

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.5.0 - The command now uses the silEnT GUID instead of the PB GUID. The backward compatible version of the command is named !usereditpb.

!givexp

Command gives the online or offline player identified by PBGUID a defined amount of XP points to the selected skill.

Syntax: !givexp [silEnT ID] [sold|med|eng|fops|cov|light|battle] [amount to add]

Permission Flag: [

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.5.0 - The command now uses the last 8 characters of the silEnT GUID instead of the PB GUID. The backward compatible version of the command is named !givexppb.

!userban

Command bans user indentified by the 8 character silEnT GUID from the server. The data required for ban is taken from the database and the banned user does not need to be online when the command is given. Bot's cannot be banned with this command. Note that the bans are written in the human readable config file and you can still write the bans by hand if desired. Also, removing of the bans can be done by hand if desired.

Syntax: !userban [silEnT ID] [time] [reason]

Permission Flag: ]

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.5.0 - The command now uses the last 8 characters of the silEnT GUID instead of the PB GUID. The backward compatible version of the command is named !userbanpb.

!userwl

With this command admin can whitelist or remove whitelisting from any player. Whitelisting means that the player IP is not checked against any IP bans. Including subnet bans and individual bans.

Syntax: !userwl [silEnT GUID] [add|remove]

Permission Flag: .

Requires g_tyranny: No

Minimum required version: 0.4.0

!userdelete

Command removes the user identified by the 8 character silEnT GUID from the database. The actual actions are taken at the level end if needed. However, once the !userdelete command has been issued to the user, the information of the user is no longer available and after the shutdown game, it is permanently lost.

If the removed player is connected to the server while removing, a new entry is written to that player.

Syntax: !userdelete [silEnT ID]

Permission Flag: [

Requires g_tyranny: No

Minimum required version: 0.2.0

Changelog:

0.5.0 - The command now uses the last 8 characters of the silEnT GUID instead of the PB GUID. The backward compatible version of the command is named !userdeletepb.

!usersearch

With this command an admin can search the database for players with specific parameters. Arguments to the command can be pattern in the name, user admin system level and the beginning of the IP address. Additional page number can be given when the amount of found results exceed what can be shown in one page. All the arguments can be given in one command in any order. Any one of the arguments can be omitted, but each time when command is given at least one argument on top of the optional page number must be given. This command searches stored information only from the database. Connected players are not included unless they are already stored into the database.

This command can be performance intensive and it is not recommended to use it only for maintenance operations. The command will internally always try to optimise itself. If the command is given repeatedly with same arguments but only changing the page number, new searches are not performed but only different pages of the already found results are displayed. The optimisations include that the silEnT will try to use the already found results as the basis for the new search (e.g. "!usersearch name gao" followed by "!usersearch name gaoe" will first search the whole db to find all users with the pattern gao in their names and the follow up search will refine the already found results for gaoe). The maximum amount of results one search can return is 256 users. Users are displayed in the console in pages with 20 users on each page.

Syntax: !usersearch [name (name)]|&[level (level)]|&[IP (IP)] [page]

Permission Flag: ]

Requires g_tyranny: No

Minimum required version: 0.2.0

!updatepbguid

Updates the PB GUID that is stored in the database to the one which the player is currently using. With the exception that empty, invalid or dublicated PB GUIDs are not saved to the database.

Syntax: !updatepbguid [Name|Slot]

Permission Flag: ,

Requires g_tyranny: No

Minimum required version: 0.5.2

!readadmins

With this command an admin can read admin definitions from a specific admins.cfg file. The file must be placed in the directory pointed by g_dbDirectory server cvar. The file may have only admin definition blocks. Admin definitions use always the following syntax. The syntax is exactly the same used by the ETPub.

[admin]

name = name of the admin (can be left empty)

sguid = full 32 character silEnT GUID (this field is used to identify players in the database)

guid = full 32 character PB GUID (this field is used to identify players in the database)

level = level number

flags = personal admin flags (can be left empty)

greeting = personal greeting (can be left empty)

greeting_sound = path to personal greeting sound (can be left empty)

If the database doesn't yet have the player, it will be added there. Those players will have the last seen field reading NEVER with !userlist and !usersearch command outputs. If the player already exists in the database, the admin values will be overwritten with the ones in read from the admins.cfg file.

Syntax: !readadmins

Permission Flag: )

Requires g_tyranny: No

Minimum required version: 0.3.0

Change Log:

Starting from silEnT 0.5.0, the field sguid was added to the admin blocks. This allows adding admins using the silEnT GUIDs to identify them.

In versions between 0.5.0 and 0.5.2 this command was partially broken. The command is fixed from the version 0.6.0 onwards.

!resetpls

With this command an admin can reset all stored statistics from an online or an offline player. The stored statistics include total SMG kills and deaths, the player K/D rating and PRW rating.

Syntax: !resetpls [silEnT ID]

Permission Flag: (

Requires g_tyranny: No

Minimum required version: 0.3.0

Changelog:

0.5.0 - the command was changed to use silEnT ID instead of the last 8 characters of the PB GUID. There is no backward compatible command for PB GUIDs.

List of Permission Flags

Flags to privileges

1 - Cannot be vote kicked, vote muted, or complained against.

2 - Cannot be censored.

3 - Can run commands silently with /!COMMAND in the console.

4 - Can see Axis/Allies team chats as a spectator.

5 - Can switch teams any time, regardless of balance.

6 - Does not need to specify a reason for !mute, !kick or !ban.

7 - Can call a vote at any time (regardless of disabled voting or voting limitations).

8 - Does not need to specify a duration for a ban (defaults to PERMANENT).

9 - Can do shrubbot commands via team and fireteam chats.

0 - Is immune to g_inactivity and g_spectatorInactivity settings.

! - Is immune to all shrubbot commands (useful for server admins). Note, this flag must be specified explicitly the * flag does not grant it.

@ - "incognito" flag shows the admin as level 0 with no a.k.a info in the output of !listplayers. Note, this flag must be specified explicitly the * flag does not grant it.

$ - Can do !admintest on other players.

~ - Can read and write the adminchat with the /ma command. All referees and all other players with the ~ flag will be able to read this chat.

& - Can rename himself regardless of g_maxNameChanges limit.

? - Can see all private messages while being in spectators. g_tyranny must be set for this flag to take effect.

/ - Cannot send private messages. Otherwise normal privileges.

# - Cannot call votes.

: - Can confirm admin identity.

Flags to commands

A - !slap

a - !admintest

B - !showbans, !subnets

b - !ban, !unban

C - !crazygravity, !crazyspeed

c - !cancelvote

d - !disorient, !orient

E - !spree, !spreerecord, !tspree

e - !baninfo, !finger, !aliases

F - !freeze, !unfreeze

G - !readconfig

g - !gib

I - !howfair, !listteams

i - !list

K - !lock, !unlock

k - !kick

L - !flinga, !launcha, !throwa

l - !fling, !launch, !throw

M - !resetmyxp

m - !mute, !unmute

N - !rename

n - !nextmap

P - !spec999

p - !putteam

R - !warn, !dewarn

r - !reset, !restart

S - !shuffle

s - !setlevel, !levlist, !levinfo

t - !stats

U - !burn

u - !uptime

Q - !giba

q - !panzerwar, !riflewar, !sniperwar

V - !passvote

W - !news

w - !swap

X - !resetxp

x - !lol

Z - !pause, !unpause

z - !pip, !pop

] - !userlist, !userinfo, !userban, !usersearch, !aliassearch

[ - !useredit, !givexp, !userdelete, !aliasesdel

) - !readadmins

( - !resetpls

. - !userwl, !rmsubnetban, !subnetban

, - !updatepbguid

Shrubbot Files

To use shrubbot the g_dbDirectory must be set. All the shrubbot files are placed into that directory.

shrubbot.cfg

Shrubbot.cfg is the file that holds all the level definitions, custom commands, bans, warns and subnetbans for the server shrubbot. These configuration settings are hand editable. If the shrubbot.cfg file does not exists when !ban or!setlevel is used, a new one with default settings is created. The settings in the shrubbot.cfg are divided into following data blocks.

[level]

level = The level number.

name = The nameof the level used in e.g. !list command.

flags = The permission flags for the level.

greeting = The greetingtext that is displayed to every player joining the server with this level.

greeting_sound = The greeting sound played for every playerjoining the server with this level.

[command]

command = The name of the command.

exec = The executed command. These must be commands available to /rcon and these will be executed with rcon privileges.

desc = The help description of the cmmand.

levels = Space separated list of levels this command is allowed.

The exec field in the command block can use all the shortcuts that silEnT support. The shortcut is substituted as the command would have been a say from the player who issued the command. In addition to normal shortcuts, it is possible to use [i] which is replaced with the client number of the player who did the command.
The exec field in the command block can additionally use parameter placeholders. These are [1] - [9] where the number is the n:th parameter given to the custom command. When these are used, the server will substitute the placeholder with the n:th parameter given to the command.
Starting from silEnT 0.2.1, it is possible to add '?' to the parameter placeholders. This will make the server substitute the given string to a player name if only one player matches the string. For example:

[command]

command = crybaby

exec = playsound path/to/sound.wav; chat ^7[1?]^7 is crying like a little baby!

desc = Make someone cry

levels = 0 1 2 3 4 5

[ban]

name = The name of the banned player.

guid = The PunkBuster GUID of the banned player.

sguid = The silEnT GUID if the banned player.

ip = The IP address of the banned player.

reason = The reason for the ban.

made = The time and date when the ban was issued.

expires = When the ban will expire.

banner = The name of the admin who banned the player.

ident = The silEnT ident if available.

[subnetban]

subnet = The subnet of the ban.

reason = The reason for the ban.

made = The time and date when the subnet ban was created.

expires = When the ban will expire.

banner = The name of the admin who created the ban.

[warning]

name = The name of the warned player.

guid = The silEnT GUID of the warned player.

ip = The IP addressof the warned player.

warning = The reason of the warning.

made = The time when the warning was made.

warner = The name of the player who warned.

userdb.db

This is a file where the silEnT stores information of the players. This file is not hand editable. By editing this file by hand you risk it getting corrupted or causing error conditions. The silEnT will automatically identify this file version for different silEnT versions and if necessary silEnT will convert the file to a newer version. The old file will be always stored at the g_dbDirectory location with a _vxx added to it's name.

If silEnT finds this file to be corrupted or unusable, it will not overwrite it. It will only refuse to initialize the shrubbot and therefore you must look at the logs if you encounter any problems with shrubbot. The error messages in the log are usually very descriptive.

userxdb.db

This is a file where the silEnT stores information of the players which is not needed for the most players. This file is not hand editable. By editing this file by hand you risk it getting corrupted or causing error conditions. The silEnT will automatically identify this file version for different silEnT versions and if necessary silEnT will convert the file to a newer version. The old file will be always stored at the g_dbDirectory location with a _vxx added to it's name.

If silEnT finds this file to be corrupted or unusable, it will not overwrite it. It will only refuse to initialize the shrubbot and therefore you must look at the logs if you encounter any problems with shrubbot. The error messages in the log are usually very descriptive.

useradb.db

Starting from silEnT 0.6.0, this file holds the optional aliases database. To enable the database, g_dbMaxAliases cvar must be set to a positive integer. The aliases database can be disabled by setting g_dbMaxAliases to 0 value at any time and then re-enable the database by setting the value back to a positive integer without any effect to the file. However, if the g_dbMaxAliases cvar is set to a smaller value then it was before, the aliases that exceed the threshold will be lost unrecoverably.

This file is not hand editable. By editing this file by hand you risk it getting corrupted or causing error conditions. The silEnT will automatically identify this file version for different silEnT versions and if necessary silEnT will convert the file to a newer version. The old file will be always stored at the g_dbDirectory location with a _vxx added to it's name.

If silEnT finds this file to be corrupted or unusable, it will not overwrite it. The error messages in the log are usually very descriptive about the erros.

Shrubbot Limitations

Maximum number of levels: 31

Maximum length of shrubbot level name: 35 (includes color codes)

Maximum number of players in the database: Unlimited

Maximum number of player bans: 1023

Maximum number of subnet bans: 128

Maximum length of ban reason: 1023

Maximum number of admin-defined commands: 63

Maximum admin-defined command name length: 63 characters

Maximum admin-defined command length (executable part): 1023 characters

Maximum admin-defined command length (help string): 1023 characters

Maximum number of warnings: 1023

Shortcuts

Server supports the replacement of the following keys in say messages

[a] last player who gave you ammo

[d] last player who killed you

[g] the last 8 characters of your GUID

[h] last player who gave you health

[k] last player you killed

[l] your location (letter,number)

[n] your name

[r] last player who revived you

[p] last player you looked at

[s] health remaining

[w] name of current weapon

[t] ammo for current weapon