原创 娱乐 【1.8-1.21+】WarZSlots - 一款支持tacz的限制快捷栏可放入物品的插件|多重检测|多语言|支持NBT 1.6.0

# WarZSlots 配置文件
# 快捷栏物品限制插件配置
# 作者: Crazy_Jky
# 版本: 1.0-SNAPSHOT
# ==================== 基本设置 ====================
check-nbt: false  # 是否检查NBT数据匹配
disable-f-key: true  # 是否禁用F键交换物品
pickup-to-inventory-first: true  # 拾取物品是否优先放入背包而非快捷栏
# ==================== 权限设置 ====================
permissions:
  bypass-slot-restriction: "warzslots.bypass.slot"  # 绕过槽位限制的权限
  bypass-f-key-restriction: "warzslots.bypass.fkey"  # 绕过F键限制的权限
# ==================== 特殊槽位设置 ====================
# 自由槽位（这些槽位不受任何限制，可以放置任何物品）
free-slots: []
# 禁止槽位（这些槽位完全禁止放置任何物品）
forbidden-slots: []
# ==================== 九个快捷栏槽位详细配置 ====================
# 槽位编号: 0-8 (从左到右)
# 每个槽位支持的参数说明:
# - mode: 限制模式 ("whitelist" 白名单模式 / "blacklist" 黑名单模式)
# - fuzzy-match: 是否启用模糊匹配 (支持通配符 * 和 ?)
# - allowed-items: 白名单物品列表 (仅在whitelist模式下生效)
# - forbidden-items: 黑名单物品列表 (仅在blacklist模式下生效)
#
# 物品匹配参数说明:
# - item-id: 物品ID (必填，支持通配符)
# - name: 物品显示名称 (可选，精确匹配或包含匹配)
# - lore: 物品描述文本 (可选，检查是否包含指定文字)
# - custom-model-data: 自定义模型数据 (可选，数字)
# - nbt: NBT数据匹配 (可选，键值对)
restricted-slots:
  # ==================== 槽位 0 - 主武器槽 ====================
  # 功能: 仅允许放置剑类武器
  # 用途: 确保玩家主手武器槽只能放置战斗武器
  0:
    mode: "whitelist"  # 白名单模式
    fuzzy-match: true  # 启用模糊匹配
    description: "主武器槽 - 仅允许剑类武器"
    allowed-items:
      - item-id: "*_SWORD"  # 所有剑类物品
        description: "所有类型的剑"
      - item-id: "TRIDENT"  # 三叉戟
        description: "三叉戟"
      - item-id: "MACE"  # 锤子(1.21+)
        description: "锤子"
      - item-id: "DIAMOND_SWORD"
        name: "§6传奇之剑"  # 特定名称的钻石剑
        lore: "传说"
        custom-model-data: 1001
        nbt:
          enchanted: "true"
          level: 10
        description: "传奇钻石剑"
    forbidden-items: []
  # ==================== 槽位 1 - 远程武器槽 ====================
  # 功能: 仅允许放置弓箭、弩等远程武器
  # 用途: 专门的远程武器位置
  1:
    mode: "whitelist"
    fuzzy-match: true
    description: "远程武器槽 - 弓箭和弩"
    allowed-items:
      - item-id: "BOW"
        description: "弓"
      - item-id: "CROSSBOW"
        description: "弩"
      - item-id: "ARROW"
        description: "箭矢"
      - item-id: "SPECTRAL_ARROW"
        description: "光灵箭"
      - item-id: "TIPPED_ARROW"
        description: "药箭"
      - item-id: "FIREWORK_ROCKET"
        description: "烟花火箭(弩用)"
    forbidden-items: []
  # ==================== 槽位 2 - 工具槽 ====================
  # 功能: 禁止放置危险物品，允许常用工具
  # 用途: 安全的工具存放位置
  2:
    mode: "blacklist"  # 黑名单模式
    fuzzy-match: true
    description: "工具槽 - 禁止危险物品"
    allowed-items: []
    forbidden-items:
      - item-id: "TNT"
        description: "TNT炸药"
      - item-id: "*_TNT"  # 所有TNT变种
        description: "所有TNT类型"
      - item-id: "LAVA_BUCKET"
        description: "岩浆桶"
      - item-id: "FIRE_CHARGE"
        description: "火焰弹"
      - item-id: "FLINT_AND_STEEL"
        description: "打火石"
      - name: "§c危险"  # 名称包含"危险"的物品
        description: "名称包含危险的物品"
      - lore: "爆炸"  # 描述包含"爆炸"的物品
        description: "描述包含爆炸的物品"
  # ==================== 槽位 3 - 食物槽 ====================
  # 功能: 仅允许放置食物和药水
  # 用途: 专门的补给品位置
  3:
    mode: "whitelist"
    fuzzy-match: false
    description: "食物槽 - 食物和药水"
    allowed-items:
      - item-id: "BREAD"
        description: "面包"
      - item-id: "COOKED_BEEF"
        description: "熟牛肉"
      - item-id: "COOKED_PORKCHOP"
        description: "熟猪排"
      - item-id: "COOKED_CHICKEN"
        description: "熟鸡肉"
      - item-id: "GOLDEN_APPLE"
        description: "金苹果"
      - item-id: "ENCHANTED_GOLDEN_APPLE"
        description: "附魔金苹果"
      - item-id: "POTION"
        description: "药水"
      - item-id: "SPLASH_POTION"
        description: "喷溅药水"
      - item-id: "LINGERING_POTION"
        description: "滞留药水"
      - item-id: "MILK_BUCKET"
        description: "牛奶桶"
    forbidden-items: []
  # ==================== 槽位 4 - 建筑材料槽 ====================
  # 功能: 仅允许常用建筑方块
  # 用途: 建筑时的快速访问
  4:
    mode: "whitelist"
    fuzzy-match: true
    description: "建筑材料槽 - 常用方块"
    allowed-items:
      - item-id: "*_PLANKS"  # 所有木板
        description: "所有木板类型"
      - item-id: "COBBLESTONE"
        description: "圆石"
      - item-id: "STONE"
        description: "石头"
      - item-id: "*_STONE"  # 所有石头变种
        description: "所有石头类型"
      - item-id: "DIRT"
        description: "泥土"
      - item-id: "GRASS_BLOCK"
        description: "草方块"
      - item-id: "*_WOOL"  # 所有羊毛
        description: "所有羊毛颜色"
      - item-id: "GLASS"
        description: "玻璃"
      - item-id: "*_GLASS"  # 所有玻璃变种
        description: "所有玻璃类型"
    forbidden-items: []
  # ==================== 槽位 5 - 红石物品槽 ====================
  # 功能: 仅允许红石相关物品
  # 用途: 红石工程师专用
  5:
    mode: "whitelist"
    fuzzy-match: true
    description: "红石槽 - 红石机械组件"
    allowed-items:
      - item-id: "REDSTONE"
        description: "红石粉"
      - item-id: "REDSTONE_TORCH"
        description: "红石火把"
      - item-id: "REDSTONE_BLOCK"
        description: "红石块"
      - item-id: "REPEATER"
        description: "中继器"
      - item-id: "COMPARATOR"
        description: "比较器"
      - item-id: "PISTON"
        description: "活塞"
      - item-id: "STICKY_PISTON"
        description: "粘性活塞"
      - item-id: "LEVER"
        description: "拉杆"
      - item-id: "*_BUTTON"  # 所有按钮
        description: "所有按钮类型"
      - item-id: "*_PRESSURE_PLATE"  # 所有压力板
        description: "所有压力板类型"
      - item-id: "TRIPWIRE_HOOK"
        description: "绊线钩"
      - item-id: "OBSERVER"
        description: "观察者"
      - item-id: "HOPPER"
        description: "漏斗"
      - item-id: "DROPPER"
        description: "投掷器"
      - item-id: "DISPENSER"
        description: "发射器"
    forbidden-items: []
  # ==================== 槽位 6 - 交通工具槽 ====================
  # 功能: 仅允许载具和交通相关物品
  # 用途: 快速部署载具
  6:
    mode: "whitelist"
    fuzzy-match: false
    description: "交通工具槽 - 载具和相关物品"
    allowed-items:
      - item-id: "MINECART"
        description: "矿车"
      - item-id: "CHEST_MINECART"
        description: "运输矿车"
      - item-id: "FURNACE_MINECART"
        description: "动力矿车"
      - item-id: "HOPPER_MINECART"
        description: "漏斗矿车"
      - item-id: "TNT_MINECART"
        description: "TNT矿车"
      - item-id: "BOAT"
        description: "船"
      - item-id: "OAK_BOAT"
        description: "橡木船"
      - item-id: "BIRCH_BOAT"
        description: "白桦船"
      - item-id: "SPRUCE_BOAT"
        description: "云杉船"
      - item-id: "JUNGLE_BOAT"
        description: "丛林船"
      - item-id: "ACACIA_BOAT"
        description: "金合欢船"
      - item-id: "DARK_OAK_BOAT"
        description: "深色橡木船"
      - item-id: "MANGROVE_BOAT"
        description: "红树船"
      - item-id: "CHERRY_BOAT"
        description: "樱花船"
      - item-id: "BAMBOO_RAFT"
        description: "竹筏"
      - item-id: "ELYTRA"
        description: "鞘翅"
      - item-id: "FIREWORK_ROCKET"
        description: "烟花火箭"
      - item-id: "SADDLE"
        description: "鞍"
      - item-id: "HORSE_ARMOR"
        description: "马铠"
      - item-id: "*_HORSE_ARMOR"
        description: "所有马铠类型"
    forbidden-items: []
  # ==================== 槽位 7 - 特殊功能槽 ====================
  # 功能: 允许特殊功能物品，但禁止作弊物品
  # 用途: 管理员和特殊权限玩家使用
  7:
    mode: "blacklist"
    fuzzy-match: true
    description: "特殊功能槽 - 禁止作弊物品"
    allowed-items: []
    forbidden-items:
      - item-id: "COMMAND_BLOCK"
        description: "命令方块"
      - item-id: "CHAIN_COMMAND_BLOCK"
        description: "连锁命令方块"
      - item-id: "REPEATING_COMMAND_BLOCK"
        description: "循环命令方块"
      - item-id: "STRUCTURE_BLOCK"
        description: "结构方块"
      - item-id: "JIGSAW"
        description: "拼图方块"
      - item-id: "BARRIER"
        description: "屏障"
      - item-id: "BEDROCK"
        description: "基岩"
      - item-id: "END_PORTAL_FRAME"
        description: "末地传送门框架"
      - item-id: "NETHER_PORTAL"
        description: "下界传送门"
      - item-id: "END_PORTAL"
        description: "末地传送门"
      - name: "§4[管理员]"  # 名称包含管理员标识的物品
        description: "管理员专用物品"
      - name: "§c[作弊]"  # 名称包含作弊标识的物品
        description: "作弊物品"
      - lore: "仅限管理员"  # 描述包含管理员限制的物品
        description: "管理员限制物品"
      - nbt:
          admin_only: "true"  # NBT标记为管理员专用的物品
        description: "NBT标记的管理员物品"
  # ==================== 槽位 8 - 杂项物品槽 ====================
  # 功能: 相对宽松的限制，主要禁止极度危险物品
  # 用途: 通用物品存放，但保持基本安全
  8:
    mode: "blacklist"
    fuzzy-match: true
    description: "杂项槽 - 通用存放(禁止极危险物品)"
    allowed-items: []
    forbidden-items:
      - item-id: "TNT"
        description: "TNT炸药"
      - item-id: "END_CRYSTAL"
        description: "末影水晶"
      - item-id: "WITHER_SKELETON_SKULL"
        description: "凋灵骷髅头颅"
      - item-id: "WITHER_SPAWN_EGG"
        description: "凋灵刷怪蛋"
      - item-id: "ENDER_DRAGON_SPAWN_EGG"
        description: "末影龙刷怪蛋"
      - name: "§4§l[核弹]"  # 极度危险的自定义物品
        description: "核弹类危险物品"
      - name: "§c§l[禁用]"  # 被禁用的物品
        description: "被明确禁用的物品"
      - lore: "§c极度危险"  # 标记为极度危险的物品
        description: "极度危险物品"
      - lore: "§4服务器禁用"  # 服务器禁用的物品
        description: "服务器禁用物品"
      - nbt:
          danger_level: 10  # 危险等级最高的物品
        description: "最高危险等级物品"
      - custom-model-data: 9999  # 特殊模型数据标记的危险物品
        description: "特殊危险物品模型"
