CreativeItemControl - 创造模式物品控制

这是一个用于限制创造模式物品使用的反作弊插件更新版，可防止玩家通过作弊客户端生成非法物品，并细致控制创造菜单中的可用物品。

💡版本选择说明

• 请在版本历史中选择与服务器对应的插件版本：
• 对于 Spigot 1.12(.2)，使用 CreativeItemControl 1.12
• 对于 Spigot 1.13、1.13.1 和 1.13.2，使用 CreateItemControl 1.13.2
• 对于 Spigot 1.14 和 1.14.1，使用最新更新版本

⭐插件简介

• 这是 https://www.spigotmc.org/resources/creativeitemcontrol.9471/ 的更新版本
• 原作者为 CyberTiger
• 开发构建版本可在此获取：
• https://www.iani.de/jenkins/job/Bukkit-CreativeItemControl/

✨主要功能

• 防止玩家使用作弊客户端生成自定义物品
• 允许限制玩家可从创造模式菜单中使用的物品
• 阻止访问不在创造菜单中的物品
• 可选择性阻止访问特定创造菜单分页
• 阻止作弊客户端生成 op me books
• 阻止作弊客户端生成命令方块
• 阻止作弊客户端生成带有自定义 NBT 的物品
• 默认不会拦截那些虽然不在菜单中、但通过合成或附魔正常获得的物品，除非你明确将其加入黑名单
• 可选择性阻止特定物品
• 支持自定义权限提示消息
• 支持自定义广播消息及广播目标
• 支持在违规时执行自定义命令，可自动踢出或封禁
• 可广播完整物品 NBT，方便你查看究竟拦截了什么
• 支持白名单，允许某些物品携带自定义 NBT

🎮命令

• 命令：/cicreload
• 权限：creativeitemcontrol.reload
• 说明：重新加载配置文件

🎮权限

通用权限

• 权限：creativeitemcontrol.*
• 默认：op
• 说明：授予所有 creativeitemcontrol 权限

• 权限：creativeitemcontrol.reload
• 默认：op
• 说明：允许使用 /cicreload 命令

• 权限：creativeitemcontrol.bypass
• 默认：op
• 说明：绕过所有 CreativeItemControl 检查

创造菜单分页权限

• 权限：creativeitemcontrol.menu.*
• 默认：op
• 说明：授予所有创造菜单分页中的物品访问权限

• 权限：creativeitemcontrol.menu.building
• 默认：true
• 说明：允许访问创造菜单中 building 分页的物品

• 权限：creativeitemcontrol.menu.decoration
• 默认：true
• 说明：允许访问创造菜单中 decoration 分页的物品

• 权限：creativeitemcontrol.menu.redstone
• 默认：true
• 说明：允许访问创造菜单中 redstone 分页的物品

• 权限：creativeitemcontrol.menu.transportation
• 默认：true
• 说明：允许访问创造菜单中 transportation 分页的物品

• 权限：creativeitemcontrol.menu.miscellaneous
• 默认：true
• 说明：允许访问创造菜单中 miscellaneous 分页的物品

• 权限：creativeitemcontrol.menu.foodstuffs
• 默认：true
• 说明：允许访问创造菜单中 foodstuffs 分页的物品

• 权限：creativeitemcontrol.menu.tools
• 默认：true
• 说明：允许访问创造菜单中 tools 分页的物品

• 权限：creativeitemcontrol.menu.combat
• 默认：true
• 说明：允许访问创造菜单中 combat 分页的物品

• 权限：creativeitemcontrol.menu.brewing
• 默认：true
• 说明：允许访问创造菜单中 brewing 分页的物品

• 权限：creativeitemcontrol.menu.materials
• 默认：true
• 说明：允许访问创造菜单中 materials 分页的物品

黑名单权限

• 权限：creativeitemcontrol.blacklist.*
• 默认：op
• 说明：授予访问所有黑名单中物品的权限

• 权限：creativeitemcontrol.blacklist.<name>
• 默认：op
• 说明：授予访问指定名称黑名单中物品的权限（参见下方配置部分）

🔧配置说明

• 为了获得最高安全性，建议不要将任何物品加入白名单
• 这样玩家只能获取创造菜单中原本可用的物品

示例配置

# Rate limiting (defaults to disabled) 
# Limits item clicks to rateLimit per rateLimitTime. 
# Example below for limiting to 100 item clicks or drops per 60 seconds. 
# 
# rateLimit: 100 
# rateLimitTime: 60 
# Custom blacklists 
# 
# You can name these whatever you want, a permission with the appropriate name 
# will be created automatically. 
# 
# The lists below serve only as an example, feel free to rename, remove or 
# add lists according to your server's needs. 
blacklist: 
  basic: 
    items: 
      - 'minecraft:barrier' 
      - 'minecraft:water_bucket' 
      - 'minecraft:flint_and_steel' 
      - 'minecraft:monster_egg' 
  spawner: 
    items: 
      - 'minecraft:mob_spawner' 
      - 'minecraft:spawn_egg' 
  limited: 
    items: 
      - 'minecraft:lava_bucket' 
      - 'minecraft:tnt' 
      - 'minecraft:tnt_minecart' 

