原创 付费 [1.7-1.21+] WarZKeyAccess —— 一款高仿搜打撤游戏的高级钥匙 & 门禁系统插件｜实体/虚拟钥匙包｜GUI 管理｜Folia 1.1.4

warz.key.use
warz.key.admin

# WarZKeyAccess 核心配置文件
# 版本: 1.1.0
# 作者: Crazy_Jky

# ==============================================================================
# 基础门禁设置 (Door Settings)
# ==============================================================================

# 自动关门延迟 (单位: 秒)
# 当玩家使用钥匙开门后，门会在多少秒后自动关闭。
# 设置为 0 则禁用自动关门功能（门会一直保持开启直到被手动关闭或再次触发）。
auto-close-delay: 5

# 临时解锁时间 / 防困机制 (单位: 秒)
# 当钥匙成功开启门后，门会进入"临时解锁状态"。
# 在此期间，任何玩家（包括没有钥匙的玩家）都可以直接右键点击门将其开启。
# 设计目的：
# 1. 防止玩家在自动关门后被困在门内。
# 2. 允许队友在短时间内跟随进入。
# 超过此时间后，门将恢复锁定状态，需要钥匙才能再次开启。
temporary-unlock-time: 60

# ==============================================================================
# 数据库设置 (Database Settings)
# ==============================================================================
# 用于存储虚拟钥匙包数据 (Virtual Key Case)。
# 如果启用，玩家可以使用 /key keyring 打开云端同步的虚拟钥匙包。
# 支持 MySQL 数据库，可实现跨服数据同步。
database:
  # 是否启用数据库功能
  # true: 启用 (需填写下方 MySQL 信息)
  # false: 禁用 (虚拟钥匙包命令将不可用)
  enabled: false
 
  # 数据库连接地址 (例如: localhost 或 127.0.0.1)
  host: "localhost"
 
  # 数据库端口 (默认: 3306)
  port: 3306
 
  # 数据库名称
  database: "warz_data"
 
  # 数据库用户名
  username: "root"
 
  # 数据库密码
  password: "password"
 
  # 数据表前缀 (防止表名冲突)
  table-prefix: "warz_"
 
  # 连接池大小 (建议保持默认 10)
  pool-size: 10

# ==============================================================================
# 游戏性设置 (Gameplay Settings)
# ==============================================================================
settings:
  # 临时开门提示方式
  # 当门处于临时解锁状态时，向玩家发送提示的位置。
  # 可选值:
  # - ACTION_BAR: 在屏幕下方的动作栏显示倒计时 (推荐，干扰小)
  # - CHAT: 在聊天栏发送消息
  # - NONE: 不显示提示
  temp-unlock-display: ACTION_BAR

  # 玩家死亡时是否掉落实体钥匙包
  # true: 掉落 (钥匙包作为物品掉落在地上)
  # false: 不掉落 (保留在玩家背包中，类似灵魂绑定)
  drop-key-case: false

  # 玩家死亡时是否掉落钥匙包内的物品
  # 仅当 drop-key-case 为 false 时，此选项才生效。
  # true: 钥匙包本身不掉，但里面的钥匙会散落出来
  # false: 钥匙包和里面的钥匙都不掉落
  drop-key-case-contents: false

  # 是否在钥匙的 Lore 中显示绑定的门的位置
  # 当玩家绑定钥匙时，会自动在钥匙上添加门的位置信息。
  show-bound-location: true
 
  # 绑定位置显示的格式
  # %world% - 世界名
  # %x%, %y%, %z% - 坐标
  bound-location-format: "&7已绑定: &f%world% %x%,%y%,%z%"

  # 自动从钥匙包开门
  # 开启后，如果玩家手持物品无法开门，插件会自动检测玩家背包中的钥匙包（实体），
  # 如果钥匙包内包含匹配的钥匙，则直接消耗并开门。
  auto-open-from-case: true

# ==============================================================================
# 音效配置 (Sound Settings)
# ==============================================================================
# 使用 XSound 格式，支持跨版本兼容。
# 留空则禁用对应音效。
sounds:
  # 成功开门
  door-open: BLOCK_IRON_DOOR_OPEN
  # 门自动关闭
  door-close: BLOCK_IRON_DOOR_CLOSE
  # 尝试开门但没有钥匙
  door-locked: BLOCK_CHEST_LOCKED
  # 钥匙耐久耗尽/损坏
  key-break: ENTITY_ITEM_BREAK
  # 打开钥匙包
  case-open: BLOCK_CHEST_OPEN
  # 关闭钥匙包
  case-close: BLOCK_CHEST_CLOSE

# ==============================================================================
# 钥匙包配置 (Key Cases)
# ==============================================================================
key-cases:
  # 默认实体钥匙包 (ID: default)
  # 通过 /key case [玩家] 获取
  default:
    # 物品显示名称
    name: "&6钥匙包"
    # 物品材质
    material: TRAPPED_CHEST
    # 自定义模型数据 (用于材质包)
    custom-model-data: 0
    # 容器大小 (必须是 9 的倍数)
    size: 9
    # 物品 Lore 描述
    lore:
      - "&7用于存放钥匙"
      - "&e右键打开"

  # 虚拟钥匙包配置 (ID: virtual)
  # 通过 /key keyring 打开
  virtual:
    # 界面标题
    name: "&d我的虚拟钥匙包"
    # 容器大小 (必须是 9 的倍数)
    # 注意: 虚拟钥匙包固定为 6 行 (54格)，其中最后一行用于翻页
    size: 54
    # 默认总页数 (用于显示锁定槽位，让玩家知道还有多少空间可解锁)
    total-pages: 3
    # 锁定槽位的显示物品
    locked-slot:
      material: BARRIER
      name: "&c未解锁槽位"
      lore:
        - "&7提升等级以解锁更多槽位"
      custom-model-data: 0

# ==============================================================================
# 钥匙配置 (Keys)
# ==============================================================================
# 定义服务器中所有的钥匙类型。
# 修改后需使用 /key reload 重载。
keys:
  # 示例钥匙 1: 工厂钥匙 (耐久型)
  factory_key:
    name: "&c工厂钥匙"
    # 钥匙类型:
    # - SINGLE: 一次性使用 (用完即消失)
    # - DURABLE: 有耐久度 (可使用多次)
    type: DURABLE
    material: TRIPWIRE_HOOK
    custom-model-data: 1001
    # 最大使用次数 (仅对 DURABLE 有效)
    max-uses: 25
    lore:
      - "&7开启工厂大门的钥匙"
      - "&7剩余次数: &e%uses%" # %uses% 会被替换为剩余次数

  # 示例钥匙 2: 实验室蓝卡 (一次性)
  lab_card:
    name: "&b实验室蓝卡"
    type: SINGLE
    material: PAPER
    custom-model-data: 2001
    lore:
      - "&7一次性门禁卡"
      - "&7使用后销毁"

# ==============================================================================
# 世界设置 (World Settings)
# ==============================================================================
# 设置不同世界的特殊规则。
# 目前支持:
# - durability-multiplier: 钥匙耐久消耗倍率 (默认: 1.0)
#   例如设置为 2.0，则每次使用钥匙消耗 2 点耐久。
world-settings:
  # 示例世界: 绝密区域
  # world_the_end:
  #   durability-multiplier: 2.0
  # 示例: 地狱世界耐久消耗 1.5 倍
  world_nether:
    durability-multiplier: 1.5