Skip to content

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.

/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.

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.

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.

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.

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.

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.
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.

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.

Typed into the server’s own console. Everything takes the bj prefix, except help, say and list, which also work on their own.

Terminal window
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.
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.
Terminal window
bj group YourPlayerName owner
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.

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.
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.
  • Console commands bypass every permission and the rank rule. Anyone with access to the console has the server, whatever their in-game group says.
  • /help is 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.