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):
-
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)。
OminousChestLock
Paper plugin (1.21.0 --> 26.2) and Fabric server mod (1.21.11 + 26.2) that locks chests, double chests, barrels, and shulker boxes to a named Ominous or regular Trial Key, with an optional lockpicking minigame.
How it works
- Rename an ominous trial key in an anvil (example:
secretkeyname).
- Right-click a chest, barrel, or shulker box while holding that key to lock it.
- Only players holding a matching named key can open, break, or otherwise interact with the locked container.
- Locks are key-name based, not player based. Keys can be stolen or copied.
- One player can lock only one container per key name at a time.
- Different players can reuse the same key name for their own single container.
- If two players use the same key name, either matching key can open either container.
- Optional: normal trial keys can be enabled. The first successful open with a normal key arms the lock; the next successful open consumes the key and permanently unlocks the container.
- Paper only: optional paid recovery via Vault economy. If the player is both the lock owner and last user, has no matching key in hand or inventory, they get a clickable locksmith service fee prompt (or
/chestlockrecover confirm) to unlock.
Vault sounds are used for success/failure feedback.
Player feedback messages
- Opening a locked container with no key shows:
This chest is locked. You need the correct key.
- Opening a locked container with the wrong key shows:
Wrong key.
- Breaking a locked container without the correct key shows:
This chest is locked and cannot be broken.
- Break-attempt chat warnings are rate-limited to avoid spam when repeatedly attempting to break.
- Successful lockpicking does not reveal the key name in chat (
Chest lock successfully picked.).
- Optional verbose lock/unlock chat can be toggled with:
- Config:
messages.verbose-lock-actions
- Command:
/chestlock verbosemessages <on|off>
- Eligible paid recovery shows a clickable locksmith service fee prompt and
/chestlockrecover confirm fallback.
Lock picking
Three lock picks can be crafted and used to pick locked containers when you do not have the correct key. Attempts and lockouts are tracked per pick type, using the configured lockout scope.
- Rusty pick:
copper ingot + tripwire hook + stick (default 88% break chance).
- Normal pick:
iron ingot + tripwire hook + breeze rod (default 33% break chance).
- Silence pick:
normal pick + silence trim + echo shard in a smithing table (default 5% break chance).
Lockout limit is a random roll between lockpicks.limit.min and lockpicks.limit.max (inclusive). The roll happens on the first pick attempt for that pick type and is stored on the lock until it is unlocked/destroyed.
Lockout scope can be set to chest (shared across all players) or player (each player has their own lockout/attempts) via lockpicks.lockout-scope.
On failed attempts, the player takes damage (defaults: 0.5/1/2 hearts for rusty/normal/silence). Rusty/normal lock out hard when over limit. Silence uses soft over-limit penalties and resets after lockpicks.silence.penalty-reset-minutes. The silence reset timer is anchored to the first over-limit attempt and does not extend with additional over-limit tries.
The attempt limit roll, lockout tracking, and fail-damage rules apply in both lockpick modes (legacy RNG and minigame). In minigame mode, each TURN LOCK press counts as an attempt, and failed turns apply the configured pick damage.
Lockpick modes
lockpicks.minigame.enabled: false -> legacy RNG mode (uses open-chance and normal-key-chance).
lockpicks.minigame.enabled: true -> pin minigame mode (default mode).
Minigame mode
- Opens a custom inventory UI (pins as columns, depths as rows).
- Depth range is capped at 5 (
1..5) for generated lock secrets and config values.
- Left click: select depth for a pin. Right click: eliminate candidate.
TURN LOCK consumes one full attempt each press (attempt/break/damage rules apply on failed turns).
- Success requires all selected depths to match the secret pinout.
- Turn-distance meter is rendered on the bottom row of the minigame inventory (full width).
- Bossbar feedback:
- Normal fail: yellow turn distance, then red
Chest Locked!, then reset.
- Hard lockout fail: red
Locked Out (no turn-distance animation).
- Success: fills to full, flashes green
Chest Unlocked!, then unlocks and opens the container.
- Optional visual feedback alternative (inside GUI):
- Bottom row meter (full width) fills with turn distance, then flashes red/green on fail/success.
- Inventory title behavior:
- Idle title:
Locked Chest
- During feedback events: title changes to status text (
Turn Distance, Chest Locked!, Locked Out, Chest Unlocked!) with matching color
- Returns to
Locked Chest after the event
lockpicks.minigame.bossbar.enabled toggles bossbar on/off.
lockpicks.minigame.visual-feedback.enabled toggles inventory meter feedback on/off.
- Session ownership: only one active picker per container.
- Session timeout: controlled by
lockpicks.minigame.session-timeout-seconds.
- Pin regeneration on lockout/over-limit turn is configurable per lock type:
- Trial default: stable pinout (
regenerate-on-attempt: false)
- Ominous default: reroll on lockout/over-limit (
regenerate-on-attempt: true)
Resource pack
Item model overrides and textures are provided in src/main/resources/resourcepack. Use this folder as a resource pack to see the lock pick textures in-hand and in inventories.
A prepackaged zip will be provided in the releases page along with the compiled binary of this plugin.
Data
Lock data is stored in plugins/OminousChestLock/data.yml. Entries include the key name, creator, and last user. If enabled, it also stores lockpick attempt/lockout state and minigame pin data.
Unlocked chests are removed from the data.yml.
Existing entries from older versions are automatically read and upgraded when saved.
Example:
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
Admin commands
Requires chestlock.admin (default: op).
/chestlock info - Show key name, creator, last user, and minigame pin combo for the looked-at container.
/chestlock unlock - Force unlock the looked-at container.
/chestlock keyinfo - Show the locked container location and owner info for the key in hand.
/chestlock reload - Reload lock data from disk.
/chestlock loglevel <0-3> - Set log verbosity.
/chestlock normalkeys <on|off> - Allow normal trial keys.
/chestlock lockpicks <on|off> - Allow lock picking and crafting.
/chestlock verbosemessages <on|off> - Toggle verbose lock/unlock chat messages.
/chestlock minigame <on|off> - Toggle lockpick minigame mode.
/chestlock minigamebossbar <on|off> - Toggle bossbar feedback for minigame.
/chestlock minigamevisual <on|off> - Toggle inventory meter visual feedback for minigame.
/chestlock pinicon <material> - Set selected pin icon material (example: end_rod).
/chestlock lockoutscope <chest|player> - Set lockout scope.
/chestlock settings - Show current loaded settings with color formatting.
/chestlock give <player> <rusty|normal|silence> [amount] - Give lock picks to a player.
/chestlock help - Show help.
/chestlockrecover confirm - Confirm locksmith service fee unlock after prompt (Paper + Vault economy only).
Config
Config in plugins/OminousChestLock/config.yml:
logging.level:
0 = nothing
1 = everything (includes lock pick successes and failures)
2 = failed unlock + destruction/automation attempts (includes lock pick failures)
3 = destruction/automation attempts only
keys.allow-normal:
false = ominous keys only
true = ominous + normal trial keys
messages.verbose-lock-actions:
false = no optional verbose lock/unlock action chat
true = show lock/unlock action chat to the acting player only
recovery.paid-unlock.enabled (Paper only):
false = locksmith service recovery disabled
true = allows eligible players to confirm paid recovery unlock
recovery.paid-unlock.cost (Paper only):
- locksmith service fee amount charged by Vault economy provider
lockpicks.enabled:
false = lock pick crafting/usage disabled
true = lock pick crafting/usage enabled
lockpicks.limit.min / lockpicks.limit.max:
- Random attempt limit (inclusive) before lockout per pick type
- The limit is rolled once on the first pick attempt for that pick type and then stored on that locked container until it is unlocked/destroyed
lockpicks.lockout-scope:
chest = pick lockout is shared by all players on that container
player = pick lockout is tracked separately per player
lockpicks.rusty.*, lockpicks.normal.*, lockpicks.silence.*:
open-chance = base success chance (0.0–1.0)
normal-key-chance = success chance for normal-key locks (rusty/normal only)
break-chance = break chance per attempt (0.0–1.0)
damage = hearts of damage per failed attempt
penalty-reset-minutes = silence pick over-limit reset time (minutes)
lockpicks.minigame.*:
enabled = use minigame instead of RNG pick chances
trial.pins / trial.depths = trial lock minigame size
trial.assist-eliminate-one = optional trial helper
trial.regenerate-on-attempt = reroll trial secret on lockout/over-limit turn
ominous.pins / ominous.depths = ominous lock minigame size
ominous.regenerate-on-attempt = reroll ominous secret on lockout/over-limit turn
session-timeout-seconds = auto-timeout for active sessions
bossbar.enabled = enable/disable bossbar feedback
bossbar.animate-ticks / bossbar.peak-hold-ticks / bossbar.snapback-delay-ticks = turn bar timing
visual-feedback.enabled = enable/disable inventory meter feedback
visual-feedback.rename-inventory-title = show status text in inventory title
ui.pin-icon = material used for selected pin cells in the minigame grid
sounds.click-per-correct-pin = click sequence feedback mode
security.require-holding-pick = must keep matching pick in hand
salt + salt-version = seed inputs for first-time secret generation
Example:
logging:
# 0 = nothing, 1 = everything, 2 = failed + destruction/automation, 3 = destruction/automation only
level: 1
keys:
# false = ominous trial keys only, true = ominous + normal trial keys
allow-normal: true
messages:
# true = send the acting player lock/unlock status chat messages
verbose-lock-actions: false
recovery:
paid-unlock:
# requires Vault + an economy provider (e.g., EssentialsX Economy via Vault)
enabled: false
# locksmith service fee to recover a lock when eligible
cost: 5000.0
lockpicks:
# true = allow lock pick crafting and usage
enabled: true
# random attempt limit before lockout
limit:
min: 1
max: 20
# lockout scope: "chest" = shared for all players, "player" = per-player lockout tracking
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
# time until over-limit penalty resets
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
Example log entries
[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
Permissions
chestlock.admin - Allows use of admin commands (default: op).
评论 0
登录后参与评分
还没有评论,来抢沙发吧