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