# 🎉 BlockParty
*Dance across colorful blocks and don't fall when the floor drops!*
## ✨ Overview
BlockParty is a fast, musical-chairs style party mini-game played on a colorful wool floor. Each round a color is called and the rest of the floor drops away — players have to scramble onto the matching blocks before time runs out, or they're eliminated. Rounds get quicker and the floor rebuilds between them until one champion is left dancing. Just join, wait for enough players, and start the party.
## 📦 Installation
1. Drop `BlockParty.jar` into your server's `/plugins` folder.
2. Restart the server.
3. Set up your arena floor in `config.yml`. BlockParty targets Minecraft **1.21** (api-version 1.21).
## ⌨️ Commands
| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/bp` | BlockParty commands. Usage: `/bp <join\|leave\|start>` | `blockparty` | _none defined_ |
## ⚙️ Configuration
Key `config.yml` options:
- **`messages.prefix`** — Chat prefix for plugin messages.
- **`arena.world` / `center-x` / `center-z` / `floor-y` / `floor-size`** — Location and size of the colorful dance floor.
- **`game.min-players`** — Minimum players needed to start (default `2`).
- **`game.round-seconds`** — Seconds players have to reach the safe color each round (default `8`).
- **`game.drop-delay-ticks`** — Delay before the non-matching floor drops away.
- **`game.between-rounds-ticks`** — Pause used to rebuild the floor between rounds.
- **`game.colors`** — The list of wool colors used for the floor (e.g. `RED_WOOL`, `BLUE_WOOL`, `LIME_WOOL`…).
## 📖 Full documentation
---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