# Whitelist - items to allow arbitrary nbt on. 
# Enchanted items may not be safe e.g. looting 32000. 
whitelist: 
  - 'minecraft:skull' 
  - 'minecraft:banner' 
  - 'minecraft:bow' 
  - 'minecraft:iron_sword' 
  - 'minecraft:wooden_sword' 
  - 'minecraft:stone_sword' 
  - 'minecraft:diamond_sword' 
  - 'minecraft:golden_sword' 
  - 'minecraft:leather_helmet' 
  - 'minecraft:leather_chestplate' 
  - 'minecraft:leather_leggings' 
  - 'minecraft:leather_boots' 
  - 'minecraft:chainmail_helmet' 
  - 'minecraft:chainmail_chestplate' 
  - 'minecraft:chainmail_leggings' 
  - 'minecraft:chainmail_boots' 
  - 'minecraft:iron_helmet' 
  - 'minecraft:iron_chestplate' 
  - 'minecraft:iron_leggings' 
  - 'minecraft:iron_boots' 
  - 'minecraft:diamond_helmet' 
  - 'minecraft:diamond_chestplate' 
  - 'minecraft:diamond_leggings' 
  - 'minecraft:diamond_boots' 
  - 'minecraft:golden_helmet' 
  - 'minecraft:golden_chestplate' 
  - 'minecraft:golden_leggings' 
  - 'minecraft:golden_boots' 

# items that can be spawned, but not with additional nbt tags 
allowedItems: 
  - 'minecraft:barrier' 

# In strings 
# %1$s - player name. 
# %2$s - item name. 
# %3$s - full item nbt. 
# Note: you can limit the length of the strings with the following: 
# %3$.80s - full item nbt (limited to 80 characters). 

# Action when a player spawns an item not in the creative menu. 
unavailable: 
  # Optional, defaults to true 
  #       block: true 
  # Optional, if not set, no message is sent. 
  message: 'You do not have permission for %2$s.' 
  # Optional, defaults to bukkit.broadcast.admin 
  #       broadcastPermission: bukkit.broadcast.admin 
  # Optional, if not set, no broadcast is sent. 
  broadcastMessage: '%1$s attempted to spawn in %3$s' 
  # List of commands, to run. 
  #       commands: 
  #               - 'kick %1$s You do not have permission for %2$s.' 

# Action when a player spawns an item in the creative menu they have no permission for. 
# Any of the values from the unavailable action can be set here. 
nopermission: 
  message: 'You do not have permission for %2$s.' 

# Action when a player spawns an item which is blacklisted. 
# Any of the values from the unavailable action can be set here. 
blacklisted: 
  message: 'You do not have permission for %2$s.' 

# Action when a player exceeds the item click/drop rate limit 
# Note: this check is performed first 
# This might be extremely spammy for admins. 
onRateLimit: 
  broadcastMessage: '%1$s exceeded rate limit for inventory clicks or dropped items' 
  message: 'Do not click so fast!'

❓配置要点

• blacklist：
• 你可以自定义任意黑名单名称
• 插件会自动创建对应名称的权限节点
• 示例中的 basic、spawner、limited 仅供参考，可按需重命名、删除或新增

• whitelist：
• 用于允许某些物品携带任意 NBT
• 注意：带附魔的物品不一定安全，例如 looting 32000

• allowedItems：
• 这些物品可以被生成
• 但不能附带额外的 NBT 标签

字符串占位符

• %1$s：玩家名
• %2$s：物品名
• %3$s：完整物品 NBT
• 你还可以限制字符串长度，例如：
• %3$.80s：完整物品 NBT，限制为 80 个字符

违规处理项

• unavailable
• 当玩家生成一个不在创造菜单中的物品时触发

• nopermission
• 当玩家生成一个虽然在创造菜单中、但自己没有权限使用的物品时触发

• blacklisted
• 当玩家生成黑名单中的物品时触发

• onRateLimit
• 当玩家超过物品点击/丢弃速率限制时触发
• 注意：这个检查会最先执行
• 对管理员来说，这可能会非常刷屏

💡注意事项

• 如果你追求最高安全性，尽量不要使用 whitelist
• 插件不会默认阻止通过正常合成或附魔获得、但未出现在创造菜单中的物品
• 只有在明确加入黑名单时，这类物品才会被拦截
• onRateLimit 的广播消息可能会产生大量管理通知