Locks Reforged

# Locks Reforged **An unofficial port of the Locks mod by (https://github.com/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 | * **Pins** — Number of pins in the lock picking minigame. More pins = harder to pick. * **Enchantability** — How likely the lock is to receive powerful enchantments. * **Resistance** — 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 **keys** that match your locks, or use a **Key Ring** to carry multiple keys. A **Master Key** opens any lock. ### Seven Enchantments * **Shocking** — Zaps players who fail a pick attempt (bypasses armor) * **Sturdy** — Reduces pick effectiveness * **Complexity** — Blocks lower-tier picks entirely * **Silent** — Suppresses the rattle sound when access is denied * **Auto-Pick** — Chance to instantly open the lock, bypassing the minigame * **Reinforced** — 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. * **Multi-sample averaging** — each loot table is sampled 32 times and averaged for consistent tier assignments across server restarts. * **Sub-linear stack count** — 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 * **Generation Chance** —