MatterLink: Bridging Minecraft Chat with MatterBridge for Seamless Cross-Platform Communication
In the vast world of Minecraft servers, keeping players connected across different platforms can be a challenge. Whether your community hangs out on Discord, IRC, Telegram, or even other Minecraft servers, bridging those chat channels into one unified stream is a game-changer. MatterLink is a powerful server-side mod that acts as an endpoint for MatterBridge, linking your Minecraft chat directly to dozens of external messaging services. If you have ever wanted your in-game messages to flow effortlessly into your Discord server while letting Discord users send commands back into the game, this mod is exactly what you need.
What Is MatterLink and How Does It Work?
MatterLink is a Forge mod designed to connect a Minecraft server to a MatterBridge relay. MatterBridge itself is an open-source bridge that supports over 70 protocols, from Discord and Slack to IRC and Matrix. By running MatterBridge alongside your server and installing MatterLink, you create a two-way communication pipeline. Every chat message, join/leave notification, and even custom bridge commands can travel between your Minecraft world and any connected platform.
The mod requires a running MatterBridge instance configured with its API enabled. Once linked, the Minecraft chat becomes just another channel in your bridge network. Players inside the game see messages from external users with their nicknames, and external users see in-game chat with the player's name. It is seamless, lightweight, and highly configurable.
Key Features of MatterLink
- Full bidirectional chat sync: Messages from Minecraft appear on all bridged platforms, and vice versa.
- Custom bridge commands: Define commands that external users can trigger to interact with the server, including passthrough commands that execute directly on the Minecraft console.
- Account linking: Players can link their external chat identities to their Minecraft UUID, enabling personalized permissions and identity tracking.
- Permission levels: Assign numeric permission levels per UUID to control who can use specific commands.
- Live configuration reloading: Edit config files and reload without restarting the server using the
/ml reloadcommand. - Join/part announcements: Optionally broadcast when players connect or disconnect from the Minecraft server across all bridged platforms.
Setting Up MatterLink
Before you dive in, you will need a few things: a Forge-based Minecraft server, the MatterLink mod, the Forgelin dependency (a Kotlin runtime for Forge), and a functioning MatterBridge installation. The setup process is straightforward, especially if MatterBridge runs on the same machine as your server.
Local MatterBridge Setup
If MatterBridge is on the same machine, configure its API section like this:
[api]
[api.local]
BindAddress="127.0.0.1:4242"
Token=""
Buffer=1000
RemoteNickFormat="{NICK}"
ShowJoinPart = true
With an empty token, no authorization is needed. Just start MatterBridge, then launch the Minecraft server with MatterLink and Forgelin in the mods folder. The mod will connect automatically.
Remote MatterBridge Setup
When MatterBridge runs on a different machine, bind the API to 0.0.0.0:4242 and set a secure token. Then, in MatterLink's connection config, specify the IP or domain and the token. After saving, use /ml reload to apply the changes.
If you prefer a streamlined installation process, the foxygame.net launcher offers a convenient, flexible, and modern way to manage your mods; you can download MatterLink and its dependencies right from the menu, eliminating manual file management. This is especially handy for server administrators who want to keep everything organized without digging through multiple websites.
Command System and Customization
MatterLink comes with a few default commands: help, tps, list, seed, and uptime. But the real power lies in defining your own. Commands are specified in JSON format, supporting two types:
Passthrough Commands
A passthrough command executes a command directly on the Minecraft server console. For example, to let bridged users check the server's TPS:
{
"tps": {
"type": "PASSTHROUGH",
"execute": "forge tps",
"permLevel": 0,
"help": "Print server tps",
"allowArgs": false
}
}
Response Commands
Response commands return a predefined string, which can include placeholders like {uptime}. This is perfect for quick info without running a console command:
{
"uptime": {
"type": "RESPONSE",
"response": "{uptime}",
"permLevel": 1,
"help": "Print server uptime",
"allowArgs": false
}
}
You can set different permission levels for each command, ensuring that only trusted users can run sensitive operations. The permLevel field corresponds to the numeric value assigned to a player's UUID in the permissions config.
Account Linking and Identity Management
To tie an external chat account (like a Discord ID) to a Minecraft player, users execute the !auth Username command from the bridged platform. The system guides them through the process, and once linked, the identity is stored in a JSON file. This allows the mod to recognize who is sending commands and apply the correct permissions.
For example, after linking, the config might look like:
{
"edd31c45-b095-49c5-a9f5-59cec4cfed8c": {
"discord.game": [ "112228624366575616" ]
}
}
And permissions are assigned separately per UUID with a simple number, where higher values grant more access.
Reloading and Maintenance
One of the most convenient features is the ability to reload the entire configuration on the fly. The /ml command has three subcommands: connect, disconnect, and reload. The reload option disconnects from MatterBridge, reads the updated config and custom command files, then reconnects—all without restarting the server. This makes iterative tuning a breeze.
Dependencies and Compatibility
MatterLink requires Forgelin to function, as it is built with Kotlin. You will need to place both mods in your server's mods folder. The mod is designed for Forge servers and works with modern Minecraft versions, though always check the specific version compatibility on the mod's download page. Additionally, you must run MatterBridge itself—either on the same machine or a remote host—configured with the API section as described.
To get MatterBridge, you can fetch it from its GitHub repository (42wim/matterbridge) and use the sample configuration file to get started. The default settings work out of the box with MatterLink's defaults, so you can have a basic bridge running in minutes.
Why Use MatterLink for Your Server?
Integrating your Minecraft server with external chat platforms transforms how your community interacts. Players who cannot log into the game can still participate in conversations, staff can monitor chat from their phones, and automated notifications can be sent to Discord channels. The custom command system also opens up possibilities for remote administration or fun interactive bots. MatterLink's lightweight design and hot-reloading capabilities make it a low-maintenance addition that packs a huge punch.
Whether you run a small private server or a large public network, bridging your chat with MatterLink and MatterBridge creates a unified communication hub that keeps everyone connected, no matter where they are. With easy configuration, robust permission controls, and the ability to expand commands endlessly, it is a must-have for any server owner looking to break down platform barriers.