⚔ PROTECTS ALLAM ⚔
Advanced Area Protection Plugin for Minecraft
Professional Territory Management System
Version 1.0.0 | Minecraft 1.17.x - 1.21.x | Spigot/Paper
✨ MAIN FEATURES
DUAL PROTECTION SYSTEM
- AxA Protection: Quick protection using coordinates (X, Z) with automatic full-height coverage
- Selection-Based: Two-point selection system for precise custom areas
- Automatic Y-Axis: Protection from bedrock (-64) to build limit (319)
- Multi-World Support: Independent protection in multiple worlds
INTELLIGENT DATA STORAGE
- JSON Format: Easy-to-read and manually editable protection files
- Auto-Recovery: Automatic backup system with instant recovery
- Hot Reload: Update configurations without server restart
- Data Integrity: Validation and error correction on every load
ADVANCED PROTECTION SYSTEM
- Block Break/Place: Prevent block destruction and placement
- Container Protection: Chests, furnaces, barrels, hoppers, dispensers
- Interaction Control: Doors, gates, trapdoors, buttons, levers
- Entity Damage: Prevent PvP and mob damage
- Bucket Usage: Block water and lava bucket usage
- Item Drops: Prevent players from dropping items
- Explosion Protection: TNT, creepers, and fire spread prevention
CLAIM PREVENTION SYSTEM
- Item-Based Claims: Blocks golden shovels, sticks, and custom items
- Command Blocking: Prevents claim commands from other plugins
- Supported Plugins: GriefPrevention, WorldGuard, Residence, Towny, Lands, PlotSquared, Factions
- Customizable Lists: Add your own items and commands to block
VISUAL & AUDIO FEEDBACK
- Actionbar Messages: Non-intrusive notifications above hotbar
- Sound Effects: Configurable denial sounds (ENTITY_VILLAGER_NO)
- Particle Effects: Visual feedback with smoke particles
- Chat Messages: Optional chat notifications
MULTI-LANGUAGE SUPPORT
- 6 Languages Included: English, Portuguese (BR), Spanish, Italian, Russian, Chinese
- Automatic Detection: Uses player's client language
- Custom Translations: Easy to add new languages
- Placeholder System: Dynamic content in messages
⚙️ FLEXIBLE CONFIGURATION
- Per-Area Permissions: 7 independent flags per protected area
- JSON Configuration: Manually edit protection rules
- Config.yml Settings: Global plugin behavior control
- Debug Mode: Detailed logging for troubleshooting
COMMANDS
AREA PROTECTION COMMANDS
Code (Text):
/areaprotect <X> <Z> <name>
Create an AxA protection at coordinates X,Z with specified name
Example: /areaprotect 100 200 Spawn
/pset 1
Set first selection point at your current location
/pset 2
Set second selection point at your current location
/protect <name>
Create protection using your two selected points
Example: /protect MyBase
MANAGEMENT COMMANDS
Code (Text):
/protectlist
List all protected areas with detailed information
/protectinfo <name>
Display detailed information about a specific area
/unprotect <name>
Remove protection from an area (requires permission)
/protectreload
Reload plugin configuration and language files
PERMISSIONS
Code (Text):
protects.admin - Full access to all commands
protects.create - Create new protected areas
protects.remove - Remove protected areas
protects.list - List all protected areas
protects.info - View protection information
protects.reload - Reload plugin configuration
protects.bypass - Bypass all protection restrictions
protects.bypass.item-drop - Bypass item drop restrictions
protects.claim.bypass - Bypass claim prevention system
⚙️ CONFIGURATION
CONFIG.YML SETTINGS
Code (Text):
# Language Settings
language:
default-language: en
auto-detect: true
# Protection Settings
protection:
prevent-explosions: true
prevent-fire-spread: true
# Message Settings
messages:
actionbar-enabled: true
chat-messages-enabled: false
# Effect Settings
effects:
sound:
enabled: true
type: ENTITY_VILLAGER_NO
volume: 1.0
pitch: 1.0
particles:
enabled: true
type: SMOKE_NORMAL
count: 20
# Claim Prevention System
claim-prevention:
enabled: true
prevent-item-claims: true
prevent-command-claims: true
custom-claim-items:
- "CUSTOM_ITEM_NAME"
custom-claim-commands:
- "customclaim"
# Storage Settings
storage:
auto-save-interval: 300
create-backups: true
max-backup-files: 10
# Bypass Settings
bypass:
ops-bypass-by-default: true
# Debug Settings
debug:
enabled: false
log-protection-checks: false
PER-AREA FLAGS (JSON)
Code (Text):
{
"name": "Spawn",
"world": "world",
"blockBreak": true, // Block breaking
"blockPlace": true, // Block placing
"blockInteract": true, // Container/door interaction
"blockDamageEntity": true, // PvP and mob damage
"blockBucketUse": true, // Water/lava buckets
"blockClaimCreation": true, // Other claim plugins
"blockItemDrop": true // Item dropping
}
USAGE EXAMPLES
Example 1: Protect Spawn Area
Code (Text):
/areaprotect 100 100 Spawn
Result: Creates a 100x100 protection centered at 0,0
Example 2: Custom Building Protection
Code (Text):
1. Stand at first corner: /pset 1
2. Stand at opposite corner: /pset 2
3. Create protection: /protect MyBase
Example 3: PvP Arena Configuration
Code (Text):
Edit JSON file:
{
"name": "PvPArena",
"blockBreak": true,
"blockPlace": true,
"blockDamageEntity": false, // Allow PvP
"blockItemDrop": true
}
TECHNICAL DETAILS
SYSTEM REQUIREMENTS
- Server: Spigot, Paper, or compatible fork
- Minecraft Version: 1.17.x to 1.21.x
- Java Version: Java 17 or higher
- Dependencies: None (standalone plugin)
PERFORMANCE
- Optimized Checks: Efficient area lookup algorithm
- Async Operations: Non-blocking file operations
- Minimal TPS Impact: < 0.1% on average servers
- Memory Efficient: Smart caching system
COMPATIBILITY
- WorldGuard: Compatible (claim prevention available)
- GriefPrevention: Compatible (claim prevention available)
- Other Protection: Works alongside most plugins
- Economy Plugins: Ready for future integration
INSTALLATION
Step 1: Download the plugin JAR file
Step 2: Place it in your server's
plugins folder
Step 3: Restart or reload your server
Step 4: Configure
config.yml to your preferences
Step 5: Choose your preferred language in config
Step 6: Start protecting your areas!
SUPPORT & LINKS
Need Help?
- Check the full documentation in the docs folder
- Enable debug mode for detailed logging
- Review example configurations
- Contact the developer for support
Features Summary
- ✅ Dual protection methods (AxA + Selection)
- ✅ JSON storage with auto-recovery
- ✅ 6 language support
- ✅ Sound and particle effects
- ✅ Claim prevention system
- ✅ 7 configurable protection flags
- ✅ Zero dependencies
- ✅ Active development
⚔ Protect Your World with Confidence ⚔