Перейти к содержимому
Mineforgian

ZDiscord

ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways, players see server status from Discord, and staff manage tickets from a dropdown panel.

Загрузки
122
Подписчики
6
Обновлён
27 июня 2026 г.
Лицензия
Apache-2.0

Опубликован 15 февраля 2026 г.

Исходный код

banner

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

  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.

License

Apache License 2.0

Project links

Ченджлог

1.2.0Релиз26.1.1, 26.1.2, 26.2 · 27 июня 2026 г.

[1.2.0] - 2026-06-16

Added

  • Developer API (ZDiscordAPI, ZDiscordProvider, Bukkit events) for third-party plugins.
  • Interactive leaderboards with medals, head thumbnails, pagination, and stat-switcher dropdown.
  • Auto-updating leaderboard panel in a configurable channel.
  • Centralized logger (ZLogger) with 9 categories, 6 levels, compact format.
  • /profile [player] — player card with avatar, NameMC link, stats, and follow button.
  • /seen <player] — last-seen lookup with online status, playtime, sessions.
  • /following and /unfollow <player> — manage follow subscriptions from Discord.
  • /confess <message> — anonymous confessions with cooldown and configurable color.
  • Achievement rarity badges ("First of the day", rare advancement threshold).
  • Player activity storage (last_seen, first_join, sessions, advancement unlocks, follows).
  • ColorUtil.toDiscordMarkdown() for &l, &o, &n, &m conversion.
  • FollowModule — in-memory cache with non-blocking DM dispatch.
  • PlayerProfileBuilder for profile card embeds with Discord username resolution.
  • In-game /confess <message> command for anonymous confessions.

Changed

  • config-version bumped to 6. Default avatar changed to mc-heads.net.
  • HeadUtil rewritten for mc-heads.net with avatar(), body(), combo().
  • Storage backends gained 12 new methods for activity, advancements, and follows.
  • AdvancementListener persists unlocks, reads rarity stats async, guards against duplicates.
  • UpdateChecker interval 6h → 5h. Silent Discord notice fires once per release.
  • JoinQuitListener writes last_seen and increments sessions on every join/quit.
  • First-join detection uses storage instead of player.hasPlayedBefore().

Fixed

  • SetupCommand "Loading options failed" bug and NPE on removed ticket categories.
  • JoinQuitListener null-safe bot connection checks.
  • /seen avatar resolution and "never joined" message.
  • FollowModule.onPlayerJoin no longer blocks scheduler thread.
  • MySQLStorage.isFollowing uses SELECT COUNT(*) instead of fetching all followers.
  • Profile card shows actual Discord username instead of raw ID.
  • Confession handles use monotonic counter instead of hash % 10000.
  • Confession embeds use a real love-letter emoji instead of a Discord shortcode.
  • Stat update events match the calling thread, fixing Paper quit-event crashes.
  • JDA SLF4J provider packaging fixed so startup does not use the fallback logger.
  • Ticket setup now uses the guided /setup wizard only and posts a ticket-specific setup flow.
  • Ticket creation ignores placeholder support-role IDs instead of aborting channel creation.
  • Setup and follow buttons use real emoji instead of Discord shortcode text.
  • Ticket panel dropdown values now submit category IDs instead of display labels.
  • /panel no longer crashes in thread or forum channels.
  • UpdateChecker Discord announcement retries on failure.
1.0.0Релиз1.21.11, 26.1, 26.1.1 · 2 апреля 2026 г.

Initial release

Комментарии

Загружаем…