ProtectsAllam

# **⚔ 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** ``` /areaprotect 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 Create protection using your two selected points Example: /protect MyBase ``` **MANAGEMENT COMMANDS** ``` /protectlist List all protected areas with detailed information /protectinfo Display detailed information about a specific area /unprotect Remove protection from an area (requires permission) /protectreload Reload plugin configuration and language files ``` ## **PERMISSIONS** ``` 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** ``` # 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)** ``` { "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** ``` /areaprotect 100 100 Spawn Result: Creates a 100x100 protection centered at 0,0 ``` **Example 2: Custom Building Protection** ``` 1. Stand at first corner: /pset 1 2. Stand at opposite corner: /pset 2 3. Create protection: /protect MyBase ``` **Example 3: PvP Arena Configuration** ``` 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 ⚔**