ВЕРСИИ (17)

## [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) ```gradle 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

- Update RegenSystem API - Optimization plugin

- Added detection of **Spigot servers**, and _does not allow the plugin to be launched on them_.

- Release RegenSystem API, fixed all bugs

- Fixed some bugs - Improvement of certain performance aspects - Still a bug with RegenSystemAPI, currently being fixed.

- Fix RegenSystem API - More optimizations

- **API** improvements with additions and optimizations

- 📦 JitPack-compatible multi-module build - 🎯 Initial API with `RegenZoneEvent`

- Added **bStats** for usage statistics tracking. - Implemented an automatic plugin version check system.

- Improved and more secure database management. - Added additional placeholders for greater customization. - Synchronized timer placeholders with the regeneration - tasks for accurate updates. - Introduced a GUI menu for easier and more intuitive usage. - Enhanced zone management: with the new save, delete, and reload commands, zones can now be handled individually instead of reloading all at once.

- Added support for PlaceholderAPI integration and custom placeholders. - Entire plugin messages, logs, and commands have been rewritten in English. - Improved DatabaseManager for better stability and performance.

# Features - Basic zone management system with pos1/pos2 selection commands. - Save, reload, delete, and snapshot zones via /regen commands. - Zone regeneration scheduler based on configurable delays. - Support for enabling/disabling regeneration globally and per zone. - Custom prefix support for chat messages configurable via config.yml. - Commands tab completion with dynamic suggestions for zones. - Diamond axe as a selection tool for easier zone selection. - Zone block data now saved in an SQLite database for better performance and modularity. - Regen tasks automatically start and stop according to zone status. - Player-friendly messages with color codes. - Configurable regen delay per zone. # Known Issues - Plugin is in active development; expect bugs and missing features. - No GUI yet; all commands are text-based. - Some edge cases in regen toggling may need refinement. - Initial zone loading from database can be slower than file-based for very large zones. - SQLite file locking might occur in rare concurrent access situations (planned improvements).

# Features - Basic zone management system with pos1/pos2 selection commands. - Save, reload, delete, and snapshot zones via /regen commands. - Zone regeneration scheduler based on configurable delays. - Support for enabling/disabling regeneration globally and per zone. - Custom prefix support for chat messages configurable via config.yml. - Commands tab completion with dynamic suggestions for zones. - Hache de sélection (diamond axe) for easier zone selection. - Zone data saved in separate files for modularity. - Regen tasks automatically start and stop with zone status. - Player-friendly messages with color codes. - Configurable regen delay per zone. # Known Issues - Plugin is in active development, expect bugs and missing features. - No GUI yet; all commands are text-based. - Some edge cases in regen toggling may need refinement.