HookRaft

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.

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

1. Drop the latest HookRaft JAR into your server’s mods folder.
2. Start the server to auto-generate config/hookraft-server.toml.
3. 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.