Skip to content
This repository was archived by the owner on Mar 31, 2026. It is now read-only.

RegenSystem v2.0.3

Latest
Latest

Choose a tag to compare

View all tags
@D44SHK D44SHK released this 20 Jan 22:29
v2.0.3
dbd98fc

[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")
Assets 3
Loading