haxball.js

v2.1.3

Published

7 months ago

A powerful library for interacting with the Haxball Headless API

Downloads

213

0High
0Medium
0Low

mertushka

haxball headless bot room

Language Most Used Repository Size

🔖 Table Of Contents

💻 Installing

npm install haxball.js

💻 Module Usage Example

// room.js

const HaxballJS = require("haxball.js");

HaxballJS.then((HBInit) => {
  // Same as in Haxball Headless Host Documentation
  const room = HBInit({
    roomName: "Haxball.JS",
    maxPlayers: 16,
    public: true,
    noPlayer: true,
    token: "YOUR_TOKEN_HERE", // Required
  });

  room.setDefaultStadium("Big");
  room.setScoreLimit(5);
  room.setTimeLimit(0);

  room.onRoomLink = function (link) {
    console.log(link);
  };
});

💻 (Optional) Proxy

Haxball has a limit of 2 rooms per IP. Therefore, you can use proxy with adding proxy: "<YOUR_PROXY_IP>" in your RoomConfig.

Example:

HBInit({
    ...
    proxy: "http://1.1.1.1:80",
});

💻 (Optional) TypeScript

From v2.1.0, the package has basic typings included. Typings are automatically imported alongside haxball.js package.

Install TypeScript and ts-node in your project:

npm install typescript --save-dev
npm install ts-node --save-dev

Name the file room.ts instead of room.js and use example room code from the previous section.

You may run the server with ts-node room.ts instead of node room.js. To make it runnable with npm start, add the alias to package.json:

// package.json

//...
  "scripts": {
    "start": "ts-node run.ts"
  }
//...

💻 (Optional) Modularize Room Script

You can build full room scripts as NPM packages, that export roomBuilder function. These functions can be easily imported by another packages (launchers, remote orchestrators, etc.).

// super-futsal-room/index.ts

import { Headless } from "haxball.js"

// Every user installing the package will have to
// implement this interface in order to run it.
interface RoomArgs {
    token: string
    timeLimit: number
}

const roomBuilder = (HBInit: Headless, args: RoomArgs) => {
    let room = HBInit({
        roomName: "Hello TypeScript!",
        token: args.token
    })

    room.setTimeLimit(args.timeLimit)
}

export default roomBuilder;

// room-launcher/index.ts

// Local path as example, but may refer to installed npm package
import roomBuilder from "../super-futsal-room";
import HaxballJS from "haxball.js";

HaxballJS.then((HBInit => roomBuilder(HBInit, {
  // Interface for config arguments is provided by the room script author
  // Not defining them results in TypeScript error
  token: "YOUR_TOKEN_HERE",
  timeLimit: 3
})))