# BlockDrop | The Professional TNT-Run Experience [1.13–1.26.1.2+]

---

## Introduction
**BlockDrop** is a high-performance, feature-rich mini-game plugin designed to offer a seamless and lag-free "TNT-Run" style experience. We focused on the architecture to ensure that even on massive servers with hundreds of active arenas, the TPS remains stable. Unlike traditional plugins that constantly manipulate large chunks of the world, **BlockDrop** uses a unique, lightweight event-tracking system.

Whether you are a veteran server owner or starting your first network, this plugin brings professional-grade stability to your minigame library.

---

## Why Choose BlockDrop?

* **Extreme Optimization:** Our "Smart-Batch" restoration engine prevents server lag. Instead of scanning entire regions, we only track and restore the specific blocks that were interacted with during the game.
* **Native GeyserMC Support:** We have rigorously tested BlockDrop with Bedrock players via GeyserMC. All scoreboards, custom GUI menus, and inventory interactions work flawlessly across all platforms.
* **Anti-Camp Technology:** Does your game get boring because players are just standing still? BlockDrop forces players to move by detecting blocks beneath them every few ticks, ensuring the game pace stays fast and intense.
* **Zero Data Loss:** We take the security of your players' inventories seriously. Before a match, we perform a deep-copy backup of their items, armor, and status, ensuring they receive their gear back exactly as it was, even if the server restarts during a match.
* ️ **Self-Correcting System:** The plugin is designed with extreme fault-tolerance. From validating command arguments to handling unexpected player disconnects during the countdown, BlockDrop manages game states gracefully without throwing console errors.

---

## ⚙️ Key Technical Features

* **Dynamic Block States:** Green ➔ Yellow ➔ Red ➔ Air (fully configurable timings).
* **Smart Lobby:** Automatically generates a "Leave" bed in the player's 9th slot for an intuitive exit experience.
* **Custom GUI:** A sleek, red-wool-based menu for players to safely confirm their exit from the game.
* **Global Game Management:** Integrated state machine (Lobby → InGame → Cooldown → Reset).
* **Automatic Cleanup:** Arena reset is handled via a throttled, low-impact task that restores blocks in small batches to preserve server performance.

---

## ️ Commands & Permissions

### Player Commands (`bd.player` - Default: True)
* `/bd join [arena]` — Join the waiting lobby for a specific arena.
* `/bd leave` — Safely exit the current game, remove your player data, and return to your `return` point.

### Admin Commands (`bd.admin` - Default: OP)
* `/bd help` — Access the administrative help menu.
* `/bd create [name]` — Register a new game arena.
* `/bd [name] pos1` / `/bd [name] pos2` — Define the corners of the play area.
* `/bd [name] setlobby` — Define the staging area for waiting players.
* `/bd [name] setspawn` — The location where players start when the game begins.
* `/bd [name] setreturn` — The safe zone players return to after the game.
* `/bd [name] setspectator` — The viewing area for those who have been eliminated.

---

## Installation & Setup

1. **Drop & Run:** Simply place the `BlockDrop.jar` into your `/plugins` folder and restart your server.
2. **Arena Creation:** Run `/bd create [ArenaName]`.
3. **Define Bounds:** Stand at corner A and use `/bd [ArenaName] pos1`, then repeat for corner B with `/bd [ArenaName] pos2`.
4. **Set Waypoints:** Set your Lobby, Spawn, Return, and Spectator points using the commands listed above.
5. **Permissions:** Ensure your permissions plugin (e.g., LuckPerms) has `bd.player` set for your users and `bd.admin` for staff.

---

## Developer & System Requirements

* **API:** Built against the latest PaperMC API for maximum performance.
* **Compatibility:** 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22, 1.23, 1.24, 1.25, 1.26.1.2+.
* **Dependencies:** None! (Works standalone).

---

## Support & Feedback
We are committed to providing the best experience possible. If you find a bug or have a feature request, please join our community Discord server (link here) or reach out via the Spigot discussion tab. Your feedback drives our development!

*Enjoyed the plugin? Please consider leaving a ⭐⭐⭐⭐⭐ review!*