## 📦 KX-Spawn 1.2 — Changelog [Compare 1.1...1.2 on GitHub](https://github.com/DEVKaxtusik/KX-Spawn/compare/1.1...1.2) ### ✨ Major Changes - **Multi-module Gradle Setup** - Project is now split into `paper` and `bukkit` modules for better platform separation and maintainability. - Cleaned up old `src` structure and removed unnecessary files. - **Enhanced Build & CI** - Updated Gradle configuration: shared settings in root `build.gradle`, module-specific Java toolchains. - GitHub Actions CI now builds both modules with Java 17 and 21 for maximum compatibility. ### 🆕 Features - **Teleportation Sounds & Feedback** - Added XSound integration for teleportation feedback. - **Metrics** - Implemented bStats metrics collection for plugin usage analytics. - **Configurable Teleportation** - Added `teleportOnEveryJoin` configuration option. - Enhanced messages config with comprehensive documentation. - **Dynamic Command System** - Implemented configurable command system with bridge architecture. - Added `@description` annotations to all commands and subcommands. - Migrated from hardcoded to config-based permission system. - Created `Command` and `SubCommand` models with serialization support. - Added support for dynamic command configuration (aliases, permissions, enable/disable). - Enhanced error messages and permission handling consistency. - **WorldGuard Integration** - Added instant region checking with WorldGuard. - Region configuration and caching for performance. - Region-based instant teleportation and bypass permission. ### 🛠️ Improvements & Fixes - Improved code quality and fixed various bugs. - Enhanced configuration reload to refresh cached regions and settings. - Moved command and config related classes to bridge package structure. - Refactored and modularized code for easier maintenance and extension. ### ⚠️ Breaking Changes - Command and config classes moved to the `bridge` package. - Permission system now requires configuration setup. - Hardcoded permissions replaced with configurable values. --- **Upgrade Notes:** - Please review your configuration files and update as needed for the new command and permission system. - If you use WorldGuard, enjoy new region-based instant teleport features! --- For more details, see the full [1.1...1.2 diff on GitHub](https://github.com/DEVKaxtusik/KX-Spawn/compare/1.1...1.2). ---

Bukkit release (soon to be removed)

# KX-Spawn v1.1 - Major Update ## 🎵 New Features ### Audio Feedback System - **Teleportation Sounds**: Added `XSound` integration for immersive audio feedback - **Countdown Audio**: Subtle `UI_BUTTON_CLICK` sound during teleportation countdown - **Success Sound**: Satisfying `BLOCK_NOTE_BLOCK_PLING` when teleportation completes - **Fully Configurable**: Set sounds to `null` to disable, or use any Minecraft sound name ### Analytics & Metrics - **bStats Integration**: Anonymous usage statistics to help improve the plugin - **Privacy Focused**: Server owners can opt-out via `bStats/config.yml` - **Performance Monitoring**: Track plugin usage and server compatibility ### Enhanced Spawn Options - **Always Spawn on Join**: New `teleportOnEveryJoin` option for all player joins - **Combat Cancellation**: `cancelOnDamage` setting to interrupt teleportation during combat - **Respawn Override**: Proper spawn point override using `PlayerRespawnEvent` --- ## ⚙️ Configuration Improvements ### Smart Time Localization - **Custom Time Format**: Configure time units for different numbers - **Multi-language Support**: Easy localization with `localFormat` map - **Flexible Placeholders**: Use `{TIME}` and `{FORMAT}` separately for better control ### Enhanced Documentation - **Comprehensive Headers**: Detailed explanations in configuration files - **Message Type Guide**: Clear documentation for `TITLE`, `CHAT`, `ACTIONBAR`, etc. - **Placeholder Reference**: Complete list of available placeholders --- ## 🔧 Technical Improvements ### Code Quality - **Lombok Integration**: Reduced boilerplate code with automatic getters/setters - **Refactored Listeners**: Extracted common methods for better maintainability - **Improved Error Handling**: Better exception management and logging ### Performance Optimizations - **Efficient Sound Handling**: Optional sound system with minimal overhead - **Optimized Scheduling**: Better task management for teleportation countdown - **Memory Management**: Improved cleanup and resource handling --- ## 🐛 Bug Fixes - **Fixed Respawn Logic**: Proper spawn point override using `PlayerRespawnEvent` - **Improved Combat Detection**: Better damage event handling for teleportation cancellation - **Configuration Validation**: Enhanced config loading with proper error handling - **Thread Safety**: Improved concurrent access handling --- ## 📋 Full Changelog ### Added - `XSound` integration for teleportation audio feedback - `bStats` metrics collection for plugin analytics - `teleportOnEveryJoin` configuration option - `cancelOnDamage` setting for combat interruption - Time localization system with `localFormat` map - Comprehensive configuration documentation - Lombok annotations for cleaner code ### Changed - Switched from `PlayerDeathEvent` to `PlayerRespawnEvent` for proper respawn handling - Refactored `ActionListener` with extracted common methods - Enhanced `messages.yml` with detailed headers and examples - Improved sound configuration with `null`-disable option ### Fixed - Respawn location override now works correctly - Combat damage properly cancels teleportation countdown - Configuration loading errors are handled gracefully - Thread safety improvements for concurrent operations --- ## 🔗 Compatibility - **Minecraft**: `1.18.2+` - **Server Software**: Paper, Spigot, Folia - **Java**: `17+` - **Dependencies**: None required (`XSound` bundled) --- ## 📥 Installation 1. Download the latest version 2. Place in your `plugins/` folder 3. Restart your server 4. Configure in `plugins/KX-Spawn/config.yml` and `messages.yml` --- This update brings significant improvements to user experience with audio feedback, better configuration options, and enhanced code quality. Perfect for servers wanting a polished spawn system with modern features.