Locktight - Advanced Chest Protection & Security System
-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.

THIS PLUGIN IS STILL IN DEVELOPMENT, IT IS AVAILABLE CURRENTLY IN ALPHA VERSION TO HELP DEVELOPMENT THROUGH COMMUNITY FEEDBACK. IF YOU RUN INTO ISSUES, BE SURE YOU ARE RUNNING THE LATEST BUILD FIRST, THEN REPORT THE ISSUE IN #PLUGIN-HELP IN THE DISCORD.

**See To-Do list for changes made**

## Overview

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.

## How to Use
- Simply look at the chest you wish to lock and execute /chest lock
- Purchase lockpicks & lock reinforcements by executing /chest shop

## Key Features

### ️ Enhanced Claim Security
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.

### Intelligent Chest Locking
- Owner-Only Access: Locked chests are completely secure from unauthorized access
- Indestructible Protection: Locked chests cannot be broken by hand or destroyed by explosions
- Claim Integration: Respects existing claim boundaries and trust levels
- Configurable Permissions: Server owners can define which trust levels (CONTAINER, BUILDER, MANAGER) can lock chests within claims

### Advanced Trust Management
The plugin's sophisticated trust system allows claim owners to maintain full control over their locked chests while enabling trusted players to create their own secure storage within the claim. This creates a balanced ecosystem where security and collaboration coexist.

### Engaging Lockpicking System
Perfect for raid-style servers, Locktight features a configurable lockpicking mechanic that adds excitement and strategy to chest security:

- Multiple Tiers: Weak, Medium, Advanced, Professional, and Mythical lockpicks
- Configurable Success Rates: Server owners can balance gameplay and security
- In-Game Shop: Players can purchase lockpicks using Vault economy integration
- Reinforcement System: Chest owners can reinforce locks to reduce lockpicking success rates

### ⚙️ Flexible Configuration
Locktight adapts to various server environments:

- Claim-Based Servers: Enhanced security within existing land claim systems
- Claim-free Servers: Configurable wilderness locking and lockpicking mechanics
- Hybrid Servers: Balance between protection and raiding gameplay

## Server Types

### Claim-Based Protection Servers
For servers using GriefDefender, Locktight integrates seamlessly to provide an additional security layer that respects existing claim boundaries while adding chest-specific protection. The plugin automatically detects claim ownership, respects trust levels, and ensures that players with appropriate claim permissions (configurable) can lock chests within their trusted areas. This creates a harmonious relationship between land protection and chest security.

### ⚔️ Raid-Style Servers
Perfect for servers without land claiming systems, Locktight offers wilderness chest locking and an engaging lockpicking system that enhances raiding gameplay.

### Hybrid Servers
Servers can configure Locktight to balance protection and raiding elements, creating a dynamic environment where both security and adventure coexist. Say you have an admin claim that needs public chest access, but you want to keep certain items admin accessible only. Lock a chest, good to go.

## Technical Features

- SQLite Database: Reliable data storage for chest locks and trust relationships
- Vault Integration: Seamless economy integration for the lockpick shop
- GriefDefender API: Direct integration for optimal performance and compatibility
- Configurable Expiration: Automatic cleanup of abandoned chest locks
- Double Chest Support: Automatic handling of connected chest storage

## Benefits

- Enhanced Security: Additional protection layer beyond standard claim systems
- Balanced Gameplay: Security features that don't totally compromise server dynamics
- Player Engagement: Interactive lockpicking system adds excitement
- Server Flexibility: Adapts to various server types and playstyles
- Professional Quality: Robust, well-tested codebase with comprehensive features

## Permissions & Commands

### All Permission Nodes
• `locktight.use` - Basic chest operations + inspect own chests + delete own chests (Default: true, All players)
• `locktight.shop` - Access the lockpick shop (Default: true, All players)
• `locktight.lockpick` - Use lockpicks on chests (Default: op, Admins only)
• `locktight.lockpickget` - Get lockpick items via command (Default: op, Admins only)
• `locktight.lockpickget.other` - Give lockpick or reinforce item to a player
• `locktight.reload` - Reload plugin configuration (Default: op, Admins only)
• `locktight.cleanup` - Manually trigger cleanup (Default: op, Admins only)
• `locktight.*` - Wildcard permission for all plugin features (Default: op, Admins only)
• `locktight.bypass` - Bypass all chest locks and restrictions + inspect any chest (Default: op, Admins only)

### All Commands
• `/chest lock` - Lock a chest (Permission: locktight.use)
• `/chest unlock` - Unlock your chest (Permission: locktight.use)
• `/chest trust <player>` - Trust a player (Permission: locktight.use)
• `/chest delete` - Delete chest data (Permission: locktight.use for own, locktight.bypass for any)
• `/chest inspect` - Inspect any chest (Permission: locktight.use for own, locktight.bypass for any)
• `/chest shop` - Open lockpick shop (Permission: locktight.shop)
• `/chest reload` - Reload config (Permission: locktight.reload)
• `/chest cleanup` - Clean expired locks (Permission: locktight.cleanup)
• `/chest lockpick` - Use lockpick on chest (Permission: locktight.lockpick)
• `/chest lockpickget <tier>` - Get lockpick items (Permission: locktight.lockpickget)
• `/chest lockpickget <player>` - Give lockpick or reinforce item to a player

### Permission Logic Notes
- Inspect Command: Players with `locktight.use` can inspect their own chests, players with `locktight.bypass` can inspect any chest
- Delete Command: Players with `locktight.use` can delete their own chests, players with `locktight.bypass` can delete any chest
- Bypass Permission: `locktight.bypass` overrides all restrictions and allows full access to any chest

## Support
If you need help or have suggestions, please open an issue on the GitHub repository or join the linked Discord and navigate to # plugin-help

---

### To-Do
[x] Add a toggle in the config to enable/disable lockpicking, reinforcing & chest shop, each having their own enable/disable (enabled: true/false)
[x] Add a world-blacklist feature, that prevents locking chests in listed worlds. Excluding admin locks, admin locks should be able to be places anywhere by op's or players w permission
[x] Add a toggle in the config for plugin sounds effects anvil & villager no sounds
[x] Make players with the locktight.bypass permission node's locks never expire (add it to the config enable: true/false)
[x] Add a lockpickget <name> option where you can give lockpicks to a player with tab completion. Make a new permission node for it and it only, locktight.lockpickget.other
[x] Add a quantity to lockpickget command, (/chest lockpickget 64)
[x] Add an alert sub command that uses the locktight.use permissio node, that when executed it toggles lockpick alerts for the executers owned locks, meaning they wont get alerted when a lockpick attempt or success is made
[x] Add the reinforcment item that is purchasable in the shop, to the lockpickget sub command, /chest lockpickget reinforcement
[ ] Make doors, buttons, pressureplates, trapdoors & gates lockable (config enable/disable)
[ ] Make ender chests lockable (config enable/disable)
[ ] Make barrels lockable (config enable/disable)
[ ] Make it an option for lockpicking a chest to bypass griefdefender claim "chest-access: false" flag. add to config enable: true/false
[?] Create trust groups, ie: Admin group, so you can trust anyone with locktight.admin permission node to access a lock via /chest trustgroup <group>

All suggestions welcome!