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.