MorayBanItem Plugin

MorayBanItem - 物品封禁与反非法插件 / Item Ban & Anti-Illegal Plugin

---

插件介绍 / Introduction

MorayBanItem 是一个轻量级但功能强大的 Bukkit 物品封禁插件。它允许服务器管理员灵活地封禁特定物品，支持纯材质封禁和精确 NBT 封禁，并能自动检测并处理非法物品（如 32k 附魔、数量异常等），有效维护服务器经济与平衡。

MorayBanItem is a lightweight yet powerful Bukkit item banning plugin. It allows server administrators to flexibly ban specific items, supports pure material banning and precise NBT-based banning, and automatically detects and handles illegal items (such as 32k enchants, abnormal stack sizes, etc.), effectively maintaining server economy and balance.

> Hybrid server friendly：针对 Youer 混合端做了特别优化，支持模组物品的封禁与补全。 > Hybrid server friendly: Specially optimized for Youer hybrid servers, supporting mod item banning and tab completion.

---

功能特性 / Features

智能封禁系统 / Smart Ban System

- NBT prototype ban：封禁所有同材质的物品（如 `minecraft:tnt`） NBT prototype ban: Ban all items of the same material (e.g., `minecraft:tnt`) - NBT prototype ban：仅封禁带有特定 NBT 数据的物品（通过 `/mbi addhand` 添加手中物品） NBT prototype ban: Ban only items with specific NBT data (add via `/mbi addhand`) - 封禁列表独立存储于 `items.yml`，与主配置分离，便于管理 Ban list stored separately in `items.yml`, independent from main config

非法物品检测 / Illegal Item Detection

- 自动检测并处理异常物品： Automatically detects and handles abnormal items: - 超高附魔等级（可自定义阈值） / Excessive enchantment levels (customizable threshold) - 数量异常（超过最大堆叠或 ≤0） / Abnormal stack sizes (exceeding max stack or ≤0) - 无法破坏标签 / Unbreakable tag - 可配置处理方式：cancel（没收）或仅cancel Configurable action: cancel (confiscate) or just cancel the event - 检测到非法物品时，支持全局广播和日志记录 Supports global broadcast and logging when illegal items are detected

便捷管理命令 / Easy Management Commands

- 提供完整的命令集，轻松管理封禁列表 Full command set for managing ban list - Tab 补全智能适配服务端类型（原版 Bukkit 使用注册表，Youer 使用反射获取所有物品） Smart tab completion adapts to server type (uses registry for vanilla Bukkit, reflection for Youer to include all items)

实时监控与日志 / Real-time Monitoring & Logging

- 所有违规事件（非法或封禁物品）均记录到 `logs/violations.log`，包含玩家 UUID、物品 ID、数量及 NBT 提示 All violations (illegal or banned items) are logged to `logs/violations.log`, including player UUID, item ID, amount, and NBT hint - 可自定义全局广播消息 Customizable global broadcast messages

高性能设计 / High Performance

- 事件监听器轻量高效，仅检查必要属性 Lightweight event listeners, only check necessary properties - 配置缓存机制，减少磁盘 I/O Config caching reduces disk I/O

---

命令列表 / Commands

| 命令 / Command | 说明 / Description | |----------------|-------------------| | `/mbi help` | 显示帮助信息 / Show help information | | `/mbi reload` | 重载配置文件（config.yml, message.yml, items.yml） / Reload config files | | `/mbi info` | 显示插件信息 / Display plugin information | | `/mbi list` | 列出所有被封禁的物品（含材质封禁和原型封禁） / List all banned items | | `/mbi add <物品ID>` | 添加纯材质封禁（支持命名空间ID，如 `minecraft:tnt`） / Add a pure material ban | | `/mbi addhand` | 将手中物品作为 NBT 原型加入封禁列表 / Add held item as NBT prototype ban | | `/mbi remove <物品ID>` | 移除纯材质封禁 / Remove a pure material ban | | `/mbi removehand` | 移除与手中物品匹配的封禁项（含材质和原型） / Remove ban entry matching held item |

---

权限节点 / Permissions

| 权限节点 / Permission | 说明 / Description | 默认 / Default | |-----------------------|-------------------|----------------| | `moraybanitem.bypass` | 绕过所有物品检查 / Bypass all item checks | op | | `moraybanitem.command.reload` | 重载插件配置 / Reload plugin config | op | | `moraybanitem.command.info` | 查看插件信息 / View plugin info | true | | `moraybanitem.command.help` | 查看帮助 / View help | true | | `moraybanitem.command.list` | 查看封禁列表 / View ban list | op | | `moraybanitem.command.add` | 添加材质封禁 / Add material ban | op | | `moraybanitem.command.addhand` | 添加手中物品 / Add held item | op | | `moraybanitem.command.remove` | 移除材质封禁 / Remove material ban | op | | `moraybanitem.command.removehand` | 移除手中物品对应的封禁 / Remove ban for held item | op |

---

配置文件 / Config Files

- message.yml：主配置文件，包含消息、非法检测开关及广播设置 Main config file, containing messages, illegal detection toggle, and broadcast settings - message.yml：独立封禁物品列表（使用命名空间ID作为键） Separate ban list file (uses namespaced keys) - message.yml：语言文件，可自定义所有提示消息 Language file, all messages customizable

---

适用版本 / Supported Versions

- Bukkit / Spigot / Paper 1.20+ - 混合端：Youer（特别优化） / Hybrid server: Youer (specially optimized)

---

> 由 Morpe14514 开发 | 工作室QQ群：1081434103 > Developed by Morpe14514 | Studio QQ Group: 1081434103