• Fixed GH-104 - Console spam when using spawn eggs.

v5.0.0 is a complete rewrite of ChunkSpawnerLimiter, focused on performance.

Requirements

• Java 21+
• Minecraft 1.8.8 → 1.21.10

Core Rewrite & Architecture

• Complete internal rewrite of CSL
• Major performance improvements across all systems
• Automatic Minecraft version detection for proper CraftBukkit/NMS handling
• Automatic world size detection — no manual configuration required
• Cached world lists in config (O(n) → O(1) access)
• Significant performance improvements in PluginConfig

Configuration Changes

• New unified configuration system

  • config.yml and blocks.yml merged
  • Removed obsolete options and added new ones
  • Stronger, more sensible defaults
    Default config:
    https://github.com/sarhatabaot/ChunkSpawnerLimiter/blob/5.0.0/src/main/resources/config.yml

• Optional entity group overrides via config

• Improved world enable/disable logic (exclude vs excluded handling fixed)

• Configurable periodic chunk inspection (default: every 60 seconds)

Entity Handling & Enforcement

• New mode system replacing kill-instead-of-remove

Available Modes

• enforce (default, recommended) – prevent spawn + remove excess

• enforce-kill – prevent spawn + kill excess

• prevent – prevent spawn if limit is reached (CreatureSpawnEvent)

• kill – kill excess entities

• remove – remove excess entities

• Automatic player killing when limits are exceeded (configurable)

• Spawn eggs are returned to players if consumed while a limit is already reached

• Improved entity/block removal logic

• Player notification system for chunk limit violations

Testing & Quality Assurance

• Major test suite expansion
• Separate test suites for:
  • Legacy versions (1.8–1.12)
  • Modern versions (1.17+)
  • Unit tests
• Improved concurrent testing stability
• Fixed race conditions and resource leaks
• Resolved missing dependencies and classpath issues

Technical Improvements

• Complete NMS Block Scanner rewrite
• Improved version compatibility and reliability
• Enhanced debug logging for NMS initialization
• Major performance fix for chunk unload handling

Bug Fixes

• Fixed CraftBukkit package detection (v1_20_R1, etc.)
• Fixed world filtering logic (isWorldDisabled)
• Fixed bad performance on chunk unload
• Fixed concurrent test race conditions
• Fixed test compilation and dependency issues

Build & Dependencies

• Added Adventure API, bStats, and correct API versions for tests
• Streamlined Gradle build configuration
• Improved shadow JAR relocation for better library compatibility

Upcoming (Post-5.0.0)

• Optional third-party region support (non-chunk based), low priority (5.1.0)
• Advanced per-entity preservation logic

• Fixed bad performance on chunk unload.
• Eggs should be returned to players on consumption if limit was reached.
• Cached world list in config (O(n) per access → O(1) per access)

TLDR:

Improved performance in regards to the blocks & entities features. Please report any issues on the discord, as I'm still testing performance issues.

Changelog: v5.0.0-RC3 to v5.0.0-RC4

🧪 Testing & Quality Assurance

• Comprehensive test suite expansion - Added extensive unit and integration tests across multiple Minecraft versions
• Multi-version test support - Implemented separate test suites for legacy (1.8-1.12), modern (1.17+), and unit tests
• Test framework improvements - Enhanced concurrent testing, fixed race conditions, and improved resource management

🔧 Technical Improvements

• NMS Block Scanner overhaul - Complete rewrite of the block scanning system with better version compatibility
• Version detection system - Added automatic Minecraft version detection for proper CraftBukkit package handling
• Debug logging enhancement - Added detailed logging for troubleshooting NMS initialization issues

🐛 Bug Fixes

• CraftBukkit package detection - Fixed ModernNmsScanner to properly detect versioned CraftBukkit packages (v1_20_R1, etc.)
• World filtering logic - Corrected isWorldDisabled() method to properly handle "excluded" vs "exclude" mode checking
• Test compilation issues - Resolved missing dependencies and classpath problems across all test suites
• Concurrent test race conditions - Fixed thread safety issues in test execution

📦 Dependencies & Build

• Test dependencies - Added adventure API, bStats, and proper API versions for all test configurations
• Gradle configuration - Streamlined build process with proper test suite organization
• Library relocation - Improved shadow jar configuration for library compatibility

🎯 Configuration & Features

• Notification system - Added player notification features for chunk limit violations
• Inspection frequency - Configurable periodic chunk inspection (default: every 60 seconds)
• World filtering - Enhanced world enable/disable functionality
• Removal modes - Improved entity/block removal logic and player kill options

