ItemCooldown

插件

· 作者 nieuwjaar

一款简单且轻量的物品冷却插件!

0 本站下载 0 关注 更新于 1 个月前

最新 1.4 · 26.3 · Bukkit / Paper

一键开服(送7天)

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"]
  }
}

冷却值单位为 秒。


? 智能装备处理

如果玩家在 战斗开始时已经装备了受限物品,插件将自动执行以下操作:

  1. 卸下该物品
  2. 将其移动到玩家的背包中

如果背包已满:

  • 该物品会临时存储在 虚拟缓冲区 中
  • 当有空间时,它会自动返回到背包中

这可以防止玩家通过预先装备好的物品(如 鞘翅或护甲部件)绕过冷却限制。


⚙️ 完全可配置

该插件使用 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!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源