JennyProtects

# JennyProtects v1.0.3 - Release Notes

**Release Date**: October 18, 2025  
**Compatibility**: Minecraft 1.17.x - 1.21.x (Spigot/Paper)  
**Java Version**: 17+

---

## 🎉 What's New in v1.0.3

### 🐛 Bug Fixes
- **Fixed particle spam crash**: Added 500ms cooldown system to prevent excessive particle rendering when holding left-click
- **Fixed missing trust GUI**: `/trust` command now properly opens the trust level selection GUI instead of directly adding trust
- **Fixed crop trampling**: Added protection against players and mobs destroying farmland by jumping on it

### ✨ Improvements
- **Enhanced trust system**: Interactive GUI with three trust levels (NONE, ACCESS, FULL)
- **Better user feedback**: Updated confirmation messages for claim creation (Shift + Right-click to confirm)
- **Optimized visualization**: Per-player cooldown system prevents global performance impact
- **Universal crop protection**: EntityChangeBlockEvent handler protects against all farmland damage

### 🌐 Language Updates
- **Completed all 6 language files**: Spanish, Italian, Russian, and Chinese now have 150+ fully translated messages
- **New translation keys**: Added `crop-trample`, updated action bar messages, and GUI texts
- **Consistent translations**: All languages now have identical feature parity

---

## 📋 Current Features

### 🛡️ Protection System
- **Golden Shovel Claims**: Click corners to define claim area
- **8 Protection Types**:
  - Block breaking/placing
  - Container access (chests, furnaces, etc.)
  - Entity damage
  - PvP combat
  - Explosion damage
  - Crop trampling (NEW in v1.0.3)
- **Visual Boundaries**: Particle effects with smart cooldown
- **Smart Validation**: Overlap detection, size limits, buffer zones

### 👥 Trust Management
- **Three Trust Levels**:
  - NONE: No access
  - ACCESS: Container and interaction permissions
  - FULL: Build rights + container access
- **Interactive GUIs**:
  - Trust Level Selector (NEW in v1.0.3)
  - Trust Management Interface
  - Player list with remove options
- **Commands**: `/trust`, `/untrust`, `/trustlist`

### 🌍 Biome Customization
- **50+ Biomes**: Change your claim's environment
- **Vault Integration**: Configurable costs for biome changes
- **Cooldown System**: Prevent abuse with time limits
- **Daily Limits**: Control frequency of changes
- **Commands**: `/setbiome <biome>`, `/setbiome list`

### 🎨 Interactive GUIs
1. **Claim List GUI**: Browse and teleport to your claims
2. **Trust Management GUI**: Add/remove trusted players
3. **Trust Level GUI**: Select trust level for players (NEW in v1.0.3)
4. **Biome Selector**: Visual biome selection

### 🌐 Multi-Language Support
- **6 Complete Languages**:
  - 🇺🇸 English
  - 🇧🇷 Portuguese (Brazil)
  - 🇪🇸 Spanish
  - 🇮🇹 Italian
  - 🇷🇺 Russian
  - 🇨🇳 Chinese
- **150+ Messages**: Every message fully translated
- **Command Aliases**: Native language support (`/terreno`, `/territorio`, etc.)

### 💾 Database & Backup
- **SQLite**: Primary storage system
- **JSON Backups**: Automatic redundant backups
- **Auto-Migration**: Seamless version updates
- **Data Integrity**: Protected against corruption

### 🔧 Configuration
- **Flexible Settings**: Min/max claim sizes, player limits, block allocations
- **World Management**: Blacklist/whitelist specific worlds
- **Protection Toggles**: Enable/disable individual protection types
- **Economy Settings**: Vault integration with customizable costs
- **Performance Options**: Visualization cooldowns, database intervals

---

## 📝 Available Commands

| Command | Description |
|---------|-------------|
| `/claim` | Create a new claim with golden shovel |
| `/trust <player>` | Open trust level selection GUI |
| `/untrust <player>` | Remove player from trust list |
| `/claimlist` | View all your claims in GUI |
| `/abandonclaim` | Delete the claim you're standing in |
| `/claiminfo` | View detailed claim information |
| `/setbiome <biome>` | Change your claim's biome |
| `/claimtool` | Receive a golden shovel tool |
| `/claimgui` | Open claims management GUI |
| `/trustlist` | List all trusted players |
| `/jennyprotects` | Main plugin command |
| `/jennyprotects reload` | Reload configuration |

