RC Cooldown - 高级物品冷却管理插件
? 概述
RC Cooldown 是一款功能强大且灵活的 Spigot 插件,允许服务器管理员为任何 Minecraft 物品、武器和附魔设置自定义冷却时间。支持多种语言、视觉冷却动画以及智能使用检测,该插件为平衡游戏玩法和防止物品滥用提供了全面的解决方案。
✨ 特性
- 通用物品支持:可为任何 Minecraft 物品、武器或附魔设置冷却时间
- 智能使用检测:自动检测物品使用类型(交互、消耗、攻击)并相应应用冷却时间
- 视觉冷却动画:原生 Minecraft 冷却动画(类似末影珍珠),与配置的持续时间匹配
- 附魔支持:可为激流(Riptide)、引雷(Channeling)等附魔设置冷却时间
- 多语言支持:内置英语、俄语、乌克兰语、西班牙语和德语翻译
- 点击类型配置:可选择每个物品的右键或左键激活方式
- 防刷屏保护:冷却消息限制频率以防止聊天刷屏(最多每 3 秒一次)
- 易于配置:简单的 YAML 配置,包含默认示例
- 管理员命令:完整命令套件,无需编辑配置文件即可管理冷却时间
- 自动重载:热重载配置,无需重启服务器
? 使用场景
- PvP 服务器:平衡强力物品如金苹果、末影珍珠和武器
- 生存服务器:防止物品滥用并创造策略性玩法
- 小游戏服务器:在自定义游戏模式中控制物品使用
- KitPvP:通过自定义冷却时间平衡 kit 物品
- 任何服务器:为任何物品添加冷却时间以实现更好的玩法平衡
? 安装
- 从发布页面下载最新版本的 RC Cooldown
- 将
.jar 文件放入服务器的 plugins 文件夹中
- 重启服务器或使用
/reload 命令
- 通过编辑
plugins/RCCooldown/config.yml 配置插件
- 使用
/rccd reload 应用更改
⚙️ 配置
基本配置
打开 plugins/RCCooldown/config.yml:
# Language: EN, RU, UA, ES, DE
lang: EN
items:
# Enchantments
enchantment:riptide:
enable: true
cooldown: 15
click_type: right_click
# Items
ENDER_PEARL:
enable: true
cooldown: 20
click_type: right_click
GOLDEN_APPLE:
enable: true
cooldown: 5
click_type: right_click
配置选项
- lang: 插件消息的语言 (EN, RU, UA, ES, DE)
- enable: 启用或禁用此物品的冷却时间 (true/false)
- cooldown: 冷却持续时间(秒)
- click_type: 鼠标点击类型 (
right_click 或 left_click)
? 添加物品
方法 1:编辑配置文件
- 打开
plugins/RCCooldown/config.yml
- 在
items: 部分下添加你的物品:
items:
DIAMOND_SWORD:
enable: true
cooldown: 10
click_type: right_click
- 保存文件并运行
/rccd reload
方法 2:使用命令(推荐)
使用 /rccd add 命令直接在游戏中的添加物品:
/rccd add <item_id> <click_type> <seconds>
示例:
/rccd add DIAMOND_SWORD right_click 10
/rccd add riptide right_click 15
/rccd add BOW left_click 5
添加附魔
要添加附魔,只需使用附魔名称:
/rccd add riptide right_click 15
/rccd add channeling right_click 10
插件会自动检测 ID 是物品还是附魔——无需前缀!
查找物品 ID
- 使用
/rccd list 查看所有活动的冷却时间
- Minecraft 物品 ID 采用大写加下划线格式(例如
DIAMOND_SWORD, GOLDEN_APPLE)
- 附魔名称为小写(例如
riptide, channeling)
? 命令
| 命令 |
描述 |
权限 |
/rccd reload |
重新加载插件配置 |
rccd.admin(默认为 OP) |
/rccd list |
列出所有活动的冷却时间 |
rccd.admin(默认为 OP) |
/rccd add <id> <click_type> <seconds> |
添加新的冷却时间 |
rccd.admin(默认为 OP) |
/rccd delete <id> |
移除冷却时间 |
rccd.admin(默认为 OP) |
命令示例
/rccd reload # 重新加载配置
/rccd list # 显示所有活动的冷却时间
/rccd add MACE right_click 5 # 为战锤添加 5 秒冷却时间
/rccd delete ENDER_PEARL # 移除末影珍珠的冷却时间
? 语言
该插件支持 5 种语言:
- EN - 英语
- RU - 俄语 (Русский)
- UA - 乌克兰语 (Українська)
- ES - 西班牙语 (Español)
- DE - 德语 (Deutsch)
在 config.yml 中更改语言:
lang: RU # 更改为你喜欢的语言
语言文件会自动创建在 plugins/RCCooldown/lang/ 文件夹中。
? 机制
智能使用检测
插件自动检测物品的使用方式:
- 食物/消耗品:消耗后激活冷却时间
- 武器:成功攻击后激活冷却时间
- 附魔:成功使用附魔后激活冷却时间(例如:激流仅在玩家实际飞行时激活)
- 其他物品:成功交互后激活冷却时间
视觉冷却
- 库存中会出现原生 Minecraft 冷却动画
- 动画持续时间与配置的冷却时间匹配
- 工作方式与末影珍珠冷却动画完全相同
- 在活跃冷却期间,冷却时间不会重置或更新
防刷屏保护
- 冷却消息限制为每 3 秒一次
- 防止玩家在冷却时间内反复点击物品导致聊天刷屏
- 物品使用仍被阻止,但消息频率受到限制
? 优势
1. 灵活性
- 适用于任何 Minecraft 物品、武器或附魔
- 无需修改服务器代码或使用复杂插件
- 易于添加或移除冷却时间
2. 智能检测
- 自动检测物品使用类型
- 无需为不同物品类型手动配置
- 正确处理特殊案例,如激流(Riptide)附魔
3. 用户友好
- 视觉冷却动画,提升用户体验
- 多语言支持,适用于国际服务器
- 清晰、信息丰富的提示消息
4. 性能优化
- 轻量级且经过优化
- 对服务器无性能影响
- 高效的冷却时间追踪
5. 易于管理
- 游戏内命令执行所有操作
- 更改配置无需重启服务器
- 简单的 YAML 配置文件
6. 专业功能
- 限流消息防止刷屏
- 正确的事件处理防止漏洞利用
- 可靠的冷却时间追踪
? 默认设置
插件预配置了热门物品的冷却时间:
- 激流(Riptide)(附魔):15 秒
- 末影珍珠:20 秒
- 金苹果:5 秒
- 附魔金苹果:30 秒
- 烟花火箭:3 秒
- 重锤(Mace):5 秒
您可以根据需要修改或删除这些设置。
? 故障排除
冷却时间不生效?
- 确保配置中
enable: true
- 检查冷却值是否大于 0
- 验证正确的
click_type(右击/左击)
- 配置更改后运行
/rccd reload
消息不是我的语言?
- 检查 config.yml 中的
lang: 设置
- 确认语言文件存在于
plugins/RCCooldown/lang/ 目录中
- 更改语言后运行
/rccd reload
添加物品时找不到物品?
- 使用正确的物品 ID 格式(大写加下划线,如
DIAMOND_SWORD)
- 对于附魔,请使用小写名称(例如
riptide,而非 RIPTIDE)
- 检查拼写——运行
/rccd list 查看示例
? 权限
rccd.admin - 访问所有 /rccd 命令(默认 OP 拥有)
? 更新
该插件正在积极维护和更新。请查看发布页面以获取:
? 支持
如需支持、提交错误或请求新功能,请访问 Discord 上的插件页面。
? 许可证
本插件按原样提供,供 Minecraft 服务器使用。
RC Cooldown - Advanced Item Cooldown Management Plugin
? Overview
RC Cooldown is a powerful and flexible Spigot plugin that allows server administrators to set custom cooldowns on any Minecraft items, weapons, and enchantments. With support for multiple languages, visual cooldown animations, and intelligent use detection, this plugin provides a comprehensive solution for balancing gameplay and preventing item spam.
✨ Features
- Universal Item Support: Set cooldowns on any Minecraft item, weapon, or enchantment
- Smart Use Detection: Automatically detects item usage type (interact, consume, attack) and applies cooldowns accordingly
- Visual Cooldown Animation: Native Minecraft cooldown animation (like Ender Pearls) that matches your configured duration
- Enchantment Support: Set cooldowns on enchantments like Riptide, Channeling, and more
- Multi-Language Support: Built-in translations for English, Russian, Ukrainian, Spanish, and German
- Click Type Configuration: Choose between right-click or left-click activation for each item
- Anti-Spam Protection: Cooldown messages are rate-limited to prevent chat spam (max once per 3 seconds)
- Easy Configuration: Simple YAML configuration with default examples
- Admin Commands: Full command suite for managing cooldowns without editing config files
- Automatic Reload: Hot-reload configuration without server restart
? Use Cases
- PvP Servers: Balance powerful items like Golden Apples, Ender Pearls, and weapons
- Survival Servers: Prevent item spam and create strategic gameplay
- Minigame Servers: Control item usage in custom game modes
- KitPvP: Balance kit items with custom cooldowns
- Any Server: Add cooldowns to any item for better gameplay balance
? Installation
- Download the latest version of RC Cooldown from the releases page
- Place the
.jar file into your server's plugins folder
- Restart your server or use
/reload command
- Configure the plugin by editing
plugins/RCCooldown/config.yml
- Use
/rccd reload to apply changes
⚙️ Config
Basic Configuration
Open plugins/RCCooldown/config.yml:
# Language: EN, RU, UA, ES, DE
lang: EN
items:
# Enchantments
enchantment:riptide:
enable: true
cooldown: 15
click_type: right_click
# Items
ENDER_PEARL:
enable: true
cooldown: 20
click_type: right_click
GOLDEN_APPLE:
enable: true
cooldown: 5
click_type: right_click
Configuration Options
- lang: Language for plugin messages (EN, RU, UA, ES, DE)
- enable: Enable or disable cooldown for this item (true/false)
- cooldown: Cooldown duration in seconds
- click_type: Mouse click type (
right_click or left_click)
? Adding Items
Method 1: Edit Config File
- Open
plugins/RCCooldown/config.yml
- Add your item under the
items: section:
items:
DIAMOND_SWORD:
enable: true
cooldown: 10
click_type: right_click
- Save the file and run
/rccd reload
Method 2: Use Commands (Recommended)
Use the /rccd add command to add items directly in-game:
/rccd add <item_id> <click_type> <seconds>
Examples:
/rccd add DIAMOND_SWORD right_click 10
/rccd add riptide right_click 15
/rccd add BOW left_click 5
Adding Enchantments
To add enchantments, simply use the enchantment name:
/rccd add riptide right_click 15
/rccd add channeling right_click 10
The plugin automatically detects if an ID is an item or enchantment - no prefix needed!
Finding Item IDs
- Use
/rccd list to see all active cooldowns
- Minecraft item IDs are in UPPERCASE_WITH_UNDERSCORES format (e.g.,
DIAMOND_SWORD, GOLDEN_APPLE)
- Enchantment names are lowercase (e.g.,
riptide, channeling)
? Commands
| Command |
Description |
Permission |
/rccd reload |
Reload plugin configuration |
rccd.admin (OP by default) |
/rccd list |
List all active cooldowns |
rccd.admin (OP by default) |
/rccd add <id> <click_type> <seconds> |
Add a new cooldown |
rccd.admin (OP by default) |
/rccd delete <id> |
Remove a cooldown |
rccd.admin (OP by default) |
Command Examples
/rccd reload # Reload configuration
/rccd list # Show all active cooldowns
/rccd add MACE right_click 5 # Add 5-second cooldown to Mace
/rccd delete ENDER_PEARL # Remove Ender Pearl cooldown
? Languages
The plugin supports 5 languages:
- EN - English
- RU - Russian (Русский)
- UA - Ukrainian (Українська)
- ES - Spanish (Español)
- DE - German (Deutsch)
Change language in config.yml:
lang: RU # Change to your preferred language
Language files are automatically created in plugins/RCCooldown/lang/ folder.
? Mechanics
Smart Use Detection
The plugin automatically detects how items are used:
- Food/Consumables: Cooldown activates after consumption
- Weapons: Cooldown activates after successful attack
- Enchantments: Cooldown activates after successful enchantment use (e.g., Riptide only activates when player actually flies)
- Other Items: Cooldown activates after successful interaction
Visual Cooldown
- Native Minecraft cooldown animation appears in the inventory
- Animation duration matches your configured cooldown time
- Works exactly like Ender Pearl cooldown animation
- Cooldown does not reset or update during active cooldown
Anti-Spam Protection
- Cooldown messages are limited to once per 3 seconds
- Prevents chat spam when players repeatedly click items on cooldown
- Item usage is still blocked, but messages are rate-limited
? Benefits
1. Flexibility
- Works with ANY Minecraft item, weapon, or enchantment
- No need to modify server code or use complex plugins
- Easy to add or remove cooldowns
2. Smart Detection
- Automatically detects item usage type
- No manual configuration needed for different item types
- Handles special cases like Riptide enchantment correctly
3. User-Friendly
- Visual cooldown animation for better UX
- Multi-language support for international servers
- Clear, informative messages
4. Performance
- Lightweight and optimized
- No performance impact on server
- Efficient cooldown tracking
5. Easy Management
- In-game commands for all operations
- No server restart needed for changes
- Simple YAML configuration
6. Professional Features
- Rate-limited messages prevent spam
- Proper event handling prevents exploits
- Reliable cooldown tracking
? Defaults
The plugin comes with pre-configured cooldowns for popular items:
- Riptide (enchantment): 15 seconds
- Ender Pearl: 20 seconds
- Golden Apple: 5 seconds
- Enchanted Golden Apple: 30 seconds
- Firework Rocket: 3 seconds
- Mace: 5 seconds
You can modify or remove these as needed.
? Troubleshooting
Cooldown not working?
- Make sure
enable: true in config
- Check that cooldown value is greater than 0
- Verify correct
click_type (right_click/left_click)
- Run
/rccd reload after config changes
Messages not in my language?
- Check
lang: setting in config.yml
- Verify language file exists in
plugins/RCCooldown/lang/
- Run
/rccd reload after changing language
Item not found when adding?
- Use correct item ID format (UPPERCASE_WITH_UNDERSCORES)
- For enchantments, use lowercase name (e.g.,
riptide, not RIPTIDE)
- Check spelling - use
/rccd list to see examples
? Permissions
rccd.admin - Access to all /rccd commands (OP by default)
? Updates
The plugin is actively maintained and updated. Check the releases page for:
- Bug fixes
- New features
- Performance improvements
- Additional language support
? Support
For support, bug reports, or feature requests, please visit the plugin's page on Discord.
? License
This plugin is provided as-is for use on Minecraft servers.
评论 0
登录后参与评分
还没有评论,来抢沙发吧