🧱 ChestLocker Mod – Secure Your Chests Like a Pro!
🔐 Protect your storage. Lock with a key. Share with friends.
💡 Features
- 🔒 Lock any chest with a password-protected Key Item (Tripwire Hook).
- 🔑 Each key stores its own password and owner (UUID-based), so only the true owner can lock or unlock.
- 🧍♂️ Whitelist system lets you share access with trusted players via
/chestaccesscommands. - 🧱 Break protection: Locked chests cannot be broken or moved until unlocked.
- 💬 HUD display: Shows “Locked by:
” when looking at a locked chest. - 💾 Data persistence: All locks automatically save to
config/chestlocker.json. - ⚙️ Multiplayer safe: All checks are server-authoritative — no client-side exploits.
🔧 How to Use
🪄 1. Create a Key
Hold a Tripwire Hook → Shift + Right-Click → Enter your password.
This will save your name and UUID onto the key.
🔐 2. Lock a Chest
Hold your key → Right-Click on a chest.
If you’re the owner, the chest will lock immediately and be stored securely.
🔓 3. Unlock a Chest
Hold your key → Shift + Right-Click on a locked chest.
The mod verifies your UUID + password hash — if they match, the chest unlocks!
🧍🤝🧍 Whitelist Commands
You can grant or revoke chest access to friends:
- /chestaccess add
- /chestaccess remove
- /chestaccess list
🧭 Tips
- Press Shift while hovering your key to reveal the real password.
- The key’s tooltip shows:
🔑 Key of <owner>
Password: ••••••••
Hold SHIFT to reveal
- You can only use your own key; others’ keys are invalid.
⚡ Security Summary
| Action | Requirement | Result |
|---|---|---|
| Lock chest | Your key (owner UUID matches) | ✅ Success |
| Unlock chest | Sneak + Right-Click with your key | 🔓 Unlocks |
| Use other’s key | Different UUID or password | ❌ Rejected |
| Break locked chest | Any player | ❌ Blocked |
📸 Screenshots & Demo
🖼️ Set password screen, owner tooltip, and key lock animation coming soon!
🔗 Links
- 🧰 Source: GitHub – PPekKunGz/ChestLocker
- 🌍 Developed by PPekKunGz
- 💬 Compatible: Minecraft 1.20.1+ (Fabric)
- 🪶 License: MIT
✨ Tagline
ChestLocker – Your chest, your rules.
Protect, share, and unlock safely with your personalized key. 🗝️
How to Install ChestLocker (Mod)
ChestLocker by PPekKunGz is verified for Fabric across Minecraft versions 1.18.2, 1.20.1 (latest release: 2.0.0, file size: 45 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.18.2, 1.20.1) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded ChestLocker file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version[Change log](https://github.com/PPekKunGz/ChestLocker/commit/682d6871ecc2c6600442a254545aee70e61d42b8)
### 🔐 New Features
- ✅ Added **Key Ownership System** — each key stores
ownerandowner_uuid. - ✅ Added **Password Hashing** for stronger security (SHA-256).
- ❌ Added **Unlock Mechanic** — *Sneak + Right-Click* with the correct key to unlock your chest.
- ✅ Added **Whitelist Commands:**
/chestaccess add <player>/chestaccess remove <player>/chestaccess list- ✅ Added **HUD Display** — shows “Locked by: <player>” when looking at a locked chest.
- ✅ Added **Password Reveal System** — hold **SHIFT** to show the real password on the key tooltip.
- ✅ Added **Break Protection** — locked chests can’t be destroyed until unlocked.
- ✅ Added **Multiplayer Safety** — all logic now runs server-side; no client spoofing possible.
### 🛠️ Improvements
- 💾 Key NBT now includes:
passwordownerowner_uuid- 💬 Improved feedback messages with colors and emojis for clarity.
- 🧠 Improved tooltip system (
KeyTooltipHandler) with obfuscated password and shift reveal. - 📦 Reworked lock data structure for better compatibility with server saving (
config/chestlocker.json). - ⚙️ Cleaner, more modular code structure:
/client→ Client UI & tooltips/screen→ GUI classes/mixin→ Game behavior hooks/manager→ Lock data management
### 🧱 Bug Fixes
- 🩹 Fixed issue where unlocked chests couldn’t be opened by non-owners.
- 🩹 Fixed tooltip not updating owner name after password setup.
- 🩹 Fixed improper password check causing all chests to be “locked.”
- 🩹 Fixed incorrect lock data persistence on reload.
### ⚡ Coming Next
- ⏳ Key sharing system (duplicate keys with limited access).
- 🧩 Optional password GUI for unlocking (instead of instant key unlock).
- 🧱 Auto-lock restoration after reopening chest.
- 🖼️ Custom key textures & glow effects.
### 🧰 Summary
> ChestLocker 2.0 turns your chests into real, password-secured storage.
> Every lock is owner-verified, UUID-protected, and fully multiplayer safe. 🔒
[Changelog](https://github.com/PPekKunGz/ChestLocker/commit/4ca0a61c115dd8ac549b12e17b10841d20e62933)
#Feature
- can setpassword with tripwire_hook and better gui