JennyProtects

# **JennyProtects** ### Advanced Land Protection System Protect your builds with golden shovel simplicity! ### **Overview** JennyProtects is a comprehensive land protection plugin that allows players to claim and protect their builds using an intuitive golden shovel tool. With multi-language support, Vault integration, and interactive GUIs, it provides a complete solution for server land management. ### **✨ Key Features** **️ Advanced Protection System** * Golden shovel-based claim creation (click corners) * Visual particle boundaries for easy identification * Protects against: block breaking/placing, container access, entity damage, PvP, explosions, crop trampling * Automatic claim validation (size limits, overlap detection) * Buffer zones between claims for player spacing **Trust Management System** * Three trust levels: NONE, ACCESS (containers), FULL (build rights) * Interactive GUI for managing trusted players * Trust level selection menu with visual feedback * Easy add/remove trusted players interface **Biome Customization** * Change biomes within your claims * 50+ supported biomes * Configurable costs (Vault economy integration) * Cooldown system to prevent abuse * Daily change limits **Database & Backup** * SQLite primary storage * Automatic JSON backups * Auto-migration system * Data integrity protection **Interactive GUIs** * Claim list viewer with teleportation * Trust management interface * Trust level selector * Biome selection menu **Multi-Language Support** * 6 fully translated languages: English, Portuguese (BR), Spanish, Italian, Russian, Chinese * 150+ translated messages per language * Automatic language detection * Command aliases in multiple languages ### **Commands & Permissions** **Main Commands:** ``` /claim - Create a new claim (golden shovel required) /trust - Open trust management GUI /untrust - Remove player trust /claimlist - View all your claims /abandonclaim - Delete current claim /claiminfo - View claim information /setbiome - Change claim biome /claimtool - Get golden shovel tool /claimgui - Open claims GUI /trustlist - List trusted players /jennyprotects - Main plugin command ``` **Command Aliases:** * Portuguese: /terreno, /proteger, /confiar, /abandonar * Spanish: /territorio, /proteger, /confiar, /abandonar **Permissions:** ``` jennyprotects.claim - Create claims jennyprotects.trust - Manage trust jennyprotects.abandon - Delete claims jennyprotects.info - View claim info jennyprotects.list - List claims jennyprotects.setbiome - Change biomes jennyprotects.admin - Admin commands jennyprotects.reload - Reload config jennyprotects.blocks.bonus. - Bonus claim blocks ``` ### **⚙️ Configuration** **Main Config Features:** * Claim size limits (min/max) * Maximum claims per player * Initial claim blocks * Claim blocks per hour (AFK detection) * Buffer distance between claims * Biome change costs and cooldowns * World blacklist/whitelist * Protection settings (PvP, explosions, etc.) * Database settings **Example Configuration:** ``` claims: min-size: 10 max-size: 500 max-claims-per-player: 5 initial-blocks: 500 blocks-per-hour: 100 buffer-distance: 10 biome: enabled: true cost: enabled: true amount: 1000.0 cooldown: 86400 protection: block-break: true block-place: true pvp: true explosions: true crop-trample: true ``` ### **Dependencies & Compatibility** **Required:** * Spigot/Paper 1.17.x - 1.21.x * Java 17+ **Optional (Soft Dependencies):** * Vault - Economy integration for biome costs * Essentials - Full compatibility ### **How to Use** **Creating a Claim:** * Get a golden shovel (or use /claimtool) * Right-click to set first corner * Right-click to set second corner * Shift + Right-click to confirm or Right-click to cancel * Visual particles show your claim boundaries **Managing Trust:** * Stand in your claim * Use /trust to open GUI * Select trust level (ACCESS or FULL) * Player can now interact based on trust level * Use /untrust to remove **Changing Biome:** * Stand in your claim * Use /setbiome list to see available biomes * Use /setbiome to change * Requires Vault economy (if enabled) * Respects cooldown settings ### **️ Technical Information** **Architecture:** * Modular design with 10 separate packages * 52+ optimized Java classes * Event-driven protection system * Efficient SQLite database with caching * Automatic backup system **Performance:** * Particle cooldown system (500ms) prevents spam * Efficient claim lookup algorithms * Minimal memory footprint * Async database operations * Optimized for large servers ### **Installation** * Download JennyProtects.jar * Place in your server's plugins folder * (Optional) Install Vault for economy features * Start/restart your server * Configure settings in plugins/JennyProtects/config.yml * Set your preferred language in config.yml * Reload with /jennyprotects reload ### **Support & Bug Reports** Found a bug or need help? Please report issues with: * Server version (Spigot/Paper) * Plugin version * Error messages from console * Steps to reproduce ### **License & Credits** JennyProtects is open-source software. Built with passion for the Minecraft community. ### ⭐ Enjoy protecting your builds! ⭐