Haxball Headless: cómo crear una sala 24/7 (token y script)

Haxball Headless Host es la forma oficial de abrir una sala de Haxball sin jugar en ella: la sala la controla un script en JavaScript que se ejecuta en un navegador o servidor, en lugar de una persona. Se usa para salas públicas 24/7, ligas, torneos y salas con autoadmin o estadísticas. Para abrirla necesitas tres cosas: la página oficial haxball.com/headless, un token y un script.

Qué es Haxball Headless

En una sala normal de Haxball, el host es un jugador: si cierra el navegador, la sala desaparece. En una sala headless, el host es un programa. La página oficial haxball.com/headless carga el motor de Haxball sin la parte visual y expone la función HBInit(), con la que un script crea la sala y reacciona a lo que pasa en ella (jugadores que entran, goles, mensajes del chat).

Con un script puedes, por ejemplo:

• Dar admin automáticamente cuando no hay ninguno (autoadmin).
• Llevar estadísticas de goles, asistencias y partidos.
• Armar equipos con capitanes, ligas o torneos con reglas propias.
• Mostrar mensajes de bienvenida y comandos de chat como !help.

Paso 1: obtener el token

Haxball pide un captcha para crear salas. Para que un script pueda crearla sin resolverlo, se usa un token headless:

1. Entra en haxball.com/headlesstoken.
2. Resuelve el captcha.
3. Copia el token que aparece en pantalla.

El token caduca rápido, así que úsalo enseguida. Si la sala no se abre y la consola dice que el token no es válido, genera uno nuevo y vuelve a iniciar el script. Una vez abierta, la sala sigue funcionando aunque el token caduque.

Paso 2: un script básico para copiar

Este script abre una sala pública de 12 jugadores en el estadio Classic, con límite de 3 goles y 3 minutos, da la bienvenida a cada jugador y mantiene siempre un admin en la sala. Reemplaza PEGA_AQUI_TU_TOKEN por tu token:

const room = HBInit({
  roomName: 'Mi sala 24/7',
  maxPlayers: 12,
  public: true,
  noPlayer: true, // el host no ocupa un lugar de jugador
  token: 'PEGA_AQUI_TU_TOKEN',
});

room.setDefaultStadium('Classic');
room.setScoreLimit(3);
room.setTimeLimit(3);

// El enlace de la sala aparece en la consola
room.onRoomLink = (link) => console.log('Sala abierta:', link);

room.onPlayerJoin = (player) => {
  room.sendAnnouncement('¡Bienvenido, ' + player.name + '!', player.id);
  updateAdmins();
};

room.onPlayerLeave = () => updateAdmins();

// Si no queda ningún admin, se le da admin al primer jugador
function updateAdmins() {
  const players = room.getPlayerList();
  if (players.length === 0 || players.some((p) => p.admin)) return;
  room.setPlayerAdmin(players[0].id, true);
}

Opcional: para que la sala aparezca con la bandera y ubicación de tu comunidad en la lista de salas, agrega la opción geo dentro de HBInit (en este ejemplo, Buenos Aires):

geo: { code: 'AR', lat: -34.60, lon: -58.38 },

Paso 3: abrir la sala desde el navegador

1. Abre haxball.com/headless.
2. Abre la consola del navegador con F12 (pestaña «Consola» o «Console»).
3. Pega el script con tu token y presiona Enter.
4. En unos segundos la consola muestra Sala abierta: https://www.haxball.com/play?c=.... Ese es el enlace para entrar y compartir.

Así puedes probar tu script gratis. El problema es que la sala vive solo mientras esa pestaña siga abierta: si cierras el navegador, se suspende la PC o se corta tu internet, la sala se cierra para todos.

Paso 4: cómo dejar la sala online 24/7

Para que la sala no dependa de tu computadora hay tres opciones:

• Dejar tu PC encendida. Gratis, pero gastas luz, la sala se cae con cada corte o actualización de Windows y el ping depende de tu conexión doméstica.
• Un VPS propio. Instalas Node.js y un navegador headless (por ejemplo, Puppeteer con Chromium) y ejecutas el script ahí. Es la opción más flexible, pero tienes que administrar el servidor tú mismo. Un VPS en Miami desde $5.99/mes sirve para varias salas.
• Un hosting de Haxball. Subes tu script, pegas el token e inicias la sala desde un panel web, sin administrar servidores. En Haxball Hosting de X Hosting los planes empiezan en $0.99/mes, con servidores en Miami (baja latencia hacia Latinoamérica), protección anti-DDoS y consola en vivo para ver el enlace de la sala y los mensajes del script.

¿Por qué Miami? Una sala de Haxball la juegan personas de varios países. Miami está conectada por rutas directas con Argentina, Chile, Colombia, México y Perú, así que el ping suele quedar más parejo para todos que si la sala se abre desde una casa en un solo país.

Problemas frecuentes

«Invalid token» o la sala no se abre

El token caducó o ya se usó. Genera uno nuevo en haxball.com/headlesstoken y reinicia el script.

La sala no aparece en la lista pública

Revisa que public: true esté en HBInit. Si la creaste con public: false, solo se puede entrar con el enlace.

Los jugadores tienen lag

El ping depende de dónde se ejecuta la sala. Si corre en una PC con wifi o con poca subida, todos sufren tirones. Un servidor con buena conexión y cerca de tus jugadores lo soluciona.

Nadie tiene admin

Con noPlayer: true el host no es un jugador, así que nadie es admin por defecto. La función updateAdmins() del script de arriba lo resuelve dándole admin al primer jugador cuando no queda ninguno.