# Locktight – Advanced Chest Protection & Security System<\/p>\n
**Locktight** transforms chest security from a simple protection mechanism into an engaging, strategic gameplay element that enhances both security-focused and raid-style server experiences.<\/p>\n
**Folia:** Support for **Folia** is still **developmental**\u2014it may have rough edges or issues not seen on single-region **Paper**. Use Paper when you can; try Folia when you need regionized scheduling and report problems so they can be fixed.<\/p>\n
**_IF YOU RUN INTO ISSUES, BE SURE YOU ARE RUNNING THE LATEST BUILD FIRST, THEN REPORT THE ISSUE IN #PLUGIN-HELP IN THE DISCORD._**<\/p>\n
**_NOTE: IF EXPERIENCING PERFORMANCE ISSUES BECAUSE OF LOCKTIGHT, USE LATEST RELEASE. VERSIONS ALPHA 1.0.4 – 1.0.9 HAD KNOWN PERFORMANCE ISSUES DUE TO HOPPER HEAVY TASKS._** _Be wary of hopper heavy bases, due to the logic that prevents hoppers stealing from locked chests. Tests show new logic as of A1.1.0 to be 94% more efficient in terms of server thread usage. Please report any issues in the provided Discord channel for support._<\/p>\n
**Platform:** Locktight is built for **Paper** (and **Folia**) using the Paper API. **Plain Spigot is not supported.** Use a current Paper (or Folia) build for your Minecraft version.<\/p>\n
## Overview<\/p>\n
Locktight is a comprehensive chest protection plugin designed to provide an additional layer of security for chests within land claims while maintaining flexibility for various server types. Perfect for both claim-based and raid-style servers, Locktight offers sophisticated chest locking mechanisms, configurable trust systems, and an engaging lockpicking gameplay element.<\/p>\n
## How to Use<\/p>\n
– Simply look at the chest you wish to lock and execute `\/chest lock`
\n– Purchase lockpicks, lock reinforcements, and a **lock tool** from **`\/chest shop`**: **right-click** to lock or unlock (same rules as **`\/chest lock`** \/ **`\/chest unlock`**), **left-click** to inspect (same rules as **`\/chest inspect`**)
\n– **_AS OF 1.0.6, CHESTS CAN BE AUTO LOCKED ON PLACEMENT (CONFIGURABLE) \u2014 DEFAULT VALUE CHANGED TO FALSE IN 1.1.4_**
\n– **Lock any lockable container**: chests, double chests, **barrels**, **all shulker box colors**, and **copper chests** (1.21). Lock, unlock, delete, and trust work from **either side** of a double chest.<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Main Configuration (`config.yml`)<\/p>\n
The file shipped with the plugin is authoritative. Below is the current layout (values match the default `config.yml` in the JAR; yours may differ after edits).<\/p>\n
“`yaml
\n# Full banner header is in the JAR\u2019s config.yml \u2014 Paper & Folia, by MightyFinger77
\n# config_version \u2014 used for migrations. Do not change unless you know the drill.
\nconfig_version: 5<\/p>\n
# General Settings
\ngeneral:
\n auto_lock_on_place: false # EXPERIMENTAL \u2014 enable at your own risk
\n check_updates: true
\n close_gui_after_purchase: false
\n chest_lock_expiration_days: 28
\n chest_lock_cleanup_interval_hours: 6
\n debug_enabled: false
\n hopper_debug: false<\/p>\n
lockpicking:
\n enabled: true
\n temporary_access_seconds: 30
\n success_rates:
\n weak: 0.005
\n medium: 0.05
\n advanced: 0.1
\n professional: 0.3
\n mythical: 1.0
\n alerts:
\n enabled: true
\n default_enabled: true
\n allow_lockpicking_offline_players: true<\/p>\n
# lock_tool.enabled \u2014 right-click toggle lock; left-click inspect (see config.yml in JAR)<\/p>\n
lock_tool:
\n enabled: true<\/p>\n
reinforcement:
\n enabled: true
\n resistance_increase: 0.05
\n max_reinforcements: 8
\n attempts_per_degradation: 5<\/p>\n
# griefdefender.block_lockpick_in_trusted_foreign_claim \u2014 optional: block lockpicking
\n# for trusted non\u2013claim-owners in that claim (default false). See full config.yml.
\n# … world_blacklist, sound_effects, bypass_permission, griefdefender,
\n# economy, performance \u2014 see full config.yml in plugins\/Locktight\/
\n“`<\/p>\n
### Messages (`messages.yml`)<\/p>\n
Customize all plugin messages, colors, and formatting.<\/p>\n
### GUI Configuration (`gui.yml`)<\/p>\n
Configure shop slot layout, **`shop_rows`** (1\u20136 rows of 9 slots, default **5**), display names, lore (including `{weak_rate}` placeholders), prices, optional integer **custom model data**, and the `item:` subsection used for purchased stack **name\/lore\/rates**.<\/p>\n
For **full custom items** (resource packs, ItemsAdder\/Nexo-style components, non-default materials), admins use **`\/chest itemset`**; visuals come from the held item, while **name and lore still follow `gui.yml`**. Templates are stored in **`plugins\/Locktight\/item_templates.yml`** with a file header field **`templates_version`** (separate from Paper\u2019s per-item `schema_version` inside serialized stacks).<\/p>\n
## Key Features<\/p>\n
### \ud83d\udee1\ufe0f Enhanced Claim Security<\/p>\n
Locktight integrates seamlessly with GriefDefender to provide a second layer of protection beyond standard claim trusts. Players with claim access cannot automatically open locked chests unless explicitly trusted through the `\/chest trust` command. This ensures that even trusted players must be specifically authorized for individual chest access. Optionally, **`griefdefender.block_lockpick_in_trusted_foreign_claim`** (default **false**) prevents **lockpicking** inside a claim by players who have GriefDefender trust there but are **not** the claim owner\u2014useful so co-trusted players in one base cannot pick each other\u2019s locks; **claim group** trust is included. Claim owners are not restricted by this setting.<\/p>\n
### \ud83d\udd10 Intelligent Chest Locking<\/p>\n
– **Multiple container types**: Lock **chests** (single and double), **barrels**, **shulker boxes** (all colors), and **copper chests** (1.21). All copper chest variants are supported; locks are stored by block location so they **persist when copper chests oxidize or change state**. Double chests are treated as one lock; lock, unlock, delete, and trust work from either side.
\n– **Owner-only access**: Locked chests are secure from unauthorized access
\n– **Indestructible protection**: Locked chests cannot be broken by hand or destroyed by explosions (per plugin rules)
\n– **Admin locks** (`\/chest adminlock`): Unpickable, never expire; only players with `locktight.adminlock` can open or break them.
\n– **Owner locks** (`\/chest olock`): Only the owner or players trusted on that chest can access. Bypass and adminlock do **not** grant access. Unpickable, never expire. Trust must be set per chest (bulk trust skips owner locks).
\n– **Claim integration**: Respects claim boundaries and trust levels
\n– **Configurable permissions**: Server owners can define which trust levels (CONTAINER, BUILDER, MANAGER) can lock chests within claims<\/p>\n
### \ud83c\udfaf Advanced Trust Management<\/p>\n
Per-chest trust (`\/chest trust` \/ `untrust`), bulk trust (`\/chest trustall` \/ `untrustall` with optional radius), **group trust** with LuckPerms (`\/chest trustgroup` \/ `trustgroupall` and untrust variants), and **clear trusts** (`cleartrusts`, `cleartrustsgroups`, `cleartrustsboth`). Owner locks are excluded from bulk\/radius trust and must be trusted individually.<\/p>\n
### \ud83c\udfae Engaging Lockpicking System<\/p>\n
– **Multiple tiers**: Weak, Medium, Advanced, Professional, and Mythical lockpicks ### \u2699\ufe0f Flexible Configuration<\/p>\n – **Claim-based servers**: Extra security inside GriefDefender claims ## Server Types<\/p>\n ### \ud83c\udff0 Claim-Based Protection Servers<\/p>\n GriefDefender integration respects claim ownership and configurable trust levels so the right players can lock chests in their areas.<\/p>\n ### \u2694\ufe0f Raid-Style Servers<\/p>\n Wilderness locking and lockpicking support raiding-oriented gameplay.<\/p>\n ### \ud83d\udd04 Hybrid Servers<\/p>\n Configure wilderness locking, claims, and shop\/economy to match your mix of security and risk.<\/p>\n ## Technical Features<\/p>\n – **SQLite** (bundled driver): Chest locks, trust, reinforcements, and related data ## Benefits<\/p>\n – **Enhanced security** beyond claim trusts alone ## \ud83d\udd11 Permissions & Commands<\/p>\n ### All permission nodes<\/p>\n | Permission | Description | Default | ### All commands<\/p>\n | Command | Description | Permission | ### Permission logic notes<\/p>\n – **Inspect**: `locktight.use` for own chests; `locktight.bypass` for any (inspection rules as implemented). —<\/p>\n ## \ud83d\udccb TODO \/ future improvements<\/p>\n ### Planned features<\/p>\n – **Fully modular tiers**: Allow adding arbitrary new lockpick tiers purely from config without code changes (today, tiers are wired to specific shop keys and config paths; **`\/chest itemset`** already covers **custom visuals** and **PDC-based detection** for the existing tiers). ### Implemented (no longer TODO)<\/p>\n – **Lockable barrels** All suggestions welcome!<\/p>\n","protected":false},"excerpt":{"rendered":" A Minecraft plugin that provides comprehensive chest locking, protection, and management features with GriefDefender & Vault integration.<\/p>\n","protected":false},"featured_media":95098,"template":"","meta":{"_minecraft_slug":"locktight","_minecraft_project_id":"qdy2liUd","_minecraft_author":"MightyFinger77","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":695,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"locktight.zip","_minecraft_size_bytes":403228303,"_minecraft_version_count":30,"_minecraft_updated_at":"2026-05-16T09:39:54.086735Z","_minecraft_date_created":"2025-08-15T05:04:13.506524Z","_minecraft_date_modified":"2026-05-01T00:39:07.521009Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/locktight","_minecraft_icon_attachment_id":95098,"_minecraft_imported_at":"2026-06-05T10:41:24+00:00","_minecraft_import_hash":"fc1ad00c3a939ee9a5bae65433183cda","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,91,92],"mod_loader":[131,132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-95097","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-storage","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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– **Configurable success rates**: Balance gameplay and security in `config.yml`
\n– **Optional GriefDefender rule**: **`griefdefender.block_lockpick_in_trusted_foreign_claim`** \u2014 when enabled, trusted non\u2013owners cannot lockpick in that claim (see **GriefDefender** above).
\n– **In-game shop**: Purchase lockpicks with Vault
\n– **Reinforcement system**: Owners reinforce chests to reduce lockpick success rates
\n– **Custom item templates**: **`\/chest itemset`** (`locktight.itemset`) saves the item in your main hand as the template for a tier, reinforcement, or **locktool**. Shop icons and purchased items use that stack\u2019s **material\/model\/components**; **display name and lore** still come from **`gui.yml`**. Tags on the item ensure lockpick\/reinforcement\/lock-tool logic does not depend on display names. **`\/chest itemset clear
\n– **Raid servers**: Wilderness locking and lockpicking
\n– **Hybrid servers**: Mix protection and raiding<\/p>\n
\n– **Vault**: Economy for the shop
\n– **GriefDefender API**: Claim-aware locking (soft dependency)
\n– **LuckPerms** (optional): Group-based trust
\n– **Paper \/ Folia**: Supported; uses safe scheduling on Folia (`folia-supported: true` in plugin metadata)
\n– **Configurable expiration**: Automatic cleanup of abandoned locks (admin and owner locks never expire)
\n– **Lockable containers**: Chests (including double), barrels, all shulker colors, copper chest variants where the server version supports them<\/p>\n
\n– **Balanced gameplay** between defense and raiding
\n– **Player engagement** via lockpicking and reinforcements
\n– **Flexible deployment** across server styles
\n– **Custom shop visuals** without losing YAML-driven rates and lore<\/p>\n
\n|————|————-|———|
\n| `locktight.use` | Lock, unlock, trust, inspect own chests, delete own chests | `true` |
\n| `locktight.shop` | Access the lockpick shop | `true` |
\n| `locktight.lockpick` | Use lockpicks on chests | `op` |
\n| `locktight.lockpickget` | Get lockpick items via command | `op` |
\n| `locktight.lockpickget.other` | Give lockpick items to other players | `op` |
\n| `locktight.itemset` | Save custom lockpick\/reinforcement\/lock-tool templates (`\/chest itemset`) | `op` |
\n| `locktight.reload` | Reload plugin configuration | `op` |
\n| `locktight.cleanup` | Manually trigger chest lock expiration cleanup | `op` |
\n| `locktight.adminlock` | Create unpickable admin locks | `op` |
\n| `locktight.ownerlock` | Create owner locks (bypass\/adminlock do not apply) | `op` |
\n| `locktight.bypass` | Bypass chest locks (except owner locks) and inspect\/delete per rules | `op` |
\n| `locktight.update` | Manually check for plugin updates | `op` |
\n| `locktight.*` | Wildcard for all plugin features | `op` |<\/p>\n
\n|———|————-|————|
\n| `\/chest lock` | Lock the container you\u2019re looking at | `locktight.use` |
\n| `\/chest unlock` | Unlock your locked container | `locktight.use` |
\n| `\/chest trust
\n| `\/chest untrust
\n| `\/chest trustall
\n| `\/chest untrustall
\n| `\/chest trustgroup
\n| `\/chest trustgroupall
\n| `\/chest untrustgroup` \/ `untrustgroupall` | Remove group trust | `locktight.use` |
\n| `\/chest cleartrusts` \/ `cleartrustsgroups` \/ `cleartrustsboth` | Clear trusts on this chest | `locktight.use` |
\n| `\/chest delete` | Delete chest data (either side of double chest) | `locktight.use` \/ `locktight.bypass` (rules apply) |
\n| `\/chest inspect` | Inspect container | `locktight.use` \/ `locktight.bypass` |
\n| `\/chest shop` | Open lockpick shop | `locktight.shop` |
\n| `\/chest reload` | Reload configuration (including `item_templates.yml`) | `locktight.reload` |
\n| `\/chest cleanup` | Clean expired locks | `locktight.cleanup` |
\n| `\/chest lockpick [tier]` | Use lockpick on container | `locktight.lockpick` |
\n| `\/chest lockpickget [tier] [qty] [player]` | Get lockpick\/reinforcement items | `locktight.lockpickget` |
\n| `\/chest itemset
\n| `\/chest itemset clear
\n| `\/chest adminlock` | Set admin lock | `locktight.adminlock` |
\n| `\/chest olock` | Set owner lock | `locktight.ownerlock` |
\n| `\/chest autolock` | Toggle auto-lock on place | `locktight.use` |
\n| `\/chest alerts` | Toggle lockpick alerts | `locktight.use` |
\n| `\/chest help [subcommand]` | Help | \u2014 |
\n| `\/chest bypass` | Toggle bypass mode | `locktight.bypass` |
\n| `\/chest update` | Check for updates | `locktight.update` |<\/p>\n
\n– **Delete**: Own chests with `locktight.use`; bypass for non\u2013owner-lock chests per plugin rules. **Owner locks**: owner only for delete. **Admin locks**: `locktight.adminlock` (or `locktight.*`).
\n– **Open \/ break (normal locks)**: Owner\/trusted; `locktight.bypass` for non\u2013owner-lock containers.
\n– **Admin locks**: Unpickable; open\/break\/delete for `locktight.adminlock` \/ `locktight.*` as implemented.
\n– **Owner locks**: Only owner or chest-trusted players; **`locktight.bypass` and `locktight.adminlock` do not grant access.** Use `\/chest trust` on that chest; `trustall` \/ `trustgroupall` skip owner locks.<\/p>\n
\n– **Lockable doors** (doors, trapdoors, etc.)
\n– **Lockable redstone blocks** (buttons, levers, pressure plates)
\n– **Lockable ender chests**
\n– **More lockable variants** (e.g. boat\/chest minecart storage) where feasible<\/p>\n
\n– **Lockable shulker boxes** (all colors)
\n– **Lockable copper chests** (1.21) and persistence across oxidation\/wax
\n– **Double chest from either side** (lock, unlock, delete, trust, inspect)
\n– **Paper & Folia** support with region-safe scheduling
\n– **Custom shop item templates** (`\/chest itemset`, `item_templates.yml`, `locktight.itemset`)
\n– **Lock tool** (shop + `\/chest itemset locktool`): right-click lock\/unlock, left-click inspect
\n– **Configurable shop size** (`shop_rows` in `gui.yml`)
\n– **Optional trusted-claim lockpick block** (`griefdefender.block_lockpick_in_trusted_foreign_claim`)<\/p>\n