Lan’s Easy Discord: Bridge+

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