Area Protection v1.0.0 - Initial Release

Overview

A comprehensive server-side region protection and alert system for Minecraft 1.21.11 with LuckPerms integration. Create protected regions, manage permissions, receive real-time alerts, and control who can access your areas.

Core Features

Region Management

• Create Protected Regions: Define rectangular areas with /area pos1, /area pos2, and /area create <name>
• Delete Regions: Remove regions with /area delete <name>
• View Region Info: Display region details, protection status, and lists with /area info <name> or /area list
• Region Expansion: Expand existing regions in any direction (up, down, north, south, east, west) with /area expand <region> <direction> <amount>
• Priority System: Assign priority levels to regions for overlap handling
• Volume Limits: Configurable maximum region volume per player (default: 1,000,000 blocks)
• Per-Player Limits: Limit how many regions a player can create (default: 10 regions per player)
• Overlap Prevention: Prevents creation of regions that overlap with existing regions

Protection Flags

Toggle protection on/off per region with /area protection <region> <type> <true/false>:

Protection Type	Description
block_break	Prevent unauthorized block breaking
block_place	Prevent unauthorized block placement
block_interact	Prevent interaction with blocks (buttons, levers, etc.)
container_open	Prevent access to containers (chests, barrels, hoppers, etc.)
entity_damage	Prevent damage to non-player entities (animals, pets, etc.)
pvp	Prevent player-versus-player combat

All protection flags enabled by default on new regions.

Access Control

Whitelist System

• Add players to whitelist: /area whitelist add <region> <player>
• Remove from whitelist: /area whitelist remove <region> <player>
• Whitelisted players can perform protected actions

Blacklist System

• Add players to blacklist: /area blacklist add <region> <player>
• Remove from blacklist: /area blacklist remove <region> <player>
• Blacklisted players have no access to protected actions
• Whitelisting a blacklisted player (or vice versa) removes them from the opposite list

Owner Control

• Only region owner or admins can modify region settings
• Region owner is the player who created the region
• Admin permission: areaprotection.admin

Alert System

Real-Time Alerts

• Receive alerts instantly when someone violates protection rules
• Alerts sent to region owner if online
• View pending alerts with /alert inbox [page]
• Clear alerts with /alert clear
• View alert history with /alert history <region> [page]

Alert Types

Toggle specific alert types with /alert settings <region> <type>:

Alert Type	Triggered When
enter	Any player enters the region
leave	Any player exits the region
block_break	Someone attempts to break a protected block
block_place	Someone attempts to place a protected block
block_interact	Someone attempts to interact with a block
container_open	Someone attempts to open a container
entity_damage	Someone attempts to damage an entity
pvp	Someone attempts player combat

Offline Alert Storage

• Alerts are stored when region owner is offline
• Automatically delivered when player logs in
• Shows first 5 alerts in chat, can view all with /alert inbox

Alert Cooldowns

• Configurable per alert type to prevent spam (default: 30-60 seconds)
• Prevents duplicate alerts for the same action in quick succession

Toggle Alerts

• Disable all alerts for a region: /alert toggle <region>
• Re-enable with the same command

Custom Messages

• Set enter message: /area message <region> enter <message>
• Set leave message: /area message <region> leave <message>
• Messages displayed in color to all players entering/leaving the region

Permission Integration

LuckPerms Support

• Automatic LuckPerms detection and integration
• Assign permissions via LuckPerms web editor or in-game
• Permissions automatically registered with LuckPerms on server start

Permission Nodes

Permission	Use
areaprotection.pos	Use /area pos1 and /area pos2 commands
areaprotection.create	Create new regions with /area create
areaprotection.delete	Delete regions with /area delete
areaprotection.whitelist	Manage whitelists
areaprotection.blacklist	Manage blacklists
areaprotection.protection	Modify protection settings
areaprotection.alerts.receive	Receive alert notifications
areaprotection.bypass	Bypass all protections (admin only)
areaprotection.admin	Full admin access to all regions
areaprotection.reload	Reload configuration

Fallback Permissions

• If LuckPerms not installed, basic permissions granted to all players by default
• Admin permissions require server op status (level 4) or LuckPerms permission

Configuration

• config/areaprotection.json - Customizable settings:
  • limits.maxRegionVolume - Maximum blocks per region (default: 1,000,000)
  • limits.maxRegionsPerPlayer - Maximum regions per player (default: 10)
  • alertCooldowns - Alert cooldown times in seconds
  • defaultProtectionFlags - Default protection settings for new regions
  • blacklistHardBlock - Whether to prevent breaking certain blocks in regions

Data Storage

• Automatic region and alert data persistence to config/areaprotection/
• JSON-based storage for easy backup and editing
• Offline alerts retained across server restarts

Event Handling

• Block Breaking: Monitor and prevent unauthorized block destruction
• Block Interaction: Prevent button, lever, and other block interactions
• Entity Damage: Prevent harm to animals and entities
• Player Movement: Track region entry/exit, display messages, trigger alerts
• Container Access: Prevent unauthorized container opening
• Player Connection: Deliver offline alerts on login

Technical Details

Requirements

• Minecraft Version: 1.21.11
• Fabric Loader: 0.17.3+
• Fabric API: 0.141.1+1.21.11
• Java: 21+

Optional Dependencies

• LuckPerms: For advanced permission management (automatic detection)

Mappings

• Uses Mojang official mappings for 100% compatibility

Command Reference

/area pos1                              - Set position 1 at current location
/area pos2                              - Set position 2 at current location
/area create <name> [priority]          - Create region from selection
/area delete <name>                     - Delete a region
/area info <name>                       - Show region details
/area list                              - List all regions
/area protection <region> <type> <true/false> - Toggle protection
/area whitelist add <region> <player>   - Add to whitelist
/area whitelist remove <region> <player> - Remove from whitelist
/area blacklist add <region> <player>   - Add to blacklist
/area blacklist remove <region> <player> - Remove from blacklist
/area message <region> enter <message>  - Set enter message
/area message <region> leave <message>  - Set leave message
/area expand <region> <direction> <amount> - Expand region

/alert toggle <region>                  - Toggle all alerts on/off
/alert inbox [page]                     - View offline alerts
/alert clear                            - Clear all offline alerts
/alert history <region> [page]          - View region alert history
/alert settings <region> <type>         - Toggle specific alert type

File Structure

config/
├── areaprotection.json           - Main configuration
└── areaprotection/
    ├── regions.json              - Saved regions
    └── offline_alerts.json       - Stored offline alerts

Notes

• Region protection is server-side only (works on both vanilla and modded clients)
• All timestamps stored in UTC and formatted for player's timezone
• Alert cooldowns prevent spam but don't prevent violations
• Blacklist + whitelist on same player: player goes to opposite list (removes from previous)

Version Info

• Version: 1.0.0
• Release Date: January 2026
• Status: Initial Release