Miscellaneous

Duration syntax

Many plugin settings need to express durations. For this purpose, B3 provides a convenient syntax using a suffix for expressing different duration units :

s
second i.e.: 45s
m
minute i.e.: 5m
h
hour i.e.: 1h
d
day i.e.: 7d
w
week i.e.: 4w

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.

Partial Name

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.

Example:
!warn sam cuss for giving a warning to a connected player named ‘Samuel’

Note

You can use the find command to show which connected players match a given name.

Note

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'

Client ID

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.

Example:
!kick 3 tk to kick a player connected on game slot number 3

Database ID

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.

Example:
!makereg @1235

Note

You can use the lookup command to find offline users in the database and get their database ID.

MySQL tools

The following tools facilitate the use and administration of a MySQL database. Probably you have already installed one of these tools.