Ominous Chest Lock (& Lock Picking)

插件

· 作者 cev-api

Paper 插件(1.21.0 –> 26.2)和 Fabric 服务器模组(1.21.11 + 26.2),可将任意容器锁定至名为“Ominous”或常规试炼钥匙,并附带可选的开锁小游戏!

0 本站下载 0 关注 更新于 2 个月前

最新 1.3.4 · 26.2 · Fabric

一键开服(送7天)

OminousChestLock

Paper 插件(1.21.0 --> 26.2)和 Fabric 服务器模组(1.21.11 + 26.2),可将箱子、双层箱子、 barrel(木桶)和潜影盒锁定到指定名称的“不祥”或普通试炼钥匙,并可选地提供开锁小游戏。

工作原理

  • 在铁砧上将一把不祥试炼钥匙重命名(例如:secretkeyname)。
  • 手持该钥匙右键点击箱子、木桶或潜影盒以将其锁定。
  • 只有持有匹配名称钥匙的玩家才能打开、破坏或以其他方式与锁定的容器互动。
  • 锁定基于钥匙名称,而非玩家身份。钥匙可能被窃取或复制。
  • 一名玩家在同一时间只能使用一个钥匙名称锁定一个容器。
  • 不同玩家可以使用相同的钥匙名称来锁定各自的一个容器。
  • 如果两名玩家使用了相同的钥匙名称,任何一把匹配的钥匙都可以打开任何一个被锁定的容器。
  • 可选:启用普通试炼钥匙。首次使用普通钥匙成功打开会激活锁定;第二次成功打开则会消耗钥匙并永久解锁容器。
  • 仅限 Paper:通过 Vault 经济系统提供可选的付费恢复功能。如果玩家既是锁的所有者又是最后使用者,且手中或背包中没有匹配的钥匙,他们会收到一个可点击的 locksmith(锁匠)服务费提示(或执行 /chestlockrecover confirm)以解锁容器。

Vault 音效用于成功/失败的反馈。

玩家反馈消息

  • 在没有钥匙的情况下尝试打开锁定的容器显示:This chest is locked. You need the correct key.
  • 使用错误的钥匙尝试打开锁定的容器显示:Wrong key.
  • 在没有正确钥匙的情况下尝试破坏锁定的容器显示:This chest is locked and cannot be broken.
  • 破坏尝试的聊天警告设有速率限制,以避免因反复尝试破坏而产生垃圾信息。
  • 成功的开锁操作不会在聊天中透露钥匙名称(Chest lock successfully picked.)。
  • 可选的详细加锁/解锁聊天记录可通过以下方式切换:
    • 配置文件:messages.verbose-lock-actions
    • 命令:/chestlock verbosemessages <on|off>
  • 符合条件的付费恢复功能会显示可点击的锁匠服务费提示,并提供 /chestlockrecover confirm 作为备用选项。

开锁

可以制作并使用三种开锁工具来在缺少正确钥匙时开启锁定的容器。尝试次数和锁定状态会根据配置的范围针对每种开锁工具类型进行追踪。

  • 生锈的钥匙:copper ingot + tripwire hook + stick(默认断裂率 88%)。
  • 普通钥匙:iron ingot + tripwire hook + breeze rod(默认断裂率 33%)。
  • 寂静钥匙:在锻造台上将 normal pick + silence trim + echo shard 组合(默认断裂率 5%)。

锁定上限是 lockpicks.limit.min 和 lockpicks.limit.max(包含边界)之间的随机掷骰结果。该掷骰发生在该类型开锁工具的第一次尝试时,并存储在锁上,直到容器被解锁/销毁。

锁定范围可以通过 lockpicks.lockout-scope 设置为 chest(所有玩家共享)或 player(每个玩家拥有自己的锁定/尝试记录)。

在失败尝试时,玩家会受到伤害(默认值:生锈/普通/寂静钥匙分别为 0.5/1/2 颗心)。当超过限制时,生锈和普通钥匙会硬锁定。寂静钥匙使用软超限惩罚,并在 lockpicks.silence.penalty-reset-minutes 分钟后重置。寂静重置计时器锚定于第一次超限尝试,并且不会因为后续的超限尝试而延长。

