Chat Commands - uzayyli/Haxball-Headless-Bot GitHub Wiki

Notes

  • Command prefix is . but ! works too
  • For commands that take <player> as argument, you can type part of their name (case-insensitive) or their #id. For example if a player is named HaRrY with id 132, you can type .avatar rry default or .avatar #132 default
  • Some commands like .mute, .blacklist etc are only available for admin level 3. If you want to authorize someone with access to all commands, type .setadminlevel <player> 3
  • Almost any command that takes arguments use spaces as separator, so do NOT have spaces in your admin passwords, etc. If a player name has multiple words, use one of the words to refer to them.
  • This wiki is up-to-date for v6.2, if you use v7, please use .help and .help_params chat commands in game

Commands

.help (<cmd>)

.help Shows you all available commands

.help <cmd> Shows you detailed help about a command. Example: .help avatar

.admin <pass> (hidden)

.admin aDmInPw#*123 Gives you admin rights

.admin aDmInPw#*123 hidden Makes you a "hidden" admin. No yellow name but you can still use chat commands.

.admin trusted list shows the trusted admins' auth list.

.admin trusted fetch [url] updates the trusted admins list.

.setadminlevel <player> <level> (hidden)

Gives another player admin rights. You cannot promote/demote someone higher than your level. Also admin level 4 (room owner) cannot be promoted, they need to know the password. Alias: sal

.say <text>

Writes text as a bot announcement, in color

.motd <msg>

Shorthand to set / send a stored welcome message. Welcome message is sent once to every player who joins the room.

.motd Press X to brake Saves a new message

.motd Sends the stored message

.motd clear Clears the message

.mute <player>/all <minutes>

.mute rry 2 Mutes Harry for two minutes

.mute #123 0 Unmutes player with id 123

.mute all <minutes>

Mutes / unmutes everyone (except admins above your level)

.afk (<player>)

Toggles the AFK status of a player

.blacklist <key> <value>

.blacklist conn 3137362E3731222E35352E323039 Saves this conn string and automatically bans them if they join again, even if they change their nickname. More or less the same thing as the game's built-in ban feature.

.blacklist name BadBoy Bans any player who joins with this exact name. Case sensitive

.blacklist namepart BadB Bans any player who has the query in their nickname. Case insensitive

.blacklist auth SvfGuAyLb-uQ_gIQNWVufma-VbpyiNdwFjEztnNY_tg Bans this auth key

.blacklist clear Clears the name and IP blacklists

.kick <player> (<reason>)

Kicks a player

.ban <player> (<reason>)

Bans a player

.clearban <id>

Clears a recent ban. To see recent bans, type .security recentbans

.clearban all: Clears all bans

.security

Allows to take certain security actions, needs admin level 3+. Alias: sec

.security recentbans: shows recently banned players

.security captcha [on/off]: turns on or off captcha when joining room

.security password [value/random/null]: sets or clears the room password

.security multilogin [on/off]: allows or blocks logins from multiple tabs. off by default

gamemode <mode>

Changes the auto balancing mode. Alias: gm

.gamemode manual: turns off automatic balancing

.gamemode 4v4 ws: sets 4v4 and "winner stays" mode

.gamemode 3v3: sets 3v3 and automatically mixes all teams after a match

.avatar <player>/all <value>

.avatar rry 42 Sets Harry's avatar to 42

.avatar rry default Sets Harry's avatar to a default emoji (🎃), useful against annoying avatar macros.

.avatar all clear Clears everyone's custom avatars

.maps

Shows you a list of available stadiums

.maps fetch [url] reads stadium data from a new JSON file (admin level 4 only)

.load <stadium>

Loads a custom stadium (if it exists in .maps menu)

.spec <player>

Moves the player to spectators, without marking them as AFK, so they will be added back next time someone joins or leaves

⚠️ **GitHub.com Fallback** ⚠️