🟫 DirtDisposer

DirtDisposer is a lightweight Minecraft plugin that makes dirt-collecting competitions easy to organize. It provides a custom inventory GUI for submitting dirt, automatically tracks player scores, and includes a server-wide leaderboard to see who’s collected the most.

Whether you’re hosting a dirt-collecting event or creating your own leaderboard-based challenge, DirtDisposer handles the submissions and score tracking for you.

✨ Features

🟫 Simple Dirt Submission

Use /dirt to open the custom Dirt Disposal GUI. Place your dirt in the designated slots and close the inventory to submit it. The plugin automatically counts the submitted dirt and adds it to your total.

• Only regular dirt is accepted.
• Invalid items are returned to your inventory.
• If your inventory is full, leftover items are dropped at your location.
• Receive confirmation messages showing your submission and updated total.

🏆 Server-Wide Leaderboard

Want to know who’s collected the most dirt? Use /dleaderboard to view the top 10 players ranked by their total submitted dirt.

The leaderboard automatically sorts players by their recorded totals, making it easy to track progress and compare scores.

🎨 Custom GUI

The Dirt Disposal interface features a clean chest-style layout with a dark green title and a gray stained-glass border.

The decorative border cannot be used for submissions, keeping the designated item slots clear and the submission process straightforward.

💾 Persistent Score Tracking

Player scores are stored locally in a YAML data file and associated with Minecraft UUIDs.

• Scores persist across server restarts.
• Player names are stored for leaderboard display.
• Scores are saved when dirt is submitted and when the plugin shuts down.

Note: Scores currently represent lifetime totals. The plugin does not automatically reset scores between events.

📋 Commands

Command Description /dirt Opens the Dirt Disposal GUI. /dleaderboard Displays the top 10 dirt collectors.

🔐 Permissions

Permission Description dirtdisposer.use Allows access to /dirt. dirtdisposer.leaderboard Allows access to /dleaderboard.

⚙️ Compatibility

• Minecraft: 1.20.x–1.21.x, including 1.21.11
• Server software: Paper, Purpur, Folia, and Spigot (intended compatibility)
• Java: 21 or newer

Compatibility may vary depending on the server software and version.

🚀 Lightweight and Easy to Use

DirtDisposer automates the repetitive parts of running a dirt-collecting competition. Players submit their items through a simple GUI, scores are recorded automatically, and everyone with permission can check the leaderboard.

No external database is required. Just install the plugin, configure the necessary permissions, and start collecting!