# ChestLockLite<\/p>\n
A simple, powerful container locking plugin for Spigot\/Paper 1.21+ servers. Lock your chests, barrels, hoppers, and furnaces with owner protection, password protection, or trusted players system. **No MySQL required** – uses lightweight SQLite storage.<\/p>\n
—<\/p>\n
## Lock a Container<\/p>\n
<\/p>\n
Look at a chest, barrel, hopper, or furnace and run:<\/p>\n
“`bash
\n\/cl lock
\n“`<\/p>\n
Only you can open it now!<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Core Protection
\n– **Owner Locks** – Lock containers so only you can access them
\n– **Password Protection** – Share access with passwords (SHA-256 hashed)
\n– **Trusted Players** – Grant access to specific players without passwords
\n– **Container Protection** – Prevents breaking, explosions, fire, and pistons<\/p>\n
### Container Support
\n– **Chests** – All chest types (regular, trapped, copper, etc.)
\n– **Barrels** – Full locking support for barrels
\n– **Hoppers** – Lock hoppers and control item extraction (configurable)
\n– **Furnaces** – Lock furnaces, blast furnaces, and smokers (configurable)
\n– **Per-Container Hopper Control** – Toggle hopper access per container via GUI<\/p>\n
### User Interface
\n– **GUI Menu** – Easy-to-use visual interface (Shift + Right-click with empty hand)
\n– **Password Input GUI** – Interactive character selection
\n– **Tab Completion** – Full autocomplete support for all commands
\n– **Container-Specific Messages** – Messages show the correct container type<\/p>\n
### Advanced Features
\n– **Double Chest Support** – Automatically handles single and double chests
\n– **Auto-Lock on Place** – Optional automatic locking when placing containers
\n– **Password Cooldown** – Prevents spam attempts (configurable)
\n– **Admin Tools** – Clear locks, reload config, bypass permissions
\n– **Admin Notifications** – Admins see notifications when opening locked containers
\n– **SQLite Storage** – Fast, lightweight, no external database needed
\n– **Auto-Backup** – Automatic database backups
\n– **Automatic Migration** – Seamless database upgrades<\/p>\n
—<\/p>\n
## Quick Setup<\/p>\n
1. Download the `ChestLockLite.jar` file
\n2. Place it in your server’s `plugins` folder
\n3. Start your server
\n4. Configure as needed in `plugins\/ChestLockLite\/config.yml` (optional)<\/p>\n
That’s it! The plugin is ready to use.<\/p>\n
—<\/p>\n
## Usage Examples<\/p>\n
### Password Protection<\/p>\n
<\/p>\n
Set a password so anyone with the password can unlock the container:<\/p>\n
“`bash
\n\/cl password mypassword123
\n“`<\/p>\n
Or use the **GUI** (Shift + Right-click \u2192 “Set Password”) for an interactive password input!<\/p>\n
—<\/p>\n
### Trust a Player<\/p>\n
<\/p>\n
Grant a player access without sharing passwords:<\/p>\n
“`bash
\n\/cl trust FriendName
\n“`<\/p>\n
The trusted player will receive a notification and can now access your container!<\/p>\n
—<\/p>\n
### Using the GUI<\/p>\n
**Shift + Right-click** any container to open the menu (Must have empty hand)<\/p>\n
Click buttons to:
\n– Lock\/unlock containers
\n– Set or remove passwords
\n– Manage trusted players
\n– Toggle hopper access (per container)
\n– View lock information<\/p>\n
No commands to remember!<\/p>\n
—<\/p>\n
## Common Commands<\/p>\n
| Command | Description | **Aliases:** `\/chestlock`, `\/lockchest`<\/p>\n —<\/p>\n ## Security Features<\/p>\n – **SHA-256 Password Hashing** – Passwords are never stored in plain text —<\/p>\n ## Configuration<\/p>\n New in v1.1.0:<\/p>\n “`yaml # Support for furnaces (allow locking furnaces, blast furnaces, smokers) # Show notification to admins when they open locked containers —<\/p>\n ## Perfect For<\/p>\n – **Survival Servers** – Protect player containers from griefing —<\/p>\n ## Documentation<\/p>\n – **Full Documentation**: GitHub Wiki —<\/p>\n ## Admin Commands<\/p>\n Admins have access to powerful management tools:<\/p>\n | Command | Description | Permission | —<\/p>\n ## Performance<\/p>\n – **Lightweight** – Minimal server impact —<\/p>\n ## What’s New in v1.1.0<\/p>\n – \ud83c\udf89 **Barrel, Hopper & Furnace Support** – Lock all container types! —<\/p>\n ## License<\/p>\n This project is licensed under the **MIT License**.<\/p>\n —<\/p>\n ## Links<\/p>\n – **Download**: GitHub Releases —<\/p>\n **Made with \u2764\ufe0f for the Minecraft community**<\/p>\n *Perfect for survival, SMP, and economy servers. Simple configuration, comprehensive permissions system, and full documentation included.*<\/p>\n","protected":false},"excerpt":{"rendered":" Lock your chests with owner-only protection, password protection, or trusted players system.<\/p>\n","protected":false},"featured_media":39387,"template":"","meta":{"_minecraft_slug":"chestlocklite","_minecraft_project_id":"sbvzpNqR","_minecraft_author":"eldor","_minecraft_license":"MIT","_minecraft_downloads":1284,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chestlocklite.zip","_minecraft_size_bytes":53531948,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T07:44:12.458181Z","_minecraft_date_created":"2025-11-04T09:30:05.386455Z","_minecraft_date_modified":"2025-12-21T01:41:02.454258Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chestlocklite","_minecraft_icon_attachment_id":39387,"_minecraft_imported_at":"2026-06-01T20:46:04+00:00","_minecraft_import_hash":"5f6531015254b0216ae5557a3e0c56ea","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,91,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-39386","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/cl lock` | Lock the container you’re looking at |
\n| `\/cl unlock` | Unlock your container |
\n| `\/cl password
\n| `\/cl trust
\n| `\/cl untrust
\n| `\/cl trustedlist` | List trusted players |
\n| `\/cl gui` | Open GUI menu |
\n| `\/cl info` | View lock information |<\/p>\n
\n– **Unique Salt Per Password** – Prevents rainbow table attacks
\n– **Container Break Protection** – Prevents unauthorized breaking
\n– **Explosion Protection** – Protects from creepers, TNT, etc.
\n– **Fire\/Lava Protection** – Protects from fire and lava damage
\n– **Piston Protection** – Prevents pistons from moving locked containers
\n– **Hopper Control** – Prevent hoppers from extracting items from locked containers<\/p>\n
\nlocks:
\n # Support for hoppers (allow locking hoppers)
\n allow-hoppers: true<\/p>\n
\n allow-furnaces: true<\/p>\n
\n admin-notification: true
\n“`<\/p>\n
\n– **SMP Servers** – Secure shared storage areas
\n– **Economy Servers** – Protect shop chests and storage
\n– **Towny\/Factions** – Team-based container protection
\n– **Any Server** – Simple, lightweight container protection<\/p>\n
\n– **Quick Start Guide**: Quick Start
\n– **Configuration**: Config Reference
\n– **Permissions**: Permissions Guide<\/p>\n
\n|———|————-|————|
\n| `\/cl clear` | Clear lock on targeted container | `chestlocklite.admin.clear` |
\n| `\/cl clearall
\n| `\/cl cleararea [radius]` | Clear locks in area | `chestlocklite.admin.cleararea` |
\n| `\/cl reload` | Reload configuration | `chestlocklite.admin.reload` |<\/p>\n
\n– **SQLite Storage** – Fast, no external database needed
\n– **Indexed Queries** – O(log n) lookup time
\n– **Tested** – Handles 10,000+ locks without issues
\n– **Comprehensive Testing** – 39 unit tests ensure reliability<\/p>\n
\n– \ud83c\udf9b\ufe0f **Per-Container Hopper Control** – Toggle hopper access via GUI
\n– \ud83d\udd14 **Admin Notifications** – Admins see notifications when opening locked containers
\n– \ud83d\udcac **Container-Specific Messages** – Messages show correct container type
\n– \ud83d\udc1b **Bug Fixes** – Fixed password GUI bug and GUI access with items
\n– \ud83e\uddea **Test Suite** – Comprehensive testing infrastructure (39 tests)<\/p>\n
\n– **Report Issues**: GitHub Issues
\n– **Wiki**: Documentation Wiki
\n– **Support**: Check the Troubleshooting Guide<\/p>\n