# ==================== 高级设置 ====================
# 性能优化设置
performance:
  cache-enabled: true  # 启用缓存机制
  cache-size: 1000  # 缓存大小
  cleanup-interval: 300  # 清理间隔(秒)
# 调试设置
debug:
  enabled: false  # 启用调试模式
  log-level: "INFO"  # 日志级别: DEBUG, INFO, WARN, ERROR
  verbose-matching: false  # 详细匹配日志
# 兼容性设置
compatibility:
  check-custom-items: true  # 检查自定义物品
  support-legacy-ids: false  # 支持旧版物品ID
  strict-nbt-matching: false  # 严格NBT匹配
# 配置文件版本（请勿修改）
config-version: 2

# WarZSlots 消息配置文件
# 支持颜色代码 (&a, &c, &e 等)
# 插件启动/关闭消息
plugin-enabled: "&a[WarZSlots] 插件已启用 v%version%"
plugin-disabled: "&c[WarZSlots] 插件已禁用"
# 物品限制消息
item-not-allowed: "&c此物品不允许放置在该槽位！"
slot-forbidden: "&c该槽位禁止放置任何物品！"
item-moved-to-inventory: "&e物品已移动到背包中"
item-dropped-inventory-full: "&e背包已满，物品已掉落"
# F键限制消息
f-key-disabled: "&cF键交换物品功能已被禁用！"
# 系统错误消息
system-error: "&c系统错误，请联系管理员！"
# 命令消息
command-reload-success: "&a配置文件重载成功！"
command-reload-failed: "&c配置文件重载失败！"
command-no-permission: "&c你没有权限执行此命令！"
command-usage: "&e用法: /warzslots <reload|help>"
command-help: |
  &6=== WarZSlots 帮助 ===
  &e/warzslots reload &7- 重载配置文件
  &e/warzslots help &7- 显示帮助信息
# 调试消息
debug-slot-check: "&7[调试] 检查槽位 %slot% 物品 %item%"
debug-item-allowed: "&a[调试] 物品允许放置"
debug-item-denied: "&c[调试] 物品被拒绝"