ModsJava
TheBug
Visual bug reports with action history, YAML storage and optional Discord webhooks.
⬇ Download on Spigot
TheBug
A clean, visual bug-reporting system for modern Paper servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Turn player reports into useful, actionable information. TheBug captures the exact context behind every report and gives your staff a polished in-game interface to review, locate and manage issues — without requiring a database, web panel or Discord bot.
A clean, visual bug-reporting system for modern Paper servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Turn player reports into useful, actionable information. TheBug captures the exact context behind every report and gives your staff a polished in-game interface to review, locate and manage issues — without requiring a database, web panel or Discord bot.
CORE FEATURES
- Fast player reports — Create a complete report with /bug <description>.
- Automatic report IDs — Every bug receives a unique numeric identifier.
- Complete player context — Captures player name, UUID, world, coordinates, rotation, date, time and game mode.
- Recent action history — Stores the latest 14 block breaks, placements and interactions.
- Polished inventory GUI — Browse reports and inspect every detail from a clean, centered menu.
- Visual action timeline — Block interactions use clear item icons, including signs for interaction events.
- Instant teleportation — Authorized staff can jump directly to the reported location.
- Safe report deletion — Remove resolved or invalid reports with a confirmation step.
- YAML persistence — Reports remain available after restarts with no database required.
- Multi-language support — English and Spanish included, with automatic client-language detection.
- Optional Discord webhooks — Send configurable embeds with report details and the reporting player's skin.
- Live configuration reload — Reload configuration, languages and Discord settings with /bugr.
STAFF WORKFLOW
Players submit a problem in seconds. TheBug records where they were, what game mode they used and what they did immediately before the report. Staff can then open the dashboard, inspect the evidence, teleport to the location and delete the report when it is resolved.
No external panel is needed. Everything can be handled directly in Minecraft.
DISCORD INTEGRATION
Discord support is completely optional and disabled by default. When enabled, TheBug sends asynchronous webhook embeds containing the report ID, description, player information, location and a skin thumbnail. Embed color, content, avatar and other presentation options can be customized in discord.yml.
COMMANDS
Code (Text):
/bug <description> - Create a bug report
/bugs - Open the report dashboard
/bug delete <id> - Delete a report
/bugr - Reload configuration, languages and Discord
Code (Text):
thebug.use
thebug.list
thebug.teleport
thebug.delete
thebug.reload
- config.yml — General settings and report limits.
- discord.yml — Optional webhook and embed customization.
- lang/en_US.yml — Editable English messages.
- lang/es_ES.yml — Editable Spanish messages.
- bugs.yml — Persistent report storage.
REQUIREMENTS
- Server software: Paper 1.21.x
- Tested version: Paper 1.21.8
- Java: 21 or newer
- Database: Not required
- Resource pack: Not required
- Discord bot: Not required
INSTALLATION
- Place TheBug-1.0.0.jar inside your server's plugins folder.
- Restart the server.
- Customize the files inside plugins/TheBug/.
- Optionally enable and configure the Discord webhook in discord.yml.
TheBug is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 2 times (via Spigot). Download it and open it directly in the game.