HookRaft: Two-Way Webhook Chat Bridge for Minecraft

HookRaft for Minecraft syncs in-game chat with external webhooks, filters messages, and live-tunes settings. Download HookRaft now for NeoForge.

HookRaft

Minecraft servers thrive on community, but keeping that community connected across platforms is often a chore. You might have a Discord server, a Telegram group, or a custom dashboard, and your in-game chat feels like an island. HookRaft is a NeoForge mod that builds a direct bridge between your Minecraft chat and any external webhook service, turning your server into a communication hub without breaking a sweat.

This mod is built for server administrators who want flexibility without the bloat. Instead of forcing you into a specific chat platform, HookRaft uses standard webhooks, meaning it works with Discord, Slack, custom APIs, and countless other services that support incoming and outgoing requests. It is a lean, asynchronous tool that keeps your server responsive while handling the traffic.

Why Use HookRaft for Minecraft?

The core appeal of HookRaft is its two-way bridge. It is not just about pushing your chat out to the world; it also pulls messages back in. This creates a seamless loop where a message sent from your Discord channel can appear in your game, and a player's in-game comment can be forwarded to your webhook endpoint. For community managers, this is a game-changer.

Beyond the basic relay, the mod offers a suite of practical features that make it stand out from simple bot integrations:

  • Two-way chat bridge: Send chat to your webhook and broadcast incoming payloads in-game.
  • Flexible filters: Forward everything, use regex patterns, or stick strictly to /hook command messages.
  • Live configuration: Adjust settings without restarting the server, perfect for fine-tuning on the fly.
  • Asynchronous HTTP: Non-blocking requests keep the server responsive, even under heavy chat load.

If you are looking to streamline your server management, you might also appreciate how easy it is to get started. The installation process is straightforward, and the mod handles the heavy lifting. For those who want a quick start, the foxygame.net launcher offers a one-click install for HookRaft, bundling the mod with the correct NeoForge version so you can skip the manual setup entirely.

Requirements and Compatibility

Before you download HookRaft, ensure your environment meets the specific requirements. This mod is designed for modern setups and will not run on older versions of the game or loader.

  • Minecraft: Version 1.21.10
  • Loader: NeoForge 21.10+
  • Java: Version 21 or higher

These requirements are strict. Trying to run HookRaft on an older Java version or a different loader like Fabric will result in a crash. Double-check your server files before proceeding.

How to Install HookRaft

The installation process is simple and follows the standard modding procedure for NeoForge. Here is a step-by-step guide on how to install the mod successfully.

  1. Download the latest HookRaft JAR file from the official source.
  2. Navigate to your server's mods folder.
  3. Drop the JAR file into that folder.
  4. Start the server. HookRaft will automatically generate a configuration file at config/hookraft-server.toml.
  5. Stop the server, edit the TOML file to set your outgoing webhook URL and adjust filters, then restart.

If you are using the foxygame.net launcher, the process is even smoother. The launcher's add-on catalog includes HookRaft, and it handles the version compatibility checks for you, ensuring you have the right NeoForge profile and Java runtime before you even launch the game.

Configuration Essentials

The generated TOML file is your control panel. You will want to pay close attention to the [webhook] and [chat] sections to get the behavior you want.

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

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

Setting filterMode to ALL forwards every chat message. You can change it to COMMAND_ONLY to restrict traffic to explicit commands, or use REGEX for advanced pattern matching. The displayMode controls how incoming webhook messages appear in the chat feed, and senderName lets you customize the prefix for those messages.

Using the Commands

Once installed, HookRaft gives you a set of powerful commands to interact with your webhook directly from the game. These are essential for testing and daily operations.

  • /hook <message> – Sends a webhook message directly from chat.
  • /hookraft send <message> – Alias for the /hook command.
  • /hookraft status – Shows the mod's health and connection status.
  • /hookraft list – Lists all current settings.
  • /hookraft get <setting> – Reads a specific setting's value.
  • /hookraft set <setting> <value> – Changes a setting (requires OP level 2).

These commands make it easy to manage the bridge without touching the config file repeatedly. For example, you can use /hookraft set displayMode HIGHLIGHTED to change how messages appear without a restart.

Understanding the Webhook Format

To integrate with external services, you need to understand the data structure HookRaft uses. Outbound messages are sent as JSON with a specific schema.

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

Inbound messages are simpler. The mod listens on the configured port and accepts POST requests with a message, text, or content field. There is also a health check endpoint at /api/health that returns the mod status, version, and player count, which is useful for monitoring.

Final Thoughts on HookRaft

HookRaft fills a specific niche with precision. It is not a full-featured Discord bot, nor does it try to be. Instead, it offers a clean, efficient webhook bridge that gives you total control over the data flow. The live configuration and asynchronous design make it a robust choice for servers that prioritize performance.

For the best experience, make sure your Java and NeoForge versions are up to date, and consider using the foxygame.net launcher to manage the mod's updates automatically. This ensures you always have the latest bug fixes and features for HookRaft without manual downloads. Whether you are syncing chat to a community Discord or building a custom dashboard, HookRaft provides the reliable connection you need to keep everyone talking.

Author: KlamrFox

Related Articles