ItemCooldown
ItemCooldown 是一款轻量级且高度可配置的 Minecraft 插件,允许服务器管理员在 PvP 战斗中对特定物品施加冷却限制。
它通过在战斗开始时暂时禁止使用强大的物品(如 不死图腾、鞘翅、末影珍珠、金苹果等),防止玩家滥用这些物品。
该插件旨在做到 完全可配置、轻量级 和 安全,支持多种物品操作以及自动库存处理。
主要功能
⚔️ 基于战斗的冷却
当玩家进入 PvP 战斗时,冷却会 立即开始。
攻击者和受害者都会为所有已配置的物品获得冷却时间。
战斗检测包括:
- 直接的玩家攻击
- 玩家射出的投射物
- 创造模式下的攻击者
- 来自玩家的区域效果伤害
忽略的伤害来源:
? 可配置的物品操作
每个物品都可以限制不同类型的交互:
| 操作 |
描述 |
pickup |
阻止玩家拾取该物品 |
equip |
阻止玩家装备该物品 |
use |
阻止玩家使用该物品 |
containers |
阻止玩家将物品移动进或移出容器和Bundle |
示例配置:
{
"_settings": {
"display": "actionbar",
"update_ticks": 1
},
"TOTEM_OF_UNDYING": {
"cooldown": 60,
"action": ["pickup", "use"]
},
"ELYTRA": {
"cooldown": 120,
"action": ["equip"]
}
}
冷却值单位为 秒。
? 智能装备处理
如果玩家在 战斗开始时已经装备了受限物品,插件将自动执行以下操作:
- 卸下该物品
- 将其移动到玩家的背包中
如果背包已满:
- 该物品会临时存储在 虚拟缓冲区 中
- 当有空间时,它会自动返回到背包中
这可以防止玩家通过预先装备好的物品(如 鞘翅或护甲部件)绕过冷却限制。
⚙️ 完全可配置
该插件使用 Bukkit 材质名称 和 JSON 配置文件。
目录结构:
plugins/ItemCooldown/
config.json
config-examples.txt
translations/
messages.json
功能包括:
- 可编辑的消息
- 可配置的冷却时间
- 按物品配置的操作
- 内置文档示例
? 热重载支持
您可以重新加载配置和翻译文件,而无需重启服务器。
/itemcooldown reload
如果配置文件缺失,插件将 自动重新创建它们。
命令
| 命令 |
描述 |
/itemcooldown help |
显示所有插件命令 |
/itemcooldown list [page] |
列出已配置的冷却物品 |
/itemcooldown info <material> |
显示有关已配置物品的信息 |
/itemcooldown forgive <player> |
移除某玩家的冷却状态 |
/itemcooldown add <material> <cooldown> <actions> |
添加新的物品冷却 |
/itemcooldown edit <material> <cooldown> <actions> |
编辑现有物品冷却 |
/itemcooldown remove <material> |
移除物品冷却 |
/itemcooldown reload |
重新加载插件配置 |
权限
| 权限 |
描述 |
默认值 |
itemcooldown.help |
允许使用 /itemcooldown help |
true |
itemcooldown.info |
允许使用 /itemcooldown info |
op |
itemcooldown.list |
允许使用 /itemcooldown list |
op |
itemcooldown.forgive |
允许使用 /itemcooldown forgive |
op |
itemcooldown.reload |
允许使用 /itemcooldown reload |
op |
itemcooldown.add |
允许添加新的冷却物品 |
op |
itemcooldown.edit |
允许编辑冷却物品 |
op |
itemcooldown.remove |
允许移除冷却物品 |
op |
itemcooldown.update.notify |
允许接收游戏内更新通知 |
op |
为什么使用 ItemCooldown?
许多 PvP 服务器都存在 战斗中物品滥用 的问题,例如:
- 利用鞘翅逃跑
- 堆叠不死图腾
- 无限使用末影珍珠
- 滥发金苹果
ItemCooldown 提供了一个 简洁且可配置 的解决方案,在保持游戏公平性的同时平衡 PvP。
兼容性
- Minecraft 1.20+
- Spigot / Paper
- 轻量级,对性能影响极小
示例用例
服务器通常限制的常见物品:
TOTEM_OF_UNDYING
ENDER_PEARL
ELYTRA
GOLDEN_APPLE
ENCHANTED_GOLDEN_APPLE
SHIELD
TRIDENT
配置理念
ItemCooldown 的设计目标是:
您可以决定 哪些物品、哪些操作 以及 冷却持续多久。
支持
如果您遇到问题或有功能建议,欢迎在 Discord 服务器中提交工单!
享受公平且平衡的 PvP!
ItemCooldown
ItemCooldown is a lightweight and highly configurable Minecraft plugin that allows server owners to apply cooldown restrictions to specific items during PvP combat.
It prevents players from abusing powerful items such as Totems, Elytra, Ender Pearls, Golden Apples, etc. by temporarily blocking their usage when combat starts.
The plugin is designed to be fully configurable, lightweight, and safe, with support for multiple item actions and automatic inventory handling.
Key Features
⚔️ Combat-Based Cooldowns
Cooldowns begin immediately when a player enters PvP combat.
Both the attacker and the victim receive cooldowns for all configured items.
Combat detection includes:
- Direct player hits
- Projectiles shot by players
- Creative attackers
- Area-effect damage from players
Ignored damage sources:
- Self damage
- Ender pearl damage
- Non-player attackers
? Configurable Item Actions
Each item can restrict different types of interactions:
| Action |
Description |
pickup |
Prevents players from picking up the item |
equip |
Prevents players from equipping the item |
use |
Prevents players from using the item |
containers |
Prevents players from moving the item into or out of containers and bundles |
Example config:
{
"_settings": {
"display": "actionbar",
"update_ticks": 1
},
"TOTEM_OF_UNDYING": {
"cooldown": 60,
"action": ["pickup", "use"]
},
"ELYTRA": {
"cooldown": 120,
"action": ["equip"]
}
}
Cooldown values are in seconds.
? Smart Equipment Handling
If a player already has a restricted item equipped when combat begins, the plugin will automatically:
- Unequip the item
- Move it to the player's inventory
If the inventory is full:
- the item is temporarily stored in a virtual buffer
- it will automatically return to the inventory when space becomes available
This prevents bypassing cooldowns with already-equipped items such as Elytra or armor pieces.
⚙️ Fully Configurable
The plugin uses Bukkit material names and JSON configuration.
Structure:
plugins/ItemCooldown/
config.json
config-examples.txt
translations/
messages.json
Features include:
- Editable messages
- Configurable cooldowns
- Configurable actions per item
- Built-in documentation examples
? Hot Reload Support
You can reload the configuration and translation files without restarting the server.
/itemcooldown reload
If configuration files are missing, the plugin will automatically recreate them.
Commands
| Command |
Description |
/itemcooldown help |
Displays all plugin commands |
/itemcooldown list [page] |
Lists configured cooldown items |
/itemcooldown info <material> |
Shows information about a configured item |
/itemcooldown forgive <player> |
Removes the cooldown's for a player |
/itemcooldown add <material> <cooldown> <actions> |
Adds a new item cooldown |
/itemcooldown edit <material> <cooldown> <actions> |
Edits an existing item |
/itemcooldown remove <material> |
Removes an item cooldown |
/itemcooldown reload |
Reloads the plugin configuration |
Permissions
| Permission |
Description |
Default |
itemcooldown.help |
Allows /itemcooldown help |
true |
itemcooldown.info |
Allows /itemcooldown info |
op |
itemcooldown.list |
Allows /itemcooldown list |
op |
itemcooldown.forgive |
Allows /itemcooldown forgive |
op |
itemcooldown.reload |
Allows /itemcooldown reload |
op |
itemcooldown.add |
Allows adding new cooldown items |
op |
itemcooldown.edit |
Allows editing cooldown items |
op |
itemcooldown.remove |
Allows removing cooldown items |
op |
itemcooldown.update.notify |
Allows receiving in-game update notifications |
op |
Why Use ItemCooldown?
Many PvP servers suffer from item abuse during combat, such as:
- Elytra escaping
- Totem stacking
- Infinite ender pearl usage
- Golden apple spam
ItemCooldown provides a clean and configurable solution to balance PvP while keeping gameplay fair.
Compatibility
- Minecraft 1.20+
- Spigot / Paper
- Lightweight with minimal performance impact
Example Use Cases
Common items servers restrict:
TOTEM_OF_UNDYING
ENDER_PEARL
ELYTRA
GOLDEN_APPLE
ENCHANTED_GOLDEN_APPLE
SHIELD
TRIDENT
Configuration Philosophy
ItemCooldown is designed to be:
- Simple
- Flexible
- Server-friendly
You decide which items, which actions, and how long the cooldown lasts.
Support
If you encounter issues or have feature requests, feel free to open an ticket in the Discord server!
Enjoy fair and balanced PvP!
评论 0
登录后参与评分
还没有评论,来抢沙发吧