Chat and console commands
BeamJoy has two command sets that look similar and are not the same thing.
- Chat commands are typed in game, start with
/, and are gated by the same permissions as the buttons in the window. - Console commands are typed in the server’s own console, start with
bj, and have no permission at all — the console is not a player. That is what makes it the way in on a fresh server, and the way back in if you lock yourself out.
Chat commands
Section titled “Chat commands”/help lists them, and it lists only the ones you may actually use — so two players running
it see different lists. A command typed without its arguments prints its usage line back.
Everyone
Section titled “Everyone”| Command | What it does |
|---|---|
/help |
Shows the commands available to you. |
/pm <player_name> <message> |
Sends a private message. A copy goes to staff. |
/login <password> |
Grants staff or owner rank if the password matches one set from the console. Wrong attempts are rate-limited. |
/nickname <name> |
Guests only. Sets the name used for your nametag, the player list and race leaderboards. /nick works too. A player logged in to a BeamMP account uses that account’s name and is told so. |
Activities
Section titled “Activities”None of these need a permission — they act on the session you are in.
| Command | What it does |
|---|---|
/race <ready|leave|cancel|retire> |
Manages the race you are in. Retire only works while it is actually running. |
/hunter <join|leave|ready|cancel> |
Joins or manages a hunt. |
/derby <join|leave|ready|cancel> |
Joins or manages a derby. |
/infected <join|leave|ready|cancel> |
Joins or manages an infected round. |
Each of the three arena commands also takes a staff-only debug subcommand for testing a round
on an empty server — /hunter debug start, /derby debug start [arena] [lms|timed|sumo],
/infected debug start.
Voting
Section titled “Voting”| Command | Needs | Default |
|---|---|---|
/votemap <map_name> |
VoteMap |
player |
/votekick <player_name> |
VoteKick |
player |
/votemap join|cancel, /votekick join|cancel |
— | everyone |
The permission gates starting a vote, not joining one. Anyone on the server can join or
cancel a vote that is already running, whatever their group — so moving VoteMap up to mod
leaves staff starting the votes and everybody still voting in them.
How each threshold is counted: map votes and vote-kicks.
Moderation
Section titled “Moderation”Every one of these also obeys the rank rule: you can only act on a group below your own.
| Command | Needs | Default |
|---|---|---|
/kick <player_name> [reason] |
Kick |
mod |
/mute <player_name> [reason] |
Mute |
mod |
/unmute <player_name> |
Mute |
mod |
/ban <player_name> [reason] |
Ban |
admin |
/tempban <player_name> <seconds> [reason] |
TempBan |
mod |
/unban <exact_player_name> |
Ban |
admin |
/setgroup <player_name> <group> |
SetGroup |
mod |
/freeze <player_name> |
FreezePlayers |
mod |
/engine <player_name> |
EnginePlayers |
mod |
/tempban takes seconds, not a duration string: /tempban PlayerName 3600 spamming.
/unban wants the exact name, and works on players who are not connected.
Getting around
Section titled “Getting around”| Command | Needs | Default | What it does |
|---|---|---|---|
/tp <player_name> |
TeleportTo |
player | Takes you to them. Rate-limited, and blocked mid-race. |
/tpfrom <player_name> |
TeleportFrom |
mod | Brings them to you. |
The server
Section titled “The server”| Command | Needs | Default | What it does |
|---|---|---|---|
/map <map_name> |
SwitchMap |
mod | Switches the map now, without a vote. |
/bjupdate [check | channel [release|development]] |
SetCore |
owner | Installs the latest BeamJoy, or only looks for it. See updating. |
Testing
Section titled “Testing”A handful of commands exist for testing and are not part of normal play.
| Command | Where | What it does |
|---|---|---|
/bjdamage |
chat | Shows your car’s damage readings, which is how pit repair times were calibrated. |
/bjtyretest <tyres|repair> |
chat | Runs one in isolation. Needs Experimental tyre changes on, and says so if it is not. |
/hunter debug, /derby debug, /infected debug |
chat, staff only | Start and steer a round on an empty server. |
bj racedebugadd <playerName> |
console | Injects a fake participant into that player’s race, so their own finish does not end the session. |
bj racedebugcomplete <playerName> |
console | Marks that fake participant DNF, to test “the other racer DNFs last” without a second client. |
The last two are temporary — the mod’s own source marks them for removal — so do not build anything around them.
Console commands
Section titled “Console commands”Typed into the server’s own console. Everything takes the bj prefix, except help, say and
list, which also work on their own.
bj help| Command | What it does |
|---|---|
bj help |
Lists every console command with its usage. |
bj say <message> |
Sends a message to every player. |
bj list |
Lists connected players with their vehicle counts and mute state. |
bj stop |
Stops the server properly, with a countdown to the players. |
Ownership and access
Section titled “Ownership and access”| Command | What it does |
|---|---|
bj group <name> [group] |
Shows a player’s group, or sets it. This is how the first owner is made. bj setgroup is the same command. |
bj staffpassword <password...> |
Sets the password players use with /login to become staff. |
bj ownerpassword <password...> |
The same, for owner. |
bj whitelist [set|add|remove] [true|false|playername] |
Shows the whitelist state, turns it on or off, or whitelists one player. |
bj group YourPlayerName ownerModeration
Section titled “Moderation”| Command | What it does |
|---|---|
bj kick <name> [reason] |
Kicks a player. |
bj ban <name> [reason] |
Bans a player. |
bj tempban <name> <duration> [reason] |
Bans for a number of seconds. |
bj mute <name> [reason] / bj unmute <name> |
Mutes and unmutes. |
An unknown or ambiguous name lists the candidates back rather than guessing.
The world
Section titled “The world”| Command | What it does |
|---|---|
bj map [map_name] |
Shows the current map, or switches to one. |
bj env help |
Lists the environment commands. |
bj env timesync [true|false] |
Shows or sets time-of-day sync. |
bj env time [dawn|noon|dusk|night] |
Shows or sets the time of day. |
bj env timeplay [true|false] |
Shows or sets the day and night cycle. |
Updating
Section titled “Updating”| Command | What it does |
|---|---|
bj update |
Installs the latest release. |
bj update check |
Only looks for one. |
bj update channel release|development |
Picks releases or test builds. |
What to know before you rely on them
Section titled “What to know before you rely on them”- Console commands bypass every permission and the rank rule. Anyone with access to the console has the server, whatever their in-game group says.
/helpis the honest list. If a command is missing from it, you do not hold its permission — it is not a typo.- Names are matched loosely in chat but exactly for
unban, because an unban has to work on someone the server cannot see.
- Players and moderation — the rules these commands enforce.
- Groups and permissions — moving a permission to another group.
- Permission reference — every key, one line each.
- Time, weather and the map — what
bj envis setting.