Why ZDiscord?
Uses JDA 5 with real slash commands and button interactions. Works on Paper, Folia, and Spigot — no extra setup per platform. Pick from 15+ modules in config; flip off whatever you won't use.
Features
- Chat bridge — Two-way chat between Minecraft and Discord. Webhooks display player heads as avatars. Linked players show their Discord name and avatar.
- Server status — One Discord message that auto-updates with player count, TPS, and memory usage.
- Console streaming — Server log lines forwarded to a Discord channel.
- Account linking — One-time codes link Discord and Minecraft accounts. Enforce link-to-join if you want.
- Staff chat —
/sc toggles a staff-only channel bridged to Discord.
- Tickets — Players open private support channels via a Discord button or
/ticket.
- Leaderboards — Kills, deaths, and playtime ranked via
/leaderboard.
- Event messages — Joins, quits, deaths, and advancements posted to Discord.
- Performance monitor — TPS and memory tracked over time with configurable alerts.
- Anti-raid — Mass-join detection with optional automatic lockdown.
- Command logger — Watched and critical commands posted to a staff channel.
- Voice status — Linked players get a tab-list indicator while in a tracked Discord voice channel.
- Reaction roles — Map message reactions to Discord roles and in-game permissions.
- Player profiles —
/profile [player] renders a rich embed with avatar, NameMC link, stats, and a follow button.
- Follow system — Follow players to get DM notifications when they join.
/following and /unfollow manage subscriptions.
- Anonymous confessions —
/confess posts to a dedicated channel with rate limiting and configurable appearance.
- Setup wizard —
/setup configures channels from Discord with dropdowns and buttons.
Requirements
- Java 17 or newer
- Paper 1.20.4 or newer, Folia, or Spigot 1.20.4 or newer
- A Discord bot token with Server Members and Message Content intents enabled
Installation
- Download
ZDiscord-1.2.0.jar from the releases page.
- Place the JAR in your server's
plugins/ directory.
- Start the server to generate the default
config.yml and messages.yml.
- Open
plugins/ZDiscord/config.yml and set:
bot.token — your bot tokenbot.guild-id — your Discord server IDchannels.chat — the channel ID for chat bridge
- Restart the server.
- Run
/setup in Discord to configure the remaining channels.
Configuration
All configuration lives in plugins/ZDiscord/config.yml. User-facing strings are in messages.yml. See the wiki for a full reference.
License
Apache License 2.0
Project links