尝试次数上限掷骰、锁定追踪和失败伤害规则适用于两种开锁模式(传统 RNG 和小游戏模式)。在小游戏模式中,每次按下 TURN LOCK 都算作一次尝试,失败的回合应用配置的开锁伤害。

开锁模式

  • lockpicks.minigame.enabled: false -> 传统 RNG 模式(使用 open-chance 和 normal-key-chance)。
  • lockpicks.minigame.enabled: true -> 插销小游戏模式(默认模式)。

小游戏模式

  • 打开自定义库存界面(插销作为列,深度作为行)。
  • 生成的锁秘密和配置值的深度范围限制为 5(1..5)。
  • 左键单击:选择插销的深度。右键单击:排除候选项。
  • 每次按下 TURN LOCK 都会消耗完整的一次尝试(失败回合适用尝试/断裂/伤害规则)。
  • 成功需要所有选定的深度与秘密插销布局匹配。
  • 回合距离计量表渲染在小游戏库存界面的底部行(全宽)。
  • Bossbar 反馈:
    • 正常失败:黄色回合距离,然后红色 Chest Locked!,然后重置。
    • 硬锁定失败:红色 Locked Out(无回合距离动画)。
    • 成功:填满至满格,闪烁绿色 Chest Unlocked!,然后解锁并打开容器。
  • 可选的视觉反馈替代方案(在 GUI 内部):
    • 底部行计量表(全宽)随回合距离填充,然后在失败/成功时闪烁红/绿色。
    • 库存标题行为:
      • 空闲标题:Locked Chest
      • 反馈事件期间:标题变为状态文本(Turn Distance, Chest Locked!, Locked Out, Chest Unlocked!)并匹配相应颜色
      • 事件结束后返回 Locked Chest
  • lockpicks.minigame.bossbar.enabled 控制 Bossbar 的开关。
  • lockpicks.minigame.visual-feedback.enabled 控制库存计量表反馈的开关。
  • 会话所有权:每个容器只有一个活跃的开锁者。
  • 会话超时:由 lockpicks.minigame.session-timeout-seconds 控制。
  • 锁定/超限时插销再生可根据锁类型配置:
    • 试炼默认:稳定的插销布局(regenerate-on-attempt: false)
    • 不祥默认:锁定/超限时重新掷骰(regenerate-on-attempt: true)

资源包

物品模型覆盖和纹理在 src/main/resources/resourcepack 中提供。将此文件夹用作资源包即可在手中和库存中看到开锁工具的纹理。

预打包的 zip 文件将与本插件的编译二进制文件一起发布在发布页面。

数据

锁数据存储于 plugins/OminousChestLock/data.yml。条目包括钥匙名称、创建者和最后使用者。如果启用,它还会存储开锁尝试/锁定状态和小游戏插销数据。

已解锁的容器会从 data.yml 中移除。

旧版本的条目在保存时会自动读取并升级。

示例:

locked-chests:
  test:-8,104,40:
    key: key2
    world:
      name: test
      realm: OVERWORLD
      uuid: 01234567-89ab-cdef-0123-456789abcdef
    creator:
      name: Billy
      uuid: 01234567-89ab-cdef-0123-456789abcdef
    last-user:
      name: Tito
      uuid: 01234567-89ab-cdef-0123-456789abcdef
    pick:
      last:
        name: CevAPI
        uuid: 01234567-89ab-cdef-0123-456789abcdef
        type: silence
        timestamp: 1767877437911
      silence:
        limit: 2
        attempts: 3
        over-limit-attempts: 3
        penalty-timestamp: 1767877437911
    minigame:
      type: ominous
      pins: 6
      depths: 5
      secret: [1, 4, 2, 5, 1, 3]
      created: 1767877437911
      salt-version: 1

管理员命令

