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