EAK Just Debian Guru Page :) Just another Linux weblog

B3 Bot Manual – Commands

Level determins the minimum level needed to run the command.
Scope determins whether the message is displayed in public view, private view, or both.

!command [] description
Time Suffixes

Commands that deal with time duration like !tempban can use time suffixes.

m = minutes

d = days

h = hours

w = weeks

Example:

1d = 1 day

3h = 3 hours

Player Identification

Commands that accept player designations can use several inputs.
Partial Name

The simplest player identifier is the players name. You can use any part of the player name. Only enough charachters to match the players name uniquely is needed. If more than one player on the server has a simular name, you will be prompted with all players matching that name and thier client id.

Example:

!warn playe cuss

This will first search for players with “playe” in thier name; including “player”, “unkownplayer”, and “played”. If more that one player is found a list of results will be shown to pick a more specific user.

Tip:
You can use the !find to show what players match a given name.
Client ID

The client ID is the number assigned to the player by the game itself. 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 simuilar names, you can use the client id to single them out.

Example:

!kick 3 tk

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

Tip:
You can use the !lookup command to find offline users in the database.
Admin Plugin

!register
Level 0
Scope Private

!register

register youself as a basic user

!help []
Level 0
Scope Private
get info on how to use a command, you can use “*” for partial matches

!regtest
Level 0
Scope Public or Private
display your current user status

!time
Level 1
Scope Public or Private
display the servers current time

!maps
Level 2
Scope Public or Private
list the server map rotation

!nextmap
Level 2
Scope Public or Private
display the next map in rotation

!seen
Level 2
Scope Public or Private
when was this player last seen?

!admins
Level 20
Scope Public or Private
lists all the online admins

!b3
Level 20
Scope Public or Private
say b3 version info

!greeting []
Level 20
Scope Private
set or list your greeting

!list
Level 20
Scope Public or Private
list all connected players

!say
Level 20
Scope Public
say a message to all players

!spam
Level 20
Scope Public
spam a predefined message

!spams
Level 20
Scope Private
list spam messages

!warn []
Level 20
Scope Public
warn user

!warninfo
Level 20
Scope Public or Private
display how many warning points a user has

!warnremove
Level 20
Scope Public
remove a users last warning

!warns
Level 20
Scope Private
list warnings

!warntest
Level 20
Scope Private
test a warning

!admintest
Level 40
Scope Public or Private
display your current user status

!aliases
Level 40
Scope Public or Private
list a players aliases

!baninfo
Level 40
Scope Public or Private
display how many bans a user has

!find
Level 40
Scope Public or Private
test to find a connected player

!kick []
Level 40
Scope Public
kick a player

!leveltest []
Level 40
Scope Public or Private
display the status of a user

!scream
Level 40
Scope Public
yell a message to all players

!tempban []
Level 40
Scope Public
Temporarily ban a player. You can use Time Suffixes for durations.

!ban []
Level 60
Scope Public
ban a player for settings.ban_duration time

!permban []
Level 80
Scope Public
Permantly ban a player.

!spank []
Level 60
Scope Public
spank a player, naughty boy!

!unban
Level 60
Scope Public
un-ban a player

!clear [ ]
Level 80
Scope Public
clear all tk points and warnings

!lookup
Level 80
Scope Private
lookup a player in the database

!makereg
Level 80
Scope Public
make a name a regular * Level 1 user

!map

!restart
Level 80
Scope Public
restart b3

!warnclear
Level 80
Scope Public
clear all of a users warnings

!clientinfo
Level 90
Scope Public or Private
get info about a client

!cmdlevel
Level 90
Scope Private
set a commands level

!delgroup
Level 90
Scope Private
remove a group and remove all clients from the group

!editgroup <-n|-k|-l>
Level 90
Scope Private
change a group’s settings

!groups
Level 90
Scope Private
lists all the player’s groups

!newgroup
Level 90
Scope Private
create a new group

!pause
Level 90
Scope Public
pause the bot from parsing

!putgroup
Level 90
Scope Public or Private
add a client to a group

!rebuild
Level 90
Scope Private
sync up connected players

!ungroup
Level 90
Scope Public or Private
remove a client from a group

!die
Level 100
Scope Public or Private
shutdown b3

!disable Level 100
Scope Public or Private
disable a plugin

!enable Level 100
Scope Public or Private
enable a disabled plugin

!reconfig
Level 100
Scope Private
re-load all configs
Stats Plugin

!mapstats []
Level 1
Scope Public or Private
display the current maps stats for a user

!testscore
Level 1
Scope Public or Private
show how many skill points you would get if you killed {P name}
Team Damage Plugin

!forgive
Level 0
Scope Public

!forgive []

forgive a player for team damaging

@!forgiveall @
Level 0
Scope Public
forgive all attacker tk points

@!forgiveprev @
Level 0
Scope Public
forgive the last person to tk you

@!forgivelist @
Level 0
Scope Private
list all the players who have shot you

!grudge []
Level 0
Scope Public
grudge a player for team damaging, a grudge player will not be auto-forgiven

!forgiveinfo
Level 20
Scope Public or Private
display a user’s tk points

!forgiveclear
Level 60
Scope Public or Private

!forgiveclear

clear a user’s tk points