需要权限 chestlock.admin(默认:op)。

  • /chestlock info - 显示所查看容器的钥匙名称、创建者、最后使用者以及小游戏密码组合。
  • /chestlock unlock - 强制解锁所查看的容器。
  • /chestlock keyinfo - 显示手中钥匙对应的锁定容器位置及所有者信息。
  • /chestlock reload - 从磁盘重新加载锁数据。
  • /chestlock loglevel <0-3> - 设置日志详细程度。
  • /chestlock normalkeys <on|off> - 允许使用普通试错钥匙。
  • /chestlock lockpicks <on|off> - 允许开锁和制作开锁工具。
  • /chestlock verbosemessages <on|off> - 切换详细的锁/解锁聊天消息。
  • /chestlock minigame <on|off> - 切换开锁小游戏模式。
  • /chestlock minigamebossbar <on|off> - 切换小游戏的 Boss 栏反馈。
  • /chestlock minigamevisual <on|off> - 切换小游戏的物品栏计量表视觉反馈。
  • /chestlock pinicon <material> - 设置选定的图钉图标材质(例如:end_rod)。
  • /chestlock lockoutscope <chest|player> - 设置锁定范围。
  • /chestlock settings - 以彩色格式显示当前加载的设置。
  • /chestlock give <player> <rusty|normal|silence> [amount] - 给予玩家开锁工具。
  • /chestlock help - 显示帮助信息。
  • /chestlockrecover confirm - 在提示后确认支付开锁服务费进行解锁(仅限 Paper + Vault 经济插件)。

配置

配置文件位于 plugins/OminousChestLock/config.yml:

  • logging.level:

    • 0 = 无日志
    • 1 = 全部(包括开锁成功与失败)
    • 2 = 开锁失败 + 破坏/自动化尝试(包括撬锁失败)
    • 3 = 仅破坏/自动化尝试
  • keys.allow-normal:

    • false = 仅限诡异钥匙
    • true = 诡异钥匙 + 普通试炼钥匙
  • messages.verbose-lock-actions:

    • false = 不显示可选的加锁/解锁动作聊天信息
    • true = 仅向执行操作的玩家显示加锁/解锁动作聊天信息
  • recovery.paid-unlock.enabled(仅 Paper):

    • false = 禁用 locksmith(锁匠)服务恢复功能
    • true = 允许符合条件的玩家确认付费恢复开锁
  • recovery.paid-unlock.cost(仅 Paper):

    • 由 Vault 经济插件收取的锁匠服务费金额
  • lockpicks.enabled:

    • false = 禁用撬锁的制作和使用
    • true = 启用撬锁的制作和使用
  • lockpicks.limit.min / lockpicks.limit.max:

    • 每次撬锁类型在被锁定前的随机尝试次数上限(包含边界值)
    • 该上限在首次尝试使用该类型撬锁时生成一次,并存储在该被锁容器中,直到其被解锁或销毁
  • lockpicks.lockout-scope:

    • chest = 所有玩家共享该容器上的撬锁锁定状态
    • player = 每个玩家的撬锁锁定状态单独追踪
  • lockpicks.rusty.*, lockpicks.normal.*, lockpicks.silence.*:

    • open-chance = 基础成功率(0.0–1.0)
    • normal-key-chance = 使用普通钥匙开锁的成功率(仅适用于生锈/普通撬锁)
    • break-chance = 每次尝试的损坏概率(0.0–1.0)
    • damage = 每次失败尝试造成的伤害(以心数为单位)
    • penalty-reset-minutes = 沉默撬锁超限后的重置时间(分钟)
  • lockpicks.minigame.*:

    • enabled = 使用小游戏替代基于 RNG 的撬锁概率判定
    • trial.pins / trial.depths = 试炼锁小游戏尺寸
    • trial.assist-eliminate-one = 可选的试炼辅助消除选项
    • trial.regenerate-on-attempt = 在锁定/超限回合重新掷出试炼秘密代码
    • ominous.pins / ominous.depths = 诡异锁小游戏尺寸
    • ominous.regenerate-on-attempt = 在锁定/超限回合重新掷出诡异秘密代码
    • session-timeout-seconds = 活跃会话自动超时时间(秒)
    • bossbar.enabled = 启用/禁用 Boss 栏反馈
    • bossbar.animate-ticks / bossbar.peak-hold-ticks / bossbar.snapback-delay-ticks = 进度条计时参数
    • visual-feedback.enabled = 启用/禁用物品栏计量表反馈
  • visual-feedback.rename-inventory-title = 在物品栏标题中显示状态文本

    • ui.pin-icon = 迷你游戏网格中选中的图钉方块所使用的材质
    • sounds.click-per-correct-pin = 点击正确图钉时的反馈音效模式
    • security.require-holding-pick = 必须手持匹配的钥匙才能进行操作
    • salt + salt-version = 首次生成秘密时使用的种子输入

示例:

