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: X when 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 bot and applications.commands scopes, 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 token
chatChannelId — Channel ID for the chat bridge and general notifications
whitelistChannelId — Channel ID where /whitelist commands are allowed
alertRoleId — 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

Lan’s Easy Discord: Bridge+