DisableThatItem

插件

· 作者 Crowz

# DisabledItem — 插件简介 一个轻量级的 Paper 插件(兼容 Folia),可禁用玩家拾取的任何物品。 ## 概念 当玩家拾取任何物品——例如战锤、剑或一组方块——该物品会被标记为已禁用,并变为无

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

最新 1.1.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

DisabledItem

你拾取到的任何物品都将被禁用。 当一件物品进入玩家的背包时,它会被永久标记为已禁用状态——捡起一把战锤,这把战锤即被禁用。在管理员恢复之前,禁用的物品将无法使用、移动、丢弃或用于合成。

为什么选择它

  • 零配置 — 放入罐子,重启服务器,完成。无需维护每物品的列表,无需数据库,无需外部插件
  • 全覆盖 — 禁用标记存储在物品本身,因此无论物品如何获取、转移、附魔或重命名,它们都会保持禁用状态
  • 无漏洞 — 所有交互路径均被阻止:使用、消耗、丢弃、交换、背包点击、拖拽、漏斗、合成、铁砧、砂轮和锻造台
  • 全平台运行 — 原生支持 Folia(具备区域感知调度),同时完全兼容 Paper/Purpur;没有其他插件能开箱即用同时支持这两者
  • 轻量级 — 仅需少量事件监听器和一个小型配置文件,零依赖
  • 对管理员友好 — 只需一条命令即可标记或恢复手中的任意物品,并可在不重启服务器的情况下重载配置

功能

  • 拾取即禁用 — 拾取任何物品(战锤、剑、鞘翅、方块等)后,它将立即被禁用
  • 全面拦截 — 禁用物品无法右键/使用、消耗、丢弃、双手切换、在背包中点击或拖拽、被漏斗移动,也无法用于合成、铁砧、砂轮或锻造台
  • 手动控制 — /disableditem 禁用你手中的物品,/disableditem undo 恢复它
  • 可选的背包清理 — 自动从玩家背包中移除禁用物品 (remove-disabled-items: true)
  • Folia + Paper 支持 — 可在 Paper、Purpur、Folia 及其所有分支上运行(使用区域感知调度,Folia 上不依赖 Bukkit 调度器)
  • 完全可配置 — config.yml 中可配置每种方块类型、消息和行为

工作原理

当玩家拾取物品时,插件会在该物品堆栈上写入持久化数据标记。从此,该物品被视为已禁用:所有与其交互的行为都会被事件监听器取消,并且可选的定期扫描会将禁用物品从背包中清除。

标记存储在物品本身(PersistentDataContainer)上,因此即使物品被转移、附魔或重命名,它们仍会保持禁用状态。

命令

命令 描述 权限
/disableditem 禁用主手中当前持有的物品 disableditem.use
/disableditem mark 同上(显式形式) disableditem.use
/disableditem undo 移除主手中物品的禁用标记 disableditem.use
/disableditem reload 在不重启服务器的情况下重载 config.yml disableditem.reload

所有命令均支持 Tab 补全,并拥有别名 /di 和 /disabled-item。

示例:

  • /disableditem — 手持战锤时执行此命令,将禁用该战锤
  • /disableditem undo — 手持同一把战锤时执行此命令,使其恢复可用
  • /disableditem reload — 立即应用配置更改

权限

权限 默认值 描述
disableditem.use op 标记和解除物品的禁用状态
disableditem.reload op 重载配置文件

授予 disableditem.use 给希望能够禁用和恢复物品的员工;将 disableditem.reload 保留给管理员。

配置

# DisabledItem 插件配置

enabled: true

# 当玩家拾取 ANY 物品时,它将立即被标记为禁用
disable-on-pickup: true

# 对禁用物品要阻止的操作
block:
  inventory-click: true  # 无法在背包中点击或Shift-点击
  drag: true             # 无法在背包中拖拽(或在上方拖拽)
  use: true              # 无法右键点击 / 消耗
  drop: true             # 无法丢弃
  swap: true             # 无法在主手和副手之间交换
  hopper: true           # 漏斗无法移动或吸取它
  crafting: true         # 无法用它进行合成、重命名(铁砧)、研磨或锻造

# 自动从玩家背包中 REMOVE 禁用物品
# (默认:false - 禁用物品保留在背包中但不可用)
remove-disabled-items: false

# 消息 ({item} = 物品名称,支持 & 颜色代码)
disable-message: "&c你拾取了 {item}!它现在已被禁用。"
block-message: "&c此物品已被禁用!"

# 背包扫描的运行频率(20 tick = 1秒)
scan-interval-ticks: 100

兼容性

  • Minecraft 1.21.x(基于 Paper API 1.21.11 构建)
  • Paper、Purpur、Folia 及其他 Paper 分支
  • Java 21+

安装

  1. 下载最新的 DisabledItem-x.y.z.jar
  2. 将其放入服务器的 plugins 文件夹
  3. 重启服务器
  4. 完成 — 现在拾取物品将禁用它们

从源代码构建

mvn clean package

Jar 包输出至 target/DisabledItem-1.1.0.jar。

许可证

MIT — 你可以随意使用它。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源