logging:
  # 0 = 无日志,1 = 全部日志,2 = 失败 + 破坏/自动化相关日志,3 = 仅破坏/自动化相关日志
  level: 1
keys:
  # false = 仅允许使用灾厄试炼钥匙,true = 允许使用灾厄与常规试炼钥匙
  allow-normal: true
messages:
  # true = 向执行操作的玩家发送锁的锁定/解锁状态聊天消息
  verbose-lock-actions: false
recovery:
  paid-unlock:
    # 需要安装 Vault 插件及经济系统提供者(例如通过 Vault 接入 EssentialsX Economy)
    enabled: false
    # 当符合资格时,开锁匠服务收取的恢复锁定的费用
    cost: 5000.0
lockpicks:
  # true = 允许制作和使用撬锁工具
  enabled: true
  # 触发封禁前的随机尝试次数上限
  limit:
    min: 1
    max: 20
  # 封禁作用范围:"chest" = 所有玩家共享封禁状态,"player" = 按玩家单独追踪封禁状态
  lockout-scope: chest
  rusty:
    open-chance: 0.05
    normal-key-chance: 0.1
    break-chance: 0.88
    damage: 1.0
  normal:
    open-chance: 0.1
    normal-key-chance: 0.2
    break-chance: 0.33
    damage: 2.0
  silence:
    open-chance: 0.5
    break-chance: 0.05
    damage: 4.0
    # 超过限制惩罚重置所需的时间(分钟)
    penalty-reset-minutes: 60
  minigame:
    enabled: true
    trial:
      pins: 4
      depths: 4
      assist-eliminate-one: true
      regenerate-on-attempt: false
    ominous:
      pins: 6
      depths: 5
      regenerate-on-attempt: true
    session-timeout-seconds: 90
    bossbar:
      enabled: true
      animate-ticks: 12
      peak-hold-ticks: 20
      snapback-delay-ticks: 20
    visual-feedback:
      enabled: true
      rename-inventory-title: true
    ui:
      pin-icon: end_rod
    sounds:
      click-per-correct-pin: true
    security:
      require-holding-pick: true
    salt: "change-me"
    salt-version: 1

示例日志条目

[OminousChestLock] EXPLOSION_DENY actor=TNT:CevAPI usedKey=none lockKey=secretkeyname creator=Bingo lastUser=George location=test:-9,104,40 (OVERWORLD)
[OminousChestLock] INVENTORY_MOVE_DENY actor=HOPPER:CevAPI usedKey=none lockKey=secretkeyname creator=Bingo lastUser=Bingo location=test:-21,104,22 (OVERWORLD) detail=source=CHEST dest=HOPPER
[OminousChestLock] BREAK_DENY actor=CevAPI usedKey=none lockKey=secretkeyname creator=Bingo lastUser=George location=test:-9,104,40 (OVERWORLD)
[OminousChestLock] INTERACT_DENY actor=CevAPI usedKey=cevapcici lockKey=secretkeyname creator=Bingo lastUser=Bingo location=test:-52,104,66 (OVERWORLD)
[OminousChestLock] OPEN_ALLOWED actor=CevAPI usedKey=secretkeeey lockKey=secretkeeey creator=CevAPI lastUser=CevAPI location=test:-6,104,37 (OVERWORLD)
[OminousChestLock] BREAK_ALLOWED actor=CevAPI usedKey=secretkeeey lockKey=secretkeeey creator=CevAPI lastUser=CevAPI location=test:-6,104,37 (OVERWORLD)
[OminousChestLock] PICK_FAIL actor=CevAPI usedKey=none lockKey=secretkeeey creator=Bingo lastUser=Bingo location=test:-6,104,37 (OVERWORLD) detail=pick=rusty
[OminousChestLock] PICK_SUCCESS actor=CevAPI usedKey=none lockKey=secretkeeey creator=Bingo lastUser=Bingo location=test:-6,104,37 (OVERWORLD) detail=pick=normal
[OminousChestLock] PICK_FAIL actor=CevAPI usedKey=none lockKey=secretkeeey creator=Bingo lastUser=Bingo location=test:-40,64,-82 (OVERWORLD) detail=pick=silence mode=minigame combo=1-4-5-?-?-? actual=1-4-5-5-6-4 limit=9/16 untilLimit=7

权限

  • chestlock.admin - 允许使用管理员命令(默认:op)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源