原创 工具 CyuBanItem | 高性能物品禁用 | 支持NBT与lore封禁物品 | 支持Folia [1.13-1.21] 1.0.5

CyuBanItem | 违禁物品管理 | 行为级封禁 / NBT / Lore匹配

一个用于管理服务器违禁物品的插件

CyuBanItem 可以限制指定物品在指定行为中的使用

不是简单地“玩家不能拿这个物品”
而是可以控制这个物品能不能右键、放置、攻击、交易、合成、丢弃、放进容器

适合生存服、RPG服、模组服、活动服处理高风险物品和特殊物品

---

主要功能

● 违禁物品规则管理
● 按行为类型单独封禁
● 支持材质匹配
● 支持材质通配符
● 支持 NBT 匹配
● 支持 Lore 匹配
● 支持指定世界生效
● 支持规则绕过权限
● 支持发现即自动没收
● 支持违禁品公示菜单
● 支持 GUI 管理终端
● 支持 YAML / MySQL 存储
● 支持 PlaceholderAPI
● 支持 Folia

---

为什么写这个插件

很多服务器都有一些不能随便使用的物品

比如基岩、命令方块、刷怪笼
或者某些活动物品、绑定物品、RPG装备、异常复制品

有些物品不是完全不能存在

它可以展示
可以放在背包里
可以作为任务材料
但不能拿来攻击、放置、交易或者丢进容器

普通禁物品插件经常是一刀切

CyuBanItem 更适合做这种细一点的限制

想全禁就全禁
想只禁某几个行为，也可以只禁那几个行为

---

行为级封禁

每条规则都可以指定要拦截哪些行为

支持的行为包括：

CLICK_LEFT　左键
CLICK_RIGHT　右键
HOLD　手持
INVENTORY　背包操作
PICKUP　拾取
DROP　丢弃
CONSUME　食用或饮用
CRAFT　合成
INTERACT_CONTAINER　容器交互
ATTACK　攻击
PROJECTILE　发射
PLACE　放置
BREAK　破坏
SMITH　锻造
ENCHANT　附魔
EQUIP　穿戴
TRADE　交易
ALL　全部行为

比如一个绑定武器
可以允许玩家拿着展示
但禁止交易、丢弃、放进容器

一个活动道具
可以允许玩家领取
但禁止合成、锻造和交易

这样不会把物品直接管死

---

材质和通配符

规则可以匹配单个材质

也可以用通配符匹配一类物品

比如：

LOG　匹配所有原木
OAK　匹配所有橡木开头的物品
WOOD　匹配材质名里包含 WOOD 的物品

适合批量禁用某类方块

比如活动期间禁止放置某类方块
或者限制某些建筑材料在指定世界使用

通配规则会在加载时展开成实际材质
玩家操作物品时仍按材质索引匹配

---

NBT 匹配

CyuBanItem 可以按 NBT 识别特殊物品

比如 ItemsAdder 物品、资源包物品、其他插件写入数据的物品

这种情况下，单靠材质已经不够了

因为很多特殊物品本质上都是 PAPER、STICK 或 DIAMOND_SWORD
真正区分它们的是 NBT 和插件数据

通过 NBT 匹配，可以只限制某个指定特殊物品
不会误伤同材质的普通物品

---

Lore 匹配

插件也支持按 Lore 匹配

比如某些物品带有：

被诅咒的武器
专属绑定
活动限定

就可以按 Lore 内容来判断

Lore 匹配会剥离颜色代码后比较
玩家不能靠改颜色绕过

这个功能适合处理一些没有稳定 NBT 的老物品或轻量自定义物品

---

世界限制

每条规则都可以指定生效世界

可以全服生效
也可以只在某些世界生效

比如：

生存世界禁用基岩
资源世界禁止某些刷物道具
副本世界禁止传送类物品
活动世界禁止特殊装备

global 表示全服生效

不同世界可以有不同规则
不用把所有限制都写成全服封禁

---

自动没收

某些物品不只是不能用

而是玩家背包里根本不应该出现

比如异常复制品、非法物品、漏洞刷出来的物品

这种情况可以开启自动没收

规则触发后直接清除物品
适合处理高风险违禁品

普通限制类物品不建议一上来就自动没收
先拦截行为，确认规则没问题后再开

---

GUI 管理

插件带有 GUI 管理终端

可以用来查看和管理违禁规则

也有违禁品公示菜单
玩家可以查看当前服务器禁用了哪些物品

管理菜单里的新增封禁按钮支持把待封禁物品放到按钮上
再通过聊天补全向导快速创建规则

比纯手写配置更方便

---

存储方式

支持 YAML 和 MySQL

YAML
适合单服使用，配置直观，方便备份

MySQL
适合多服共享规则，或者需要集中管理的服务器

普通单服直接用 YAML 就可以

---

PlaceholderAPI 变量

安装 PlaceholderAPI 后可使用变量

%cyubanitem_rule_count%　当前规则总数
%cyubanitem_check_hand%　检测主手物品是否违禁
%cyubanitem_version%　插件版本

可以放到管理菜单、计分板或调试信息里

---

命令

/cbi view　打开违禁品公示菜单
/cbi gui　打开可视化管理终端
/cbi ban [行为] [世界] [autoClear]　把手持物品添加为封禁规则
/cbi unban 　删除封禁规则
/cbi reload　重载配置与语言文件

---

权限

cyubanitem.admin
使用主命令、管理规则、打开管理 GUI、重载配置

cyubanitem.use
允许打开违禁品公示 / 预览菜单

规则内 permission
拥有该权限的玩家可以绕过指定规则

---

适合什么服务器

生存服
RPG服
活动服
模组服
资源服
需要禁用高风险物品的服务器
需要限制特殊物品行为的服务器

如果只是单纯禁几个原版物品，它可以做

如果是想把特殊物品按行为细分限制，它会更适合

---

插件信息

作者：HansOffice
支持核心：Spigot / Paper / Purpur / Folia
版本包：Paper / Folia
存储方式：YAML / MySQL
可选依赖：PlaceholderAPI
交流群：331910315

---

获取方式

外链下载

交流群：331910315