5.0.0 is a complete re-write of CSL.

• Java 21+ Required
• New config (Merged config.yml + blocks.yml)
  • Removed some options & added new ones
  • More powerful defaults. See it here: https://github.com/sarhatabaot/ChunkSpawnerLimiter/blob/5.0.0/src/main/resources/config.yml
• 1.8.8 -> 1.21.10 Support
• Automatic world size detection, no need to set in config.
• Overriding entity groups in config (optional).
• Better performance (finally)
• Automatically kill players if a limit has been reached.
• Replaced kill-instead-of-remove with a new "mode" setting:
  • Options: enforce (default - recommended), enforce-kill, prevent, kill, remove kill -> "kill-instead-of-remove" prevent -> don't spawn the mob if the limit is reached (using CreatureSpawnEvent) enforce -> prevent+remove enforce-kill -> prevent+kill

Upcoming Features

• Possible third party region support instead of chunks (later, low priority, 5.1.0)
• Advanced per entity preservation

https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v5.0.0-RC1

• Fixed an NPE GH-#89.
• Code cleanup & optimizations.

• Fixes an issue where an illegal state is triggered.

https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v4.4.2

What's Changed

• Better Task cancelling by @PanSzelescik in https://github.com/sarhatabaot/ChunkSpawnerLimiter/pull/84

Full Changelog: https://github.com/sarhatabaot/ChunkSpawnerLimiter/compare/v4.4.0...v4.4.1

Entities Feature

• Moved entity limit calculations to an async task to prevent server lag during chunk inspections.

Blocks Feature

• Faster Checks – High-limit blocks (like stone/dirt) now use a cache system for instant checks.
• Accurate Limits – Low-limit blocks (like spawners) still scan chunks to ensure precision.
• Reduced Lag – Cache automatically clears when chunks unload or blocks break.

Config & More debug

• Config option – Adjust cache.min-limit-for-cache: 50 in blocks.yml to balance speed/accuracy.
• More debug logs.

Entities Feature

• Moved entity limit calculations to an async task to prevent server lag during chunk inspections.

Blocks Feature

• Faster Checks – High-limit blocks (like stone/dirt) now use a cache system for instant checks.
• Accurate Limits – Low-limit blocks (like spawners) still scan chunks to ensure precision.
• Reduced Lag – Cache automatically clears when chunks unload or blocks break.

Config & More debug

• Config option – Adjust cache.min-limit-for-cache: 50 in blocks.yml to balance speed/accuracy.
• More debug logs.

Changes, Fixes

• Probably fixes #74
• Some performance improvements
• If there is a problem with the material name in blocks.yml it'll log it in the console.
• General code cleanup and refactors.
• Changed blocks.yml worlds path, it's now:

worlds:
  world_nether:
    min-y: 0
    max-y: 128

Full Changelog: https://github.com/sarhatabaot/ChunkSpawnerLimiter/compare/v4.3.11...v4.3.12

• Added 1.21.4 Support

See full changelog at: https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v4.3.11

• Update NBT-API to support 1.21.3
• Minor optimizations & documentation additions.

Full changelog at https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v4.3.10

Fixed console error.

Changes

Added 3 new config settings:

  watch-entity-spawns: true
  # Only relevant if kill-instead-of-remove is used (unless paper's tick setting is set to false)
  # Drops the items from the armor stands, i.e. helmet, etc
  drop-items-from-armor-stands: false

  log-armor-stand-tick-warning: true

Fixed a bug that caused the watch-vehicle-create-event setting to not function correctly.

Changed Feature:

The excluded worlds config entry has been removed. Instead we now have a "worlds" section.

worlds:
  mode: "excluded"
  worlds: []

This allows worlds to either be excluded from the checks, or to be limited to just the set worlds.

Bug Fixes

• Potentially fixed a memory leak with Entity & Chunk objects.

Full changelog: https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v4.3.8

New features & Bug Fixes

• Feature/kill instead of remove by @sarhatabaot in https://github.com/sarhatabaot/ChunkSpawnerLimiter/pull/35. To enable this add:

kill-instead-of-remove: true

• Bug fix for block limiter.
• Search feature for entity types:

Full changelog at: https://github.com/sarhatabaot/ChunkSpawnerLimiter/releases/tag/v4.3.7

• Added an option to disable metrics. (Metrics are enabled by default)
• Added a generic help command.

https://github.com/sarhatabaot/ChunkSpawnerLimiter/compare/v4.3.3...v4.3.5