HookRaft

HookRaft is a NeoForge mod that keeps your Minecraft chat in sync with external webhooks. Forward in-game chat to outside services, receive messages back, and even send webhook messages via /hook.

Example usage with n8n for in-minecraft chat bot

Highlights

Two-way chat bridge – send chat to your webhook and broadcast incoming payloads in-game.
Flexible filters – forward everything, use regex, or stick to /hook command messages.
Live configuration – adjust settings without restarting the server.
Asynchronous HTTP – non-blocking requests keep the server responsive.

Requirements

Minecraft 1.21.10
NeoForge 21.10+
Java 21+

Installation

Drop the latest HookRaft JAR into your server’s mods folder.
Start the server to auto-generate config/hookraft-server.toml.
Edit that TOML to point at your outgoing webhook URL and tweak filters.

Example Configuration Snippet

[webhook]
outgoingWebhookUrl = "https://example.com/api/webhook"
incomingPort = 8000

[chat]
filterMode = "ALL"
displayMode = "HIGHLIGHTED"
senderName = "HookRaft"

[advanced]
connectionTimeout = 10000
debugLogging = false

Commands

/hook <message> – send a webhook message from chat.
/hookraft send <message> – alias for /hook.
/hookraft status – show mod health.
/hookraft list – list all settings.
/hookraft get <setting> – read a setting.
/hookraft set <setting> <value> – change a setting (OP level 2).

Webhook Format

Outbound:

  {
    "type": "chat",
    "player": "PlayerName",
    "message": "Hello world!",
    "timestamp": 109971141181051
  }

Inbound: POST /api/receive with message, text, or content.

Health Check

GET /api/health returns mod status, version, and player count.

Source Code

Source code can be obtained here.