ProtectsAllam

# Protects Allam - Release Notes

## Version 1.0.0 - Initial Release

### Overview
Protects Allam is a professional area protection plugin for Minecraft servers, featuring dual protection methods, comprehensive configuration options, and multi-language support. Built for Minecraft 1.17.x to 1.21.x.

### Core Features

#### Dual Protection System
- **AxA Protection Method**: Create square protections using simple coordinates
  - Command: `/areaprotect <X> <Z> <name>`
  - Automatic full-height coverage (Y: -64 to 319)
  - Quick deployment for standard areas
  
- **Selection-Based Method**: Precise custom area definition
  - Commands: `/pset 1`, `/pset 2`, `/protect <name>`
  - Two-point selection system
  - Support for irregular shapes

- **Multi-World Support**: Independent protection systems per world
  - Automatic world detection
  - Separate JSON files per world
  - No cross-world conflicts

#### Protection System
- **Block Protection**
  - Prevent block breaking
  - Prevent block placement
  - Prevent interaction with containers and mechanisms
  - Configurable per area via JSON flags

- **Entity Protection**
  - Prevent player vs player damage
  - Prevent mob damage by players
  - Protect passive and hostile entities

- **Environmental Protection**
  - Prevent TNT explosions
  - Prevent creeper explosions
  - Prevent fire spread
  - Prevent block burning

- **Item Control**
  - Prevent item dropping from inventory
  - Prevent bucket usage (water/lava)
  - Configurable bypass permissions

#### Claim Prevention System
- **Item-Based Prevention**
  - Blocks golden shovels (GriefPrevention)
  - Blocks sticks (WorldGuard)
  - Blocks custom configured items
  - Real-time detection and cancellation

- **Command-Based Prevention**
  - Intercepts claim commands from popular plugins
  - Pattern matching system for flexibility
  - Custom command blocking list

- **Supported Plugins**
  - GriefPrevention
  - WorldGuard
  - Residence
  - Towny
  - Lands
  - PlotSquared
  - Factions
  - Custom plugins via configuration

#### Data Management
- **JSON Storage**
  - Human-readable format
  - Easy manual editing
  - Separate files per world
  - Structured data with validation

- **Automatic Backup System**
  - Configurable backup interval
  - Maximum backup file limit
  - Automatic old backup cleanup
  - Corruption recovery

- **Auto-Save System**
  - Configurable save interval (default: 5 minutes)
  - Saves on plugin disable
  - Saves on server shutdown
  - No data loss

#### Configuration System
- **Per-Area Flags** (7 independent flags)
  - `blockBreak`: Control block breaking
  - `blockPlace`: Control block placement
  - `blockInteract`: Control container/mechanism interaction
  - `blockDamageEntity`: Control PvP and mob damage
  - `blockBucketUse`: Control water/lava bucket usage
  - `blockClaimCreation`: Control claim creation from other plugins
  - `blockItemDrop`: Control item dropping from inventory

- **Global Settings**
  - Language configuration
  - Effect settings (sound/particles)
  - Message display options
  - Storage settings
  - Bypass settings
  - Debug mode

#### Multi-Language System
- **Included Languages**
  - English (en)
  - Portuguese Brazil (pt_br)
  - Spanish (es)
  - Italian (it)
  - Russian (ru)
  - Chinese Simplified (zh_cn)

- **Features**
  - Automatic language detection from client
  - Fallback to default language
  - Custom language support
  - Placeholder system for dynamic content
  - Easy translation process

#### User Feedback System
- **Actionbar Messages**
  - Non-intrusive notifications
  - Displayed above hotbar
  - Configurable enable/disable
  - Multi-language support

- **Sound Effects**
  - Configurable sound type
  - Volume and pitch control
  - Enable/disable option
  - Default: ENTITY_VILLAGER_NO

- **Particle Effects**
  - Visual feedback at action location
  - Configurable particle type
  - Particle count control
  - Enable/disable option
  - Default: SMOKE_NORMAL

- **Chat Messages**
  - Optional chat notifications
  - Configurable enable/disable
  - Recommended: disabled (less spam)

### Commands

#### Area Management
- `/areaprotect <X> <Z> <name>` - Create AxA protection
- `/pset 1` - Set first selection point
- `/pset 2` - Set second selection point
- `/protect <name>` - Create protection from selection
- `/unprotect <name>` - Remove protection

#### Information
- `/protectlist` - List all protected areas
- `/protectinfo <name>` - View detailed area information

#### Administration
- `/protectreload` - Reload configuration and language files

### Permissions

#### Admin Permissions
- `protects.admin` - Full access to all features

#### Management Permissions
- `protects.create` - Create protected areas
- `protects.remove` - Remove protected areas
- `protects.list` - List protected areas
- `protects.info` - View area information
- `protects.reload` - Reload configurations

#### Bypass Permissions
- `protects.bypass` - Bypass all protections
- `protects.bypass.item-drop` - Bypass item drop restriction only
- `protects.claim.bypass` - Bypass claim prevention system

### Technical Details

#### System Requirements
- Minecraft Server: 1.17.x to 1.21.x
- Server Software: Spigot, Paper, or compatible fork
- Java Version: 17 or higher
- Dependencies: None (standalone plugin)

#### Performance
- Optimized area lookup algorithm
- Minimal TPS impact (< 0.1%)
- Memory efficient caching
- Async file operations where possible

#### Compatibility
- Works alongside WorldGuard
- Works alongside GriefPrevention
- Compatible with most protection plugins
- No known conflicts

### Configuration Files

#### config.yml
Main configuration file with settings for:
- Language preferences
- Protection behavior
- Message display
- Sound and particle effects
- Claim prevention
- Storage options
- Bypass settings
- Debug mode

#### Language Files
Six included language files with complete translations:
- All commands and responses
- Error messages
- Success notifications
- Denial messages
- Information displays

#### Protection Files
JSON format files per world:
- world.json
- world_nether.json
- world_the_end.json
- Custom world files as needed

### Known Issues
None reported in this release.

### Future Plans
- Economy integration for area purchasing
- Time-based protections (rent system)
- Region groups and inheritance
- Advanced flag permissions (per-player)
- Web-based management interface
- API for third-party integration

### Installation

1. Download ProtectsAllam.jar
2. Place in server's plugins folder
3. Restart server
4. Configure settings in config.yml
5. Set preferred language
6. Start creating protections

### Upgrade Notes
This is the initial release - no upgrade path needed.

### Credits
Developed for professional Minecraft server management with focus on flexibility, performance, and user experience.

### Support
For support and documentation:
- Check the docs folder for detailed guides
- Enable debug mode for troubleshooting
- Review example configurations
- Contact developer for assistance

### License
All rights reserved.

### Changelog

#### Version 1.0.0 (Initial Release)
- Implemented dual protection system (AxA and Selection)
- Added JSON storage with auto-backup
- Implemented 7 configurable protection flags
- Added multi-language support (6 languages)
- Created claim prevention system
- Added sound and particle effects
- Implemented actionbar messaging
- Added comprehensive configuration options
- Created automatic save system
- Added bypass permission system
- Implemented explosion protection
- Added fire spread prevention
- Created item drop control
- Added bucket usage control
- Implemented entity damage control
- Created container interaction control
- Added debug mode
- Implemented auto-reload system
- Created backup management
- Added permission system