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.

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
• AS OF 1.0.6, CHESTS ARE AUTO LOCKED ON PLACEMENT (CONFIGURABLE)

⚙️ Configuration

Main Configuration (config.yml)

# Locktight Configuration File

# General Settings
general:
  # Auto-lock chests when placed by players
  auto_lock_on_place: true
  
  # Check for updates on startup
  check_updates: true

  # Close shop GUI after making a purchase
  close_gui_after_purchase: false
  
  # Chest lock expiration settings
  # How many days before a chest lock expires (default: 14 days)
  chest_lock_expiration_days: 14
  
  # How often to check for expired chest locks (in hours, default: 6 hours)
  # Note: This is a safety net - chest locks are automatically removed immediately when they expire
  # This periodic cleanup ensures database health and handles any edge cases
  chest_lock_cleanup_interval_hours: 6
  
  # Enable debug logging for troubleshooting
  debug_enabled: false

# Lockpicking System Settings
lockpicking:
  # Enable/disable lockpicking system
  enabled: true
  
  # Temporary access duration in seconds (from lockpicking)
  temporary_access_seconds: 60
  
  # Success rates for different lockpick tiers (as decimal values)
  # 0.005 = 0.5%, 0.05 = 5%, 0.1 = 10%, etc.
  success_rates:
    weak: 0.005      # 0.5% success rate
    medium: 0.05     # 5% success rate
    advanced: 0.1    # 10% success rate
    professional: 0.3 # 30% success rate
    mythical: 1.0    # 100% success rate
  
  # Alert system settings
  alerts:
    # Enable/disable lockpick alert system
    enabled: true
    # Default alert state for new players (true = alerts enabled, false = alerts disabled)
    default_enabled: true

# Lock Reinforcement System Settings
reinforcement:
  # Enable/disable lock reinforcement system
  enabled: true
  
  # Percentage increase in lockpicking resistance (as decimal value)
  # 0.05 = 5% increase in resistance (5% decrease in lockpick success rate)
  resistance_increase: 0.05
  
  # Maximum number of reinforcements that can be applied to a single chest
  # Each reinforcement increases resistance by resistance_increase
  # Example: 3 reinforcements with 0.05 resistance = 15% total resistance
  max_reinforcements: 8
  
  # Number of lockpicking attempts before reinforcements degrade
  # After this many attempts, reinforcements are reduced by 1
  # Set to 0 to disable automatic degradation
  attempts_per_degradation: 5

# World Blacklist Settings
world_blacklist:
  # Enable/disable world blacklist feature
  enabled: false
  
  # List of worlds where chest locking is prohibited
  # Admin locks can still be placed in blacklisted worlds
  # Add world names here to blacklist them
  blacklisted_worlds: []

# Sound Effects Settings
sound_effects:
  # Enable/disable anvil sound effects (reinforcement)
  anvil_sounds:
    enabled: true
  
  # Enable/disable villager no sound effects (lockpicking)
  villager_no_sounds:
    enabled: true

# Bypass Permission Settings
bypass_permission:
  # Make players with locktight.bypass permission have locks that never expire
  locks_never_expire:
    enabled: true

# GriefDefender Integration Settings
griefdefender:
  # Allow claim owners to unlock/access any locked chest inside their claim
  # This gives claim owners full control over chests in their territory
  allow_claim_owner_unlock_all: true
  
  # Trust types that can lock chests in claims
  # BUILDER - Can build and lock chests
  # CONTAINER - Can access containers and lock chests  
  # MANAGER - Administrative control, can lock chests
  allowed_trust_types:
    - "BUILDER"
    - "CONTAINER" 
    - "MANAGER"
  
  # Wilderness and public area handling
  # Allow chest locking in wilderness areas (unclaimed land)
  allow_wilderness_locking: true

# Economy Settings. Requires Vault
economy:
  # Currency symbol for messages
  currency_symbol: "$"

Messages (messages.yml)

Customize all plugin messages, colors, and formatting.

GUI Configuration (gui.yml)

Configure shop appearance, colors, and item layouts.

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
• Raid 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

Permission	Description	Default	Access
locktight.use	Basic chest operations + inspect own chests + delete own chests	true	All players
locktight.shop	Access the lockpick shop	true	All players
locktight.lockpick	Use lockpicks on chests	op	Admins only
locktight.lockpickget	Get lockpick items via command	op	Admins only
locktight.reload	Reload plugin configuration	op	Admins only
locktight.cleanup	Manually trigger cleanup	op	Admins only
locktight.*	Wildcard permission for all plugin features	op	Admins only
locktight.bypass	Bypass all chest locks and restrictions + inspect any chest	op	Admins only

All Commands

Command	Description	Permission
/chest lock	Lock a chest	locktight.use
/chest unlock	Unlock your chest	locktight.use
/chest trust <player>	Trust a player on chest	locktight.use
/chest delete	Delete chest data	locktight.use (own) or locktight.bypass (any)
/chest inspect	Inspect any chest	locktight.use (own) or locktight.bypass (any)
/chest shop	Open lockpick shop	locktight.shop
/chest reload	Reload configuration	locktight.reload
/chest cleanup	Clean expired locks	locktight.cleanup
/chest lockpick	Use lockpick on chest	locktight.lockpick
/chest lockpickget <tier>	Get lockpick items	locktight.lockpickget

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

---

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!