DuckyColorMix

DuckyColorMix 🦆

A competitive mini-game plugin for Paper 1.18.2+ featuring dynamic color-based survival gameplay with full Paper Adventure API support. 🎮

Features ✨

- 🔔 Update Checker - Full Paper Adventure API support with hex colors, gradients, and rainbow effects - 🔔 Update Checker - Modern text formatting (`<red>`, `<gradient>`, `<rainbow>`) - 🔔 Update Checker - Games can end instantly when only one player remains - 🔔 Update Checker - Decreasing countdown time with customizable intervals - 🔔 Update Checker - Counts players in the game area (5 blocks above platform) - 🔔 Update Checker - Generates colorful platforms with random wool blocks - 🔔 Update Checker - One color remains safe while others disappear - 🔔 Update Checker - Automatic platform reset between rounds and after games - 🔔 Update Checker - Game ends immediately when one player remains - 🔔 Update Checker - 5-second fireworks display for the victor - 🔔 Update Checker - Full game state management - 🔔 Update Checker - Automatic GitHub release checking

Commands 💻

| Command | Description | Permission | |---------|-------------|------------| | `/colormix start [seconds] [change_every_rounds]` | 🚀 Start a new game | `duckycolormix.colormix` | | `/colormix stop` | 🛑 Stop the current game | `duckycolormix.colormix` | | `/colormix pause` / `/colormix pause` | ⏸️ Pause the game | `duckycolormix.colormix` | | `/colormix resume` / `/colormix resume` | ▶️ Resume the paused game | `duckycolormix.colormix` | | `/colormix setplatform` | 🏗️ Set up the platform area | `duckycolormix.colormix` | | `/colormix reload` | 🔄 Reload plugin configuration | `duckycolormix.colormix` |

Aliases: `/cm`, `/dcm` `/duckycolormix` 🔗

1. Set Up Platform 🏗️

``` /colormix setplatform ``` Click two opposite corners to define the platform area. 🖱️

2. Start a Game 🎮

``` /colormix start /colormix start 10 2 ``` - Default: 5 seconds countdown, decreases every 3 rounds ⏰ - Custom: 10 seconds countdown, decreases every 2 rounds 🎯

3. Game Controls 🎛️

``` /colormix pause # ⏸️ Pause the game /colormix resume # ▶️ Resume the game /colormix stop # 🛑 Stop the game ```

How to Play 🎯

1. 🔄 Next Round - Admin sets the platform area using `/colormix setplatform` 2. 🔄 Next Round - Admin starts the game with customizable countdown settings 3. 🔄 Next Round - Platform fills with random colored wool blocks 4. 🔄 Next Round - A random color is chosen as "safe" (displayed in action bar) 5. 🔄 Next Round - Players have limited time to stand on the safe color 6. 🔄 Next Round - All unsafe colors disappear after countdown 7. 🔄 Next Round: - Game ends instantly when only 1 player remains on platform ⚡ - Winner gets 5-second fireworks celebration 🎆 - If no players remain, game ends with no winner 😢 8. 🔄 Next Round - If 2+ players remain, new round starts with shorter countdown

Configuration ⚙️

The plugin features extensive configuration options in `config.yml`: 📝

Game Settings 🎮

```yaml game: default-starting-seconds: 5 # ⏰ Initial countdown time default-change-every-rounds: 3 # 📊 Rounds before countdown decreases minimum-countdown: 1 # ⏱️ Minimum countdown time round-delay: 60 # ⏳ Delay between rounds (ticks) fireworks-duration: 5 # 🎆 Winner celebration duration fireworks-per-second: 5 # 🎇 Fireworks intensity ```

Message Customization 💬

All messages support: - ✨ MiniMessage (`&a`, `&c`, etc.) - ✨ MiniMessage (`#FF0000`, `#00FF00`, etc.) - ✨ MiniMessage (`<red>`, `<gradient:#FF0000:#00FF00>`, `<rainbow>`)

Example: ```yaml messages: winner-announcement: "<rainbow><bold>🎉 {player} won DuckyColorMix! 🎉</bold></rainbow>" safe-color: "<gradient:#FFFF00:#FFD700>Safe color: <bold>{color}</bold></gradient>" ```

Color Names 🌈

Customize color names for different languages: ```yaml colors: WHITE: "WHITE" RED: "RED" BLUE: "BLUE"

... etc

```

Permissions 🔐

| Permission | Description | Default | |------------|-------------|---------| | `duckycolormix.colormix` | 🎮 Manage DuckyColorMix games | `op` | | `duckycolormix.update` | 🔔 Receive update notifications | `op` |

Technical Details 🔧

Game Area Detection 📍

- Players are considered "in game" when within platform boundaries 🏗️ - Detection area extends 5 blocks above the platform 📏 - Real-time player counting every game tick ⚡

Platform System 🏗️

- Supports any rectangular area 📐 - Automatic wool generation with 16 different colors 🌈 - Smart block removal system 💥 - Platform regeneration between rounds 🔄

Performance ⚡

- Optimized for Paper API 🚀 - Minimal server impact 💪 - Efficient player detection 🎯 - Asynchronous update checking 🔄

API Information 🛠️

Paper Adventure API 📚

This plugin fully utilizes Paper's Adventure API for: - Component-based text handling 📝 - Native hex color support 🎨 - MiniMessage parsing ✨ - Action bar animations 📊 - Modern text formatting 💫

Compatibility 🔗

- NOT compatible Paper 1.18.2 📋 - NOT compatible Paper 1.19+ ⭐ - NOT compatible 21+ ☕ - NOT compatible with PlugMan(and forks) ❌

Support & Updates 🆘

Automatic Updates 🔄

The plugin automatically checks for updates on startup and notifies administrators about new releases. 📢

Manual Update Check 📥

Updates are available on the GitHub Releases / Discord / Modrinth page. 🔗

Issues & Suggestions 🐛

Report issues or suggest features on the GitHub Issues page. 💡

License 📄

This project is licensed under the GNU General Public License - see the LICENSE WIKI SITE site for details. ⚖️

Credits 👨‍💻

Minecraft Version: Barpad 🧑‍💻 Minecraft Version: 1.0.0 🏷️ Minecraft Version: Paper Adventure API 📚 Minecraft Version: 1.18.2+ 🎮

---

*DuckyColorMix - Where colors decide your fate!* 🎨🏆🦆