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:
Command Aliases:

• Portuguese: /terreno, /proteger, /confiar, /abandonar
• Spanish: /territorio, /proteger, /confiar, /abandonar

Permissions:

⚙️ 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:

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:

1. Get a golden shovel (or use /claimtool)
2. Right-click to set first corner
3. Right-click to set second corner
4. Shift + Right-click to confirm or Right-click to cancel
5. Visual particles show your claim boundaries

Managing Trust:

1. Stand in your claim
2. Use /trust <player> to open GUI
3. Select trust level (ACCESS or FULL)
4. Player can now interact based on trust level
5. Use /untrust <player> to remove

Changing Biome:

1. Stand in your claim
2. Use /setbiome list to see available biomes
3. Use /setbiome <biome> to change
4. Requires Vault economy (if enabled)
5. 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

1. Download JennyProtects.jar
2. Place in your server's plugins folder
3. (Optional) Install Vault for economy features
4. Start/restart your server
5. Configure settings in plugins/JennyProtects/config.yml
6. Set your preferred language in config.yml
7. 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.