Lan’s Easy Discord: Bridge+

Requirements

- Fabric Loader 0.15.0+ - Fabric API

---

Planned Features

- More Platform Support — query a player's in-game stats (blocks mined, mobs killed, deaths, playtime, etc.) directly from Discord - More Platform Support — view and compare completed advancements for any player through Discord - More Platform Support — 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 Message Content Intent tab and click Message Content Intent - Under Message Content Intent, 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 Copy ID enabled in Discord to copy IDs. Go to Copy ID, 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