ZDiscord

!(https://cdn.modrinth.com/data/cached_images/33a9a847d3ee1a2295ba0b959e1e3548f73c5c61.png)

### 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 ` 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

1. Download `ZDiscord-1. 2. 0.jar` from the releases page. 2. Place the JAR in your server's `plugins/` directory. 3. Start the server to generate the default `config.yml` and `messages.yml`. 4. Open `plugins/ZDiscord/config.yml` and set: - `bot.token` — your bot token - `bot.guild-id` — your Discord server ID - `channels.chat` — the channel ID for chat bridge 5. Restart the server. 6. 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.

## Sponsored by Nexeu Hosting

[!(https://whodoesntloveavatars.s3.fra.databucket.eu/assets/promo.png)](https://nexeu.zip/)

High-performance, affordable hosting for your Minecraft server. Premium hardware, instant setup, 24/7 support.

• *(https://nexeu.zip/)**
• ### License

Apache License 2. 0

## Project links

• Source: https://github.com/DemonZ-Development/ZDiscord
• Issues: https://github.com/DemonZ-Development/ZDiscord/issues
• Wiki: https://github.com/DemonZ-Development/ZDiscord/wiki