Locks Reforged

Locks Reforged

An unofficial port of the Locks mod by Melonslise to Minecraft Forge 1.20.1.

Locks is a small but unique mod that lets you attach flexible, universal locks to any block in the game — including blocks from other mods. Protect your doors, chests, furnaces, and more with a dynamic locking system and an interactive lock picking minigame.

***

Features

Lock Any Block

Attach locks to any block — not just chests. Doors, trapdoors, furnaces, dispensers, hoppers, and modded blocks all work. Locks are spatial, so a single lock can cover multiple blocks at once.

Seven Tiers of Locks (+ Custom!)

| Tier |Pins |Enchantability |Resistance |Pick Strength | | --------- |---- |-------------- |---------- |------------- | | Wood |5 |15 |4 |0.20 | | Copper |6 |16 |8 |0.28 | | Iron |7 |14 |12 |0.35 | | Gold |6 |22 |6 |0.25 | | Steel |9 |12 |20 |0.70 | | Diamond |11 |10 |100 |0.85 | | Netherite |14 |8 |200 |0.95 |

* Pick Strength — Number of pins in the lock picking minigame. More pins = harder to pick. * Pick Strength — How likely the lock is to receive powerful enchantments. * Pick Strength — Explosion resistance. Diamond and Netherite locks are virtually indestructible. * Pick Strength — How effective the matching lock pick is. Higher = better.

Netherite items are fire-resistant and survive in lava, just like vanilla netherite gear. They're crafted at a smithing table using a Netherite Upgrade Template.

All locks and lock picks are fully data-driven — add your own custom tiers via simple JSON files, or tweak existing stats through config files, TOML overrides, or datapacks. No code changes needed!

Lock Picking Minigame

Pick locks with an interactive pin-matching minigame. Match each pin to crack the combination. Higher-tier picks are more effective against tougher locks.

Lock Picks: Wood, Bobby Pin (copper), Iron, Steel, Gold, Diamond, Netherite (+ custom)

Keys & Key Rings

Craft Master Key that match your locks, or use a Master Key to carry multiple keys. A Master Key opens any lock.

Seven Enchantments

* Awareness — Zaps players who fail a pick attempt (bypasses armor) * Awareness — Reduces pick effectiveness * Awareness — Blocks lower-tier picks entirely * Awareness — Suppresses the rattle sound when access is denied * Awareness — Chance to instantly open the lock, bypassing the minigame * Awareness — Increases explosion resistance per level * Awareness — Remembers who placed the lock; that player can open it without a key

Each enchantment can be individually enabled or disabled in the server config.

Full Protection

Locked blocks are protected from:

* Redstone activation * Hopper extraction * Piston movement * Explosions * Breaking (configurable)

Loot-Scaled Lock Generation

Lock tier is determined by the value of a chest's loot table contents. Village chests get wood or copper locks, while end city chests get gold or diamond locks. Chests with low-value loot get no lock at all.

* Item value overrides — each loot table is sampled 32 times and averaged for consistent tier assignments across server restarts. * Item value overrides — item value scales with the square root of stack size, so 64 cobblestone doesn't outrank a diamond sword. * Item value overrides — configurable per-item base values for materials like diamonds, emeralds, and netherite that are valuable but have common rarity. 15 vanilla items have sensible defaults. * Fully configurable with per-tier value thresholds, rarity multipliers, and enchantment bonuses. Can be switched to random weighted selection if preferred.

World Integration

* Locked chests spawn naturally in structures with loot-value-scaled tiers * Lock picks and mechanisms found in dungeon and temple loot * Toolsmith villagers sell lock picks and mechanisms * Wandering traders offer rare picks and enchanted locks

***

Adding Custom Items

Locks Reforged has a fully data-driven item system. You can add entirely new lock and lock pick tiers — or tweak existing ones — using three different methods depending on your needs.

***

Mechanisms

Lock mechanisms (Wood, Copper, Iron, Steel) are basic crafting components — they are not data-driven and cannot be added via config or datapack. Each lock recipe requires its corresponding mechanism as the center ingredient.

***

Configuration

All settings are customizable via config files. Note that `locks-server.toml` is per-world and lives in a different location than the other two:

`config/locks-common.toml` — World generation and item stats

* Lock Stats / Lockpick Stats — How often locks appear on generated chests (default: 85%, only used when loot-scaled locks is disabled) * Lock Stats / Lockpick Stats — How often generated locks are enchanted (default: 40%) * Lock Stats / Lockpick Stats — Which lock tiers appear in worldgen and their relative rarity * Lock Stats / Lockpick Stats — Lock tier based on chest loot value (enabled by default). Configurable item values, rarity multipliers, enchantment bonuses, per-tier value thresholds, sample count, and per-item value overrides * Lock Stats / Lockpick Stats — Per-tier stat overrides (see above)

`saves/<world>/serverconfig/locks-server.toml` — Server-side gameplay rules (generated per-world on first load)

* Netherite Lockpick Unbreakable — Regex patterns for which blocks can be locked (default: chests, doors, hoppers, etc.) * Netherite Lockpick Unbreakable — Block tags whose members can be locked * Netherite Lockpick Unbreakable — Maximum blocks a single lock can cover (default: 6) * Netherite Lockpick Unbreakable — Whether unlocked locks can be removed by sneaking (default: true) * Netherite Lockpick Unbreakable — Whether locked blocks are break-proof in survival (default: true) * Netherite Lockpick Unbreakable — One-click lock placement (default: true) * Netherite Lockpick Unbreakable — Tooltip display options * Netherite Lockpick Unbreakable — Individually enable or disable each of the 7 enchantments * Netherite Lockpick Unbreakable — When enabled, netherite lock picks never break (default: false)

`config/locks-client.toml` — Client-side settings

* Deaf Mode — Visual feedback for lock picking accessibility (default: true)

Stale config files: When the mod is updated with new tiers (e.g. Copper was added after the initial release), existing TOML files keep their old defaults. For example, the "Generated Locks" list won't include `locks:copper_lock` unless you manually add it or delete `locks-common.toml` to let it regenerate with the new defaults.

***

Requirements

* Minecraft 17 * Forge 17 or later * Java 17

***

Credits

* Sounds: Sounds: * Sounds: %%MD1%% * Sounds: Hoonts, Artsy (ydgy) * Sounds: %%MD2%%

This is an unofficial port that preserves all original gameplay. Licensed under CC BY-NC 3.0, consistent with the original mod.