---

## 🔐 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `jennyprotects.claim` | Create and manage claims | true |
| `jennyprotects.trust` | Manage trusted players | true |
| `jennyprotects.abandon` | Delete claims | true |
| `jennyprotects.info` | View claim information | true |
| `jennyprotects.list` | List claims | true |
| `jennyprotects.setbiome` | Change biomes | true |
| `jennyprotects.admin` | Administrative commands | op |
| `jennyprotects.reload` | Reload configuration | op |
| `jennyprotects.blocks.bonus.<amount>` | Bonus claim blocks | false |

---

## 🔌 Dependencies

### Required
- **Spigot or Paper**: Version 1.17.x through 1.21.x
- **Java**: Version 17 or higher

### Optional (Soft Dependencies)
- **Vault**: For economy features (biome costs)
- **Essentials**: Full compatibility

---

## 📦 Installation

1. Download `JennyProtects-1.0.3.jar`
2. Place in your server's `plugins` folder
3. (Optional) Install Vault plugin for economy features
4. Start or restart your server
5. Configure `plugins/JennyProtects/config.yml` as needed
6. Use `/jennyprotects reload` to apply changes

---

## ⚙️ Configuration Highlights

```yaml
claims:
  min-size: 10                  # Minimum claim size
  max-size: 500                 # Maximum claim size
  max-claims-per-player: 5      # Max claims per player
  initial-blocks: 500           # Starting claim blocks
  blocks-per-hour: 100          # Blocks earned hourly
  buffer-distance: 10           # Space between claims

biome:
  enabled: true                 # Enable biome changes
  cost:
    enabled: true               # Require payment (Vault)
    amount: 1000.0              # Cost per change
  cooldown: 86400               # Cooldown in seconds

protection:
  block-break: true             # Protect from breaking
  block-place: true             # Protect from placing
  pvp: true                     # Disable PvP in claims
  explosions: true              # Prevent explosions
  crop-trample: true            # Protect farmland (NEW)

language: en                    # Language: en, pt_br, es, it, ru, zh

🛠️ Technical Details

Architecture

• 52+ Java classes organized in 10 modular packages
• Event-driven protection system
• Efficient claim lookup algorithms
• Async database operations for performance
• Particle cooldown system (500ms per player)

Database

• SQLite for primary storage
• JSON backups every hour (configurable)
• Auto-migration for version updates
• Data validation on startup

Performance

• Per-player visualization cooldown prevents server lag
• Optimized claim queries with spatial indexing
• Minimal memory footprint
• Scalable for large servers

🐛 Known Issues

None reported for v1.0.3. If you encounter any bugs, please report them with:

• Server version (Spigot/Paper)
• Plugin version
• Console errors
• Steps to reproduce

🔄 Upgrade from v1.0.2

1. Backup your data: plugins/JennyProtects/database.db and configs
2. Stop your server
3. Replace the old JAR with JennyProtects-1.0.3.jar
4. Start your server
5. Database auto-migrates - no manual action needed
6. New language keys automatically added

No data loss - all claims, trusts, and settings preserved!

🚀 What's Next?

Planned for v1.1.0

• SubZone system for claim subdivision
• Advanced permission flags per claim
• Public API for third-party integrations
• WorldGuard region compatibility
• MySQL/PostgreSQL database support

📊 Version History

• v1.0.3 (October 18, 2025) - Bug fixes, GUI improvements, complete translations
• v1.0.2 (October 17, 2025) - Visual improvements, Portuguese localization
• v1.0.1 (October 16, 2025) - Initial bug fixes
• v1.0.0 (October 15, 2025) - Initial release

💬 Support & Community

• Issues: Report bugs and request features on GitHub
• Documentation: Full documentation in INFOS/README.md
• Spigot: BBCode presentation in INFOS/SPIGOT_PRESENTATION.bbcode

📄 License

JennyProtects is released under the MIT License.
Open-source and free to use.

Thank you for using JennyProtects!
Protect your builds with confidence 🛡️