Nerdhalla utility bot

Meet Head Pool.

Head Pool is Nerdhalla's Homeworlds referee, matchmaker, AI opponent and EPIC RPG dungeon helper. Use this page to find commands, aliases and what each feature does.

Prefix hp Compact prefix hp* Slash commands /

💀 Invite Head Pool to Discord 📘 How to Play Homeworlds 🏆 Homeworlds Leaderboard 📸 Screenshots

Two prefix styles

hp help and hp*help both work. Homeworlds also accepts hw and homeworlds.

Interactive panels

Rules and matchmaking use Discord buttons, so the most common actions don't require memorizing every command.

Persistent games

Homeworlds game, queue and archive state is persisted so Head Pool can recover after a restart.

Player AI Admin Owner

No commands match that search.

General

Help, responsiveness and bot health.

hp help

Opens Head Pool's interactive help panel with Homeworlds, EPIC RPG, admin and usage sections.

hp*help/help

hp ping

Checks that Head Pool is responding and reports bot latency.

hp*ping/ping

hp test

Simple responsiveness test for Head Pool.

hp*test/test

hp status

Shows Head Pool's service/feature health information.

hp health/status

EPIC RPG Dungeon Helper

Manage Head Pool's dungeon helper coverage. The short dung and full dungeon names both work.

hp dungeon help

Shows the EPIC RPG dungeon helper commands and usage.

hp dung helphp*dungeon helphp*dung help/dungeon help

hp dungeon view

Shows the currently configured dungeon helper coverage.

hp dung view

hp dungeon enabled

Shows whether the EPIC RPG dungeon helper feature is enabled.

hp dung enabledhp dungeon status/dungeon status

hp dungeon add d14

Adds a dungeon to the helper. Use all to enable all supported dungeon helpers.

hp dung add d14hp dungeon add all/dungeon enable

hp dungeon remove d14

Removes a dungeon from the helper. Use all to disable all configured dungeon helpers.

hp dung remove d14hp dungeon remove all/dungeon disable

Homeworlds

Rules, setup, timers, game control and move commands.

hp hw help

Opens the Homeworlds command/help panel.

hp homeworlds helphp*hw help/homeworlds help

hp hw rules

Posts the interactive Homeworlds rules menu with official rules and Nerdhalla links.

hp hw rulehp homeworlds ruleshp rules/homeworlds rules/homeworlds rule

hp hw rulepanel

Posts the persistent Homeworlds rules panel for a rules channel. Requires message-management permission.

hp hw rulespanelhp rulespanel

hp hw register

Registers players for a Homeworlds game.

/homeworlds register

hp hw unregister

Removes your Homeworlds registration.

/homeworlds unregister

hp hw begin

Begins a registered Homeworlds match.

/homeworlds begin

hp hw cancel

Cancels the current Homeworlds setup/game before normal completion.

/homeworlds cancel

hp hw homeworld

Sets your Homeworld during game setup.

homeworldhwh/homeworlds homeworld

hp hw time

Shows Homeworlds timer information for the current match.

/homeworlds time

hp hw simple

Configures a simple Homeworlds game timer.

/homeworlds simple

hp hw fischer

Configures a Fischer-style timer with increment.

/homeworlds fischer

hp hw hourglass

Configures an hourglass-style Homeworlds timer.

/homeworlds hourglass

hp hw build

Performs a Homeworlds Build action during your turn.

b/homeworlds build

hp hw trade

Performs a Homeworlds Trade action.

t/homeworlds trade/homeworlds swap

hp hw move

Moves one of your ships between connected systems.

m/homeworlds move

hp hw discover

Discovers a new star system with one of your ships.

d/homeworlds discover

hp hw attack

Performs an Attack/Capture action against an opponent's ship.

a/homeworlds attack

hp hw sacrifice

Sacrifices one of your ships to gain additional actions of its color.

ssac/homeworlds sacrifice

hp hw catastrophe

Triggers a catastrophe where the game state satisfies the catastrophe requirement.

ccat/homeworlds catastrophe

hp hw pass

Passes the current action/turn when allowed.

p

hp hw undo

Requests/uses the Homeworlds undo function for the current game state.

/homeworlds undo

hp hw pause

Pauses the current Homeworlds game/timer.

/homeworlds pause

hp hw unpause

Removes a pause from the current game.

/homeworlds unpause

hp hw resume

Resumes a supported interrupted or stopped Homeworlds game.

/homeworlds resume

hp hw stop

Stops the current Homeworlds game.

/homeworlds stop

hp hw draw

Handles a draw/tie result for the current Homeworlds match.

Homeworlds Matchmaking

Global queue, private match threads and cross-server Nerdhalla fallback.

hp hw join

Joins the Homeworlds matchmaking queue where the direct queue command is available.

hp hw leave

Leaves the Homeworlds matchmaking queue.

hp hw list

Shows Homeworlds matchmaking queue information.

hp hwqueue post

Posts the permanent matchmaking panel. Players can join the queue or choose to play Head Pool from the buttons.

Manage Server required

Stats, Position & AI

Player records, board inspection, challenges and Head Pool's Homeworlds AI.

hp hw stats

Shows Homeworlds player statistics. If no player is given, it shows your own stats.

hp hwstatshp hwstat/hwstats

hp hw position

Displays the current Homeworlds position/game state in a readable form.

hp hwpositionhp hwpos

hp hw challenge

Creates a Homeworlds challenge to another player.

hp hwchallengehp hwc

hp hw bot

Starts or manages a game against Head Pool's Homeworlds AI.

hp hwbot/hwbot

Easy AI

Beginner-friendly Homeworlds AI. Teaching Mode is available here and can explain Head Pool's moves.

Normal AI

A stronger general-purpose Homeworlds opponent for normal practice games.

Hard AI

Uses Head Pool's stronger Homeworlds search/strategy engine for more difficult play.

hp hw stats backfill

Scans historical Homeworlds archives and imports their results into player statistics.

hp hwstatsbackfillhp hwbackfill

hp hwstatsadmin

Owner-only command to set a displayed Homeworlds stat correction for a player.

hp hwstatset/hwstatsadmin

hp hwstatsreset

Owner-only command to remove a Homeworlds stat correction.

/hwstatsreset

How Head Pool runs Homeworlds

The command list is only part of what the bot handles.

Automatic matchmaking

When players are paired, Head Pool can create a private match thread, register both players and post the game commands automatically.

Permanent match records

Completed matches can be published as public read-only archive records, with player stats updated from results.

Cross-server play

If matched players do not share a server, the matchmaking flow falls back to Nerdhalla so the match can still be created and played.