[v2.0.3] – 2026-01-20

🚀 Highlights

This release introduces a brand new public API architecture and establishes a stable foundation for external addons.

⚠️ This release contains breaking changes for addon developers,
but remains fully backward-compatible for server owners and players.

This is the recommended base version for future addon development.

🧩 API (Public & Stable)

✅ New

• Introduced a fully separated API module (regensystem-api)
• Added official API entry point:
  • RegenSystemAPI
• Added explicit API versioning:
  • API_VERSION
  • API_MAJOR, API_MINOR, API_PATCH
• Introduced new core API contracts:
  • ZoneManager
  • Zone
  • ZoneFlag
  • RegenResult

🎯 Events API

All zone lifecycle events are now officially exposed and documented:

• ZoneCreateEvent (cancellable)
• ZoneDeleteEvent (cancellable)
• ZoneReloadEvent (cancellable)
• ZonePreRegenEvent (cancellable)
• ZonePostRegenEvent (non-cancellable)
• ZoneFlagChangeEvent (cancellable)

🛡️ API Stability & Safety

Added

• Clear separation between public API and internal implementation
• @ApiStatus.Internal on non-public methods
• @ApiStatus.NonExtendable on API events
• Strict API boundaries (no core access)

Guarantees

• API stability within the same major version
• No reflection or unsafe hooks required
• Safe event-driven extension model

❗ Breaking Changes (Addon Developers)

⚠️ Yes – Breaking API Changes

• Complete API redesign
• Old API contracts are not compatible
• Addons targeting versions < 2.0.3 must be updated

Migration required for all external plugins.

✅ No Breaking Changes (Server Owners)

• Existing zones are preserved
• Configuration files unchanged
• Commands and permissions unchanged
• Database format unchanged

No action required for server administrators.

🔄 Compatibility

• Minecraft: 1.20.x → 1.21.x
• Platforms:
  • Paper ✅
  • Folia ✅
  • Spigot ✅
• Java: 21+

🧪 Experimental API

• No experimental APIs exposed in this release
• Future experimental APIs will live under: fr.darklash.regensystem.api.experimental

📦 Dependency (JitPack)

compileOnly("com.github.DarkLashDev:RegenSystem:v2.0.3")

🚀 Major Improvements

⚡ Full Folia Support

• Added native Folia compatibility using region-safe and async-safe schedulers
• Implemented a platform-aware scheduler abstraction (Paper / Folia / Spigot)
• Fixed all threading violations (chunk access, block updates, region execution)
• Zone regeneration now runs safely inside region threads on Folia

🧠 Smart Platform Detection

• Automatic runtime detection of:

  • Folia
  • Paper
  • Spigot

• The plugin adapts its behavior dynamically depending on the server platform

• No configuration changes required — everything is automatic

🔧 Compatibility & Stability

✅ Spigot Support Restored

• Added safe fallbacks for missing Paper / Adventure APIs
• Automatic legacy text conversion when Adventure components are unavailable
• Teleport handling now adapts to platform capabilities

🧱 Regeneration System Improvements

• Fixed async chunk access errors on Folia

• Block regeneration is now:

  • Region-safe
  • Thread-safe
  • Platform-safe

• Players inside regenerating zones are now handled safely on all platforms

📊 Metrics & Monitoring

📈 bStats Enhancements

• Added new custom chart:

  • zones_total — total number of registered regen zones

• Improved internal metrics reliability on Folia servers

🔄 Internal Refactors

• Introduced RegenScheduler abstraction layer

• Separated platform-specific logic:

  • PaperRegenScheduler
  • FoliaRegenScheduler

• Cleaner architecture and easier future maintenance

• Improved logging and debug safety

🐛 Fixes

• Fixed server crashes caused by:

  • Async chunk loading
  • Unsafe player teleportation on Folia

• Fixed compatibility issues with:

  • Paper 1.21+
  • Folia region threading

• Improved update checker stability

🧭 Notes

• No breaking changes for existing configurations
• Existing zones, databases, and configs are fully compatible
• This version lays the groundwork for future performance optimizations

• Adding language support
• In-game control optimizations

• Updated Database and Gradle settings
• Optimization plugin

• Update JitPack and API