CreativeItemControl - 创造物品管理

CreativeItemControl 是一款反作弊插件，旨在防止玩家通过黑客客户端生成自定义物品，并允许服务器管理员限制从创造模式菜单中获取和使用哪些物品。

💡核心功能

• 阻止访问未出现在创造模式菜单中的物品。
• 选择性阻止访问特定的创造模式菜单标签页。
• 阻止黑客客户端生成带有自定义NBT的OP附魔书。
• 阻止黑客客户端生成命令方块。
• 阻止黑客客户端生成带有自定义NBT的物品。
• 不会阻止通过正常合成或附魔获得、但菜单中没有的物品（除非被明确列入黑名单）。
• 选择性阻止访问特定物品。
• 可自定义的权限提示信息。
• 可自定义的广播信息及接收目标。
• 可配置违规时执行的命令，例如自动踢出或封禁。
• 能够广播完整的物品NBT数据，以便管理员查看被阻止物品的详细信息。
• 提供白名单功能，允许特定物品携带自定义NBT。

🎮命令

/cicreload

• 权限节点: creativeitemcontrol.reload
• 功能: 重新加载插件的配置文件。

🎮权限

主要权限

• creativeitemcontrol.*

- **默认**: OP

- **功能**: 授予所有 CreativeItemControl 相关权限。

• creativeitemcontrol.reload

- **默认**: OP

- **功能**: 允许使用 `/cicreload` 命令。

• creativeitemcontrol.bypass

- **默认**: OP

- **功能**: 绕过所有 CreativeItemControl 的检查。

菜单访问权限

这些权限控制玩家可以访问哪些创造模式菜单标签页。默认值均为 true。

• creativeitemcontrol.menu.* (默认: OP)
• creativeitemcontrol.menu.building (建筑)
• creativeitemcontrol.menu.decoration (装饰)
• creativeitemcontrol.menu.redstone (红石)
• creativeitemcontrol.menu.transportation (交通)
• creativeitemcontrol.menu.miscellaneous (杂项)
• creativeitemcontrol.menu.foodstuffs (食品)
• creativeitemcontrol.menu.tools (工具)
• creativeitemcontrol.menu.combat (战斗)
• creativeitemcontrol.menu.brewing (酿造)
• creativeitemcontrol.menu.materials (材料)

黑名单权限

• creativeitemcontrol.blacklist.*

- **默认**: OP

- **功能**: 授予访问所有黑名单中物品的权限。

• creativeitemcontrol.blacklist.<name>

- **默认**: OP

- **功能**: 授予访问指定名称黑名单中物品的权限（名称需与配置文件对应）。

🔧配置说明

配置文件允许你进行精细化的控制。以下是一个示例配置的解析：

频率限制（默认禁用）

# 限制在 rateLimitTime 秒内最多点击/丢弃 rateLimit 个物品。
# 例如：60秒内限制100次物品点击或丢弃。
# rateLimit: 100
# rateLimitTime: 60

自定义黑名单

你可以创建任意名称的黑名单组，插件会自动生成对应的权限节点。

blacklist:
  basic: # 黑名单组名称
    items:
    - 'minecraft:barrier'
    - 'minecraft:water_bucket'
  spawner:
    items:
    - 'minecraft:mob_spawner'
    - 'minecraft:spawn_egg'

白名单

列出允许携带任意NBT数据的物品。注意，附魔物品（如锋利32000级）可能不安全。

whitelist:
- 'minecraft:skull'
- 'minecraft:banner'
- 'minecraft:bow'
# ... 其他物品

事件响应配置

你可以为不同违规类型配置拦截、提示信息、广播和执行命令。

占位符说明

在信息字符串中可以使用以下占位符

• %1$s - 玩家名称。
• %2$s - 物品名称。
• %3$s - 完整的物品NBT数据。
• 你可以限制NBT字符串长度，例如：%3$.80s（限制为80个字符）。

1. 生成菜单外物品

当玩家生成不在创造模式菜单中的物品时触发。

unavailable:
  # block: true # 可选，默认为 true
  message: 'You do not have permission for %2$s.' # 发送给玩家的信息
  # broadcastPermission: bukkit.broadcast.admin # 可选，广播接收权限，默认为 bukkit.broadcast.admin
  broadcastMessage: '%1$s attempted to spawn in %3$s' # 广播信息
  # commands: # 要执行的命令列表
  # - 'kick %1$s You do not have permission for %2$s.'

2. 无权限访问菜单内物品

当玩家尝试生成其没有权限的创造模式菜单物品时触发。配置项与 unavailable 相同。

nopermission:
  message: 'You do not have permission for %2$s.'

3. 使用黑名单物品

当玩家尝试生成黑名单中的物品时触发。配置项与 unavailable 相同。

blacklisted:
  message: 'You do not have permission for %2$s.'

4. 触发频率限制

当玩家点击/丢弃物品的频率超过限制时触发（此检查优先级最高）。

onRateLimit:
  broadcastMessage: '%1$s exceeded rate limit for inventory clicks or dropped items'
  message: 'Do not click so fast!'

❓注意事项

• 频率限制检查 (onRateLimit) 会最先执行，可能会对管理员造成大量信息刷屏。
• 白名单中的物品（如 minecraft:bow）将允许携带任何NBT，请谨慎设置以防变态附魔物品。
• 通过正常游戏途径（合成、附魔、交易等）获得的物品，只要其基础类型不在黑名单内，通常不会被阻止。

⭐源码

插件开源地址：https://github.com/cybertiger/Bukkit-CreativeItemControl