deadridge-headless

Run Haxball headless rooms from Node.js. Drop-in replacement for browser HBInit.

Installation

npm install deadridge-headless

Quick Start

import 'deadridge-headless-v2';

const room = HBInit({
  token: 'thr1.XXXXXX...', // Get from https://www.haxball.com/headlesstoken
  roomName: 'My Room',
  playerName: 'Bot',
  maxPlayers: 16,
  public: true,
  geo: { code: 'us', lat: 25.76, lon: -80.19 }
});

room.setTeamsLock(true);

room.onPlayerJoin = function(player) {
  room.sendAnnouncement(`Welcome ${player.name}!`, null, 0x00FF00);
};

room.onPlayerChat = function(player, message) {
  if (message === '!help') {
    room.sendAnnouncement('Available commands: !help', player.id);
    return false;
  }
  return true;
};

Token Required

Get your Haxball headless token: https://www.haxball.com/headlesstoken

Features

• Drop-in replacement for browser HBInit
• Works with existing Haxball scripts
• All official Headless API methods supported
• Event handlers work exactly as documented

Documentation

Full Headless API documentation: https://github.com/haxball/haxball-issues/wiki/Headless-Host

License

MIT