Compatibility
Minecraft: Java Edition
Platforms
Creators
Details
๐ DiscordStats โ Discord Bot Embedded in Your Server
DiscordStats embeds a fully functional Discord bot directly into your Folia/Paper plugin. Drop a single .jar into your plugins/ folder โ no Node.js, no secondary HTTP server, no separate script to run.
๐ Description
DiscordStats bridges your Minecraft server and your Discord community in the simplest way possible. All data is read live from Bukkit on every command โ nothing is stored in memory between calls. Your players and admins can query the server directly from Discord using three slash commands, at any time, without ever opening the game.
The plugin uses JDA 5 (Java Discord API) bundled into the jar via Maven Shade. Communication between the JDA thread and Folia's main thread is handled through a CompletableFuture with a configurable timeout, preventing any silent deadlock.
โจ Features
- ๐ค Embedded Discord bot โ fully self-contained, no external runtime needed
- ๐ก Live data โ all stats are fetched directly from Bukkit on every request
- โก Folia-safe โ uses
GlobalRegionScheduler, no thread violations - ๐ Slash commands registered automatically on startup
- ๐ค Offline player stats supported โ no need to be online
- ๐ TPS reported over 1min, 5min, 15min
- ๐ Hot reload via
/dstats reloadโ no restart needed - ๐จ Adventure API โ no deprecated
ChatColor - ๐ฌ Rich colored Discord embeds
- โฑ๏ธ 5s timeout if the server is under load โ no silent freeze
๐ฌ Discord Slash Commands
| Command | Description |
|---|---|
/server |
TPS, memory usage, uptime and world info |
/players |
Online players list with world and ping |
/stats <player> |
Full stats for any player, online or offline |
๐ In-game Commands
| Command | Description |
|---|---|
/dstats reload |
Hot reload the plugin configuration |
โ๏ธ Configuration
discord:
token: "" # Your Discord bot token
guild-id: "" # Your Discord server ID
timeout: 5 # Timeout in seconds for Bukkit thread calls
Setup:
- Go to discord.dev/applications and create a new application
- Add a bot, enable the required intents, and copy the token
- Paste the token and your guild ID in
config.yml - Restart or run
/dstats reload - Slash commands will register automatically
๐ฅ๏ธ Compatibility
| Platform | Version |
|---|---|
| Paper | 1.21.x |
| Folia | 1.21.x |
| Java | 21+ |
| API | Paper API 1.21.1-R0.1-SNAPSHOT |
๐ฆ Installation
- Download the plugin
- Place it in your server's
plugins/folder - Restart the server
- Configure
plugins/DiscordStats/config.ymlwith your bot token and guild ID - Slash commands are registered automatically โ no manual setup needed