Headless Host

Choose where to host: You can host your room only on BOLT, or on BOLT and HaxBall at the same time.

Use your existing script: HBInit includes match statistics and vote-kick. Use BOLTInit when you want to choose features or use the room.bolt API.

Running in Node.js? We provide boltgame.js (npm i boltgame.js) as a drop-in replacement for haxball.js with no code changes required.

Docs: Give this to your AI agent and it will make the necessary changes for you.

  1. Keep this page open.
  2. Open the browser console and run your room code with HBInit(options) or BOLTInit(options).
  3. For a BOLT-only room, do not add a token.
  4. For a BOLT and HaxBall room, get a fresh token from haxball.com/headlesstoken and add it to your room options.
  5. Share the BOLT link below. Everyone should join with that link. If a token was provided, the room will also be joinable from Haxball.

Loading the headless runtime…