Create & run a room

Everything from your first sign-in to a live room with stats — point and click, no scripting.

Before you start

You need a HaxDevs account and one thing only Haxball can give you: a headless token. Open haxball.com/headlesstoken, solve the captcha, and copy the token. That captcha is always a human step — HaxDevs never solves it for you. Once a room is open we keep the session alive, so you rarely need a fresh one.

Open your room

1. 1
   Go to Rooms

   In the dashboard sidebar, open Rooms and find the “Open a room” panel.
2. 2
   Name it and pick a worker

   Type a room name and choose a worker (your plan decides which regions you can pick).
3. 3
   Paste the token

   Drop the headless token into the token field and click Open room. The token is used immediately and never stored.
4. 4
   Watch it come alive

   Status flips STARTING → ONLINE and the live log starts streaming. Your room now shows in the Haxball list (unless you set it private).

Edit the room — and hot-reload it live

Click a room to open its page. The Configuration editor maps to what the Haxball headless API actually exposes: name, max players, region flag, score and time limits, stadium, teams lock, and kick-rate. Behaviours like AFK-kick and auto-admin are plugins you toggle on — they’re labelled as plugins so you always know what’s native and what isn’t.

1. 1
   Change a setting

   Adjust a field — say, set the score limit to 5.
2. 2
   Save

   Hit Save & hot-reload. If the room is live, the change applies instantly — no restart, no dropped players.
3. 3
   Every save is a version

   Each save is recorded in Version history with your change note.

Roll back a change

Made a change you regret? In Version history, click rollback on any earlier version. HaxDevs creates a new version from that snapshot and hot-reloads it into the live room. Nothing is lost — the rollback itself is just another entry in the history.

Install a script

1. 1
   Open the Scripts hub

   Browse free, vetted scripts and maps in Scripts.
2. 2
   Pick one

   Open a script to read what it does and preview its source.
3. 3
   Install into a room

   Choose one of your rooms and click Install into room. It drops in sandboxed and pinned to a version, so a later update never silently breaks your room.

Read your stats

Every match your room plays feeds the Stats page: a live ELO ladder, win/loss records, and match history per room. Want it elsewhere? Every room exposes a clean public API at /api/v1/rooms/<slug>/ladder and /matches — wire it into a Discord bot or a website. Replays are saved to your vault and kept for as long as your plan allows.