RegenSystem

[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")