DuckyColorMix ?
一款面向 Paper 1.18.2+ 的竞技类小游戏插件,提供基于动态色彩的生存玩法,并完整支持 Paper Adventure API。?
功能 ✨
- ? 高级文本格式化 - 完整支持 Paper Adventure API,包括十六进制颜色、渐变和彩虹效果
- ? MiniMessage 格式 - 现代文本格式化(
<red>、<gradient>、<rainbow>)
- ⚡ 动态玩法 - 当仅剩一名玩家时游戏可立即结束
- ⏱️ 可配置倒计时 - 倒计时时间递减,间隔可自定义
- ? 实时玩家追踪 - 统计游戏区域内的玩家数量(平台上方 5 格范围内)
- ? 随机羊毛颜色 - 生成带有随机羊毛方块的多彩平台
- ?️ 安全颜色系统 - 仅一种颜色保持安全,其他颜色消失
- ? 平台再生 - 轮次之间及游戏结束后自动重置平台
- ? 即时胜利检测 - 仅剩一名玩家时游戏立即结束
- ? 胜利庆祝 - 为获胜者播放 5 秒烟花特效
- ⏸️ 暂停/恢复系统 - 完整的游戏状态管理
- ? 更新检查器 - 自动检查 GitHub 发布版本
命令 ?
| 命令 |
描述 |
权限 |
/colormix start [seconds] [change_every_rounds] |
? 开始新游戏 |
duckycolormix.colormix |
/colormix stop |
? 停止当前游戏 |
duckycolormix.colormix |
/colormix pause / /colormix pause |
⏸️ 暂停游戏 |
duckycolormix.colormix |
/colormix resume / /colormix resume |
▶️ 恢复暂停的游戏 |
duckycolormix.colormix |
/colormix setplatform |
?️ 设置平台区域 |
duckycolormix.colormix |
/colormix reload |
? 重载插件配置 |
duckycolormix.colormix |
别名: /cm, /dcm /duckycolormix ?
1. 设置平台 ?️
/colcolor setplatform
点击两个对角以定义平台区域。?️
2. 开始游戏 ?
/colormix start
/colormix start 10 2
- 默认:5 秒倒计时,每 3 轮减少一次 ⏰
- 自定义:10 秒倒计时,每 2 轮减少一次 ?
3. 游戏控制 ?️
/colormix pause # ⏸️ 暂停游戏
/colormix resume # ▶️ 恢复游戏
/colormix stop # ? 停止游戏
玩法说明 ?
- ?️ 平台设置 - 管理员使用
/colormix setplatform 设置平台区域
- ? 开始游戏 - 管理员使用可自定义的倒计时设置启动游戏
- ? 回合开始 - 平台填充随机颜色的羊毛方块
- ?️ 安全颜色 - 随机选择一种颜色作为“安全色”(在动作栏显示)
- ⏱️ 倒计时 - 玩家必须在限定时间内站在安全颜色上
- ? 方块移除 - 倒计时结束后,所有不安全颜色消失
- ? 胜利条件:
- 当平台上仅剩 1 名玩家时,游戏立即结束 ⚡
- 获胜者获得 5 秒烟花庆祝 ?
- 如果没有任何玩家剩余,游戏结束且无胜者 ?
- ? 下一回合 - 如果有 2 名或更多玩家剩余,则开始新一轮,倒计时更短
配置 ⚙️
插件在 config.yml 中提供了丰富的配置选项:?
游戏设置 ?
game:
default-starting-seconds: 5 # ⏰ 初始倒计时时间
default-change-every-rounds: 3 # ? 倒计时减少前的回合数
minimum-countdown: 1 # ⏱️ 最小倒计时时间
round-delay: 60 # ⏳ 回合间延迟(刻)
fireworks-duration: 5 # ? 获胜者庆祝持续时间
fireworks-per-second: 5 # ? 烟花强度
消息自定义 ?
所有消息均支持:
- ? 传统颜色代码 (
&a, &c 等)
- ? 十六进制颜色 (
#FF0000, #00FF00 等)
- ✨ MiniMessage (
<red>, <gradient:#FF0000:#00FF00>, <rainbow>)
示例:
messages:
winner-announcement: "<rainbow><bold>? {player} won DuckyColorMix! ?</bold></rainbow>"
safe-color: "<gradient:#FFFF00:#FFD700>Safe color: <bold>{color}</bold></gradient>"
颜色名称 ?
为不同语言自定义颜色名称:
colors:
WHITE: "WHITE"
RED: "RED"
BLUE: "BLUE"
# ... 等等
权限 ?
| 权限 |
描述 |
默认值 |
duckycolormix.colormix |
? 管理 DuckyColorMix 游戏 |
op |
duckycolormix.update |
? 接收更新通知 |
op |
技术细节 ?
游戏区域检测 ?
- 当玩家在平台边界内时被视为“在游戏中” ?️
- 检测区域延伸至平台上方 5 格 ?
- 每个游戏刻实时统计玩家数量 ⚡
平台系统 ?️
- 支持任何矩形区域 ?
- 自动生成 16 种不同颜色的羊毛 ?
- 智能方块移除系统 ?
- 回合间平台再生 ?
性能 ⚡
- 针对 Paper API 优化 ?
- 对服务器影响极小 ?
- 高效的玩家检测 ?
- 异步更新检查 ?
API 信息 ?️
Paper Adventure API ?
本插件充分利用 Paper 的 Adventure API 实现:
- 基于组件的文本处理 ?
- 原生十六进制颜色支持 ?
- MiniMessage 解析 ✨
- 动作栏动画 ?
- 现代文本格式化 ?
兼容性 ?
- 最低要求: Paper 1.18.2 ?
- 推荐版本: Paper 1.19+ ⭐
- Java 版本: 21+ ☕
- 不兼容 PlugMan(及其分支) ❌
支持与更新 ?
自动更新 ?
插件在启动时会自动检查更新,并向管理员通知新版本。?
手动检查更新 ?
更新可在 GitHub Releases / Discord / Modrinth 页面获取。?
问题与建议 ?
请在 GitHub Issues 页面报告问题或提出功能建议。?
许可证 ?
本项目采用 GNU 通用公共许可证授权 - 详见 LICENSE WIKI SITE site。⚖️
致谢 ??
作者: Barpad ??
版本: 1.0.0 ?️
API: Paper Adventure API ?
Minecraft 版本: 1.18.2+ ?
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 ✨
- ? Advanced Text Formatting - Full Paper Adventure API support with hex colors, gradients, and rainbow effects
- ? MiniMessage Format - Modern text formatting (
<red>, <gradient>, <rainbow>)
- ⚡ Dynamic Gameplay - Games can end instantly when only one player remains
- ⏱️ Configurable Countdown - Decreasing countdown time with customizable intervals
- ? Real-time Player Tracking - Counts players in the game area (5 blocks above platform)
- ? Random Wool Colors - Generates colorful platforms with random wool blocks
- ?️ Safe Color System - One color remains safe while others disappear
- ? Platform Regeneration - Automatic platform reset between rounds and after games
- ? Instant Win Detection - Game ends immediately when one player remains
- ? Winner Celebration - 5-second fireworks display for the victor
- ⏸️ Pause/Resume System - 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 ?
- ?️ Platform Setup - Admin sets the platform area using
/colormix setplatform
- ? Game Start - Admin starts the game with customizable countdown settings
- ? Round Begins - Platform fills with random colored wool blocks
- ?️ Safe Color - A random color is chosen as "safe" (displayed in action bar)
- ⏱️ Countdown - Players have limited time to stand on the safe color
- ? Block Removal - All unsafe colors disappear after countdown
- ? Win Conditions:
- 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 ?
- ? Next Round - If 2+ players remain, new round starts with shorter countdown
Configuration ⚙️
The plugin features extensive configuration options in config.yml: ?
Game Settings ?
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:
- ? Legacy colors (
&a, &c, etc.)
- ? Hex colors (
#FF0000, #00FF00, etc.)
- ✨ MiniMessage (
<red>, <gradient:#FF0000:#00FF00>, <rainbow>)
Example:
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:
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 ?
- Minimum: Paper 1.18.2 ?
- Recommended: Paper 1.19+ ⭐
- Java: 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 ??
Author: Barpad ??
Version: 1.0.0 ?️
API: Paper Adventure API ?
Minecraft Version: 1.18.2+ ?
DuckyColorMix - Where colors decide your fate! ???
评论 0
登录后参与评分
还没有评论,来抢沙发吧