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 <player> - Open trust management GUI
/untrust <player> - Remove player trust
/claimlist - View all your claims
/abandonclaim - Delete current claim
/claiminfo - View claim information
/setbiome <biome> - 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.<amount> - 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! ⭐