Many plugin settings need to express durations. For this purpose, B3 provides a convenient syntax using a suffix for expressing different duration units :
- second i.e.:
- minute i.e.:
- hour i.e.:
- day i.e.:
- week i.e.:
For example, let’s say you want to ban player Joe for 1 week with reason ‘insult other players‘, you would use the command :
!ban joe 1w insult other players
Player identification in commands¶
Commands that accept player designations can use several types of input.
The simplest player identifier is the players name. You can use any part of the player name. Only enough characters to match the players name uniquely is needed. If more than one player on the server has a similar name, you will be prompted with all players matching that name and their client id.
- !warn sam cuss for giving a warning to a connected player named ‘Samuel’
You can use the find command to show which connected players match a given name.
If the player’s name contains blank characters as in
M I K E, then you can use its name without the blanks: !kick mike
Another solution is to wrap single quotes (
') around the name: !kick 'm i k e'
The client ID is the number assigned to the player by the game server. The client ID only works for the current gaming session. For a list of players’ client IDs, use the !list command. If a players name is too hard to type or there are more than one players with similar names, you can use the client id to single them out.
- !kick 3 tk to kick a player connected on game slot number 3
The Database ID is the players unique identification within the B3 database. It is prepended with an ”@” and is often referred to as the “at ID”. This ID is displayed with the leveltest command and the lookup command. You can use this ID to perform actions against a player even when that player is not connected.
- !makereg @1235
You can use the lookup command to find offline users in the database and get their database ID.