Skip to main content

Discord Integration

The NapMC bot keeps Minecraft and Discord in sync so you never miss action.

Live Relays​

  • Chat mirror — All public chat is echoed to Discord via webhook (mentions are sanitized). Discord replies route back in game with name + avatar.
  • Join/leave/death/advancement — Embedded messages with player heads, respecting vanish and nicknames.
  • Season gate — Relays activate only after the configured season start so pre-season prep stays quiet.
  • Console & anti-cheat feeds — Private staff channels receive console output, anti-cheat alerts, and chunk-ban notices.

Season Event Sync​

A background sync (see DiscordEventSyncManager) publishes every scheduled event (launch, tracking days, gauntlet, etc.) to Discord “Server Events”. Updates happen automatically every few minutes, and once an event has started the bot avoids overwriting manual tweaks. Use the events panel to subscribe for reminders.

Slash Commands​

You must link your Minecraft account with /discord link <code> before using slash commands.

  • /stats <player> — Current season kills, deaths, K/D.
  • /lifestats <player> — Lifetime stats import (when enabled).
  • /tier set|remove|list … — Manage the public tier board (restricted to staff or the configured tester role). See Tiers Platform for data flow.
  • /playerlist — Online players + the countdown to season start if it has not begun.
  • /link /unlink /who — Manage account linking in DMs.

Automation Notes​

  • Announcement channel IDs, tier API endpoint, and allowed roles are configured in config.yml under the Discord section.
  • Web hooks queue bursts to respect rate limits; messages attempted before JDA is ready are cached and replayed once the bot connects.
  • If Discord is unreachable, the bot silently queues and retries so in-game gameplay is never blocked.