RegionSpawnMobs - Changelog

Version 1.0.5 (BETA) - Current Release

New Features

• Player-Centric Spawning: Mobs now spawn in a ring around players instead of random locations

  • Configurable minimum and maximum spawn distance from players
  • Random angle distribution for natural mob placement
  • Prevents mobs spawning directly on top of players

• Dynamic Region Capacity: Automatic capacity calculation based on region size

  • Formula: totalChunks × maxPerChunk
  • Regions scale naturally with their dimensions
  • Better resource distribution across different region sizes

• Spawn Distance Control: New global configuration options

  • minSpawnDistanceChunks: Minimum distance from player (default: 1 chunk = 32 blocks)
  • maxSpawnDistanceChunks: Maximum distance from player (default: 3 chunks = 96 blocks)
  • Fine-tune spawn proximity for different gameplay experiences

Performance Improvements

• Spatial Grid Indexing: O(1) region lookups by chunk coordinates

  • Eliminates expensive region iteration
  • Faster player proximity checks
  • Improved performance with many regions

• Chunk-Based Distance Calculations: All distance checks use chunk coordinates

  • Avoids expensive square root operations
  • Integer-based comparisons instead of floating-point
  • Significant performance boost for proximity tracking

• Spawn Failure Tracking: Prevents repeated invalid spawn attempts

  • Tracks failed spawn locations
  • Skips known-bad positions
  • Reduces wasted computation

• Saturation Tracking: Optimizes spawn attempt distribution

  • Monitors chunk saturation levels
  • Prioritizes unsaturated areas
  • Better mob distribution across regions

System Improvements

• Smart Containment System: Enhanced mob boundary enforcement

  • Keeps mobs within regions without breaking combat
  • Configurable containment modes (OFF, RETURN, TELEPORT)
  • Respects combat engagement to prevent exploits

• Enhanced Player Tracking: Improved player proximity detection

  • Chunk-based player position caching
  • Efficient multi-region player tracking
  • Better performance with many players

Configuration Changes

• New Global Settings:

  • minSpawnDistanceChunks - Minimum spawn distance from players
  • maxSpawnDistanceChunks - Maximum spawn distance from players
  • Dynamic capacity calculation (no manual capacity setting needed)

• Updated Commands:

  • /rsmglobalspawnrange <chunks> - Set player detection range
  • /rsmcontainment <mode> - Configure containment behavior

Bug Fixes

• Fixed mob clustering in small regions
• Improved ground validation for spawn positions
• Better handling of edge cases in chunk boundaries
• Corrected despawn timing with multiple players

Documentation

• Added comprehensive player-centric spawning guide
• Updated administrator guide with new features
• Added visual examples for spawn distance configuration
• Improved command reference documentation