RegionSpawnMobs

========================================
NEW FEATURES
========================================

• Player-Gated Spawning
  - Mobs only spawn when players are nearby (configurable)
  - Default spawn range: 96 blocks from region center
  - Commands:
    /rsmglobalspawnrange <blocks>
    /rsmglobalrequireplayers <true/false>

• Auto-Despawn (no players nearby)
  - Automatically despawns mobs when no players are close
  - Default despawn range: 128 blocks from region center
  - Default timeout: 10 seconds without players
  - Commands:
    /rsmglobaldespawnrange <blocks>
    /rsmglobaltimeout <seconds>
    /rsmglobaldespawn <true/false>

• Chunk Density Control (anti-cluster)
  - Limits mobs per chunk to prevent stacking/clustering
  - Default: 3 mobs per chunk (set to 0 for unlimited)
  - Command:
    /rsmglobalmaxperchunk <number>

• Global Settings (saved automatically)
  - Global config file: plugins/RegionSpawnMobs/global_config.json
  - Command to view current settings:
    /rsmglobal

• Region Settings Commands (separated)
  - /rsmsetinterval <region> <seconds>
  - /rsmsetquantity <region> <min> <max>
  - /rsmsetmaxmobs <region> <number>

• Kill Command (cleanup)
  - Removes mobs from a specific region or all regions
  - Also removes orphaned mobs (without a valid region)
  - Command:
    /rsmkill [region_name]

========================================
FIXES & IMPROVEMENTS
========================================

• Much better spawn position checking
  - Searches the entire height of the region for valid ground (not only 10 blocks)
  - Reduces spawn failures in uneven terrain / blocked areas

• Smarter spawn retries
  - If a chunk is full (maxPerChunk), tries up to 10 different positions before failing
  - Less “spawn failed” errors due to chunk saturation

• Cleaner logs
  - Reduced repetitive warnings
  - Only reports failures after all attempts are exhausted

• Better performance in empty areas
  - Fewer useless spawns when nobody is nearby
  - Auto-despawn reduces entity count when areas are empty

========================================
USAGE EXAMPLES
========================================

View current global settings:
  /rsmglobal

Recommended default (balanced):
  /rsmglobalmaxperchunk 3
  /rsmglobalspawnrange 96
  /rsmglobaldespawnrange 128
  /rsmglobaltimeout 10
  /rsmglobalrequireplayers true
  /rsmglobaldespawn true

Cleanup mobs:
  /rsmkill
  /rsmkill arena_goblins