Requirements
- Fabric Loader 0.15.0+
- Fabric API
Planned Features
- Stats Tracker — query a player's in-game stats (blocks mined, mobs killed, deaths, playtime, etc.) directly from Discord
- Advancements Scoreboard — view and compare completed advancements for any player through Discord
- Player Checker — see who's currently online on the server without having to open Minecraft
- More Platform Support — ports for Spigot/Paper and other mod loaders such as Forge and NeoForge are planned for future releases
Current Features
Chat Bridge
- Messages sent in Minecraft appear in Discord, and messages sent in Discord appear in Minecraft
Player Events
- Join and leave notifications
- Death messages with 🪦 for regular deaths and ⚔️ for PvP kills
- Advancement notifications
Bot Status
- Bot presence shows live player count (e.g.
3/20 players online) - Channel topic shows server online status and uptime (e.g.
🟢 Server Online | Online since: 2026-04-19 03:46 UTC | Crashes: 2) - Channel topic switches to
🔴 Server is offline | Crashes: Xwhen the server stops
Crash & Lag Alerts
- Pings a configurable role when the server crashes — works even on watchdog kills
- Pings a configurable role when the server logs
Can't keep up!with a 60 second cooldown to prevent spam - Crash counter persists across restarts
Whitelist Command
/whitelist add <username>— anyone in the whitelist channel can add themselves/whitelist remove <username>— restricted to users with the configured alert role
Setup
1. Create a Discord Bot
- Go to https://discord.com/developers/applications and create a new application
- Go to the Bot tab and click Add Bot
- Under Privileged Gateway Intents, enable Message Content Intent
- Copy your bot token — you'll need it for the config
- Invite the bot to your server with the
botandapplications.commandsscopes, and give it permissions to read/send messages and manage channel topics (not reccomended but if you can give admin to the bot if you face any issues)
2. Configure the Mod
After running the server once, a config file will be generated at config/discordfabric.json. Fill in your values:
Config Fields
botToken— Your Discord bot tokenchatChannelId— Channel ID for the chat bridge and general notificationswhitelistChannelId— Channel ID where/whitelistcommands are allowedalertRoleId— Role ID to ping for crash and lag alerts. Also controls who can use/whitelist remove
Getting IDs
You need Developer Mode enabled in Discord to copy IDs. Go to Settings → Advanced → Developer Mode, then right-click any channel or role and click Copy ID.
Customizing Messages
All message templates in the messages section are fully customizable. Available placeholders:
{player}— join, leave, death messages{message}— chat bridge{user}— Discord → Minecraft{online}— botStatus{max}— botStatus{online_since}— channelTopic{crashes}— channelTopic{advancement}— playerAdvancement
