📦 KX-Spawn 1.2 — Changelog

Compare 1.1...1.2 on GitHub

✨ 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.

---

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.