NekoX Update Log: 5.0-ProMax+++ → 5.2-ProMax+++

✨ New Features

🐱 Neko Abilities

Climb Ability: Nekos can now climb walls using /climb command
Tail Pulling: Interactive tail pulling feature with /pullthetail command
Stress Response System: Low health automatically triggers stress mode for extra power
Catnip Effects: Catnip gives temporary speed and jump boost
Enhanced Night Vision: Better night vision implementation

💬 Communication & Interaction

Cute Chat System: Neko chat with special prefixes, suffixes, and automatic neko language conversion
Owner System: Nekos can have owners, enabling mutual healing and special interactions
Player Notice System: Toggleable player proximity alerts with /playernotice
Improved Social Interactions: Enhanced pat, love bite, ear scratch, purr, and hiss interactions

🔧 Command Enhancements

New Command: /climb - Toggles wall climbing ability
New Command: /pullthetail - Toggles tail pulling functionality

🌐 Technical Improvements

Multi-Version Support: Compatibility with Minecraft 1.20.4 (Java 17) and 1.21.4 (Java 21)
Maven Profiles: Easy version-specific builds with -Ppaper-1.21.4 flag
Enhanced API: Comprehensive API with custom events (NekoStatusChangeEvent, OwnerRelationshipEvent)
Safe Message Access: Improved message handling with SafeMessageUtils
Better Error Handling: Clear error messages and improved stability

🐛 Bug Fixes

Critical Issues Resolved

Fixed Inconsistent Logging: Resolved mixed Chinese/English messages by using LanguageManager for all logs
Fixed Plugin Initialization: Prioritized LanguageManager initialization to resolve locale issues
Fixed Hardcoded Messages: Removed all hardcoded Chinese messages from English locale
Fixed Missing Translations: Added missing translation keys for database and API components
Fixed Build Errors: Resolved missing Bukkit imports and compilation issues
Fixed Duplicate Logging: Removed redundant logging in PlayerConfigManagerSafe

Other Fixes

Fixed Chat Formatting: Consistent chat prefixes and suffixes
Fixed Permission Issues: Corrected permission defaults and hierarchy
Fixed PlaceholderAPI Integration: Improved compatibility and error handling
Fixed Database Connection: Enhanced database management and connection safety

🔧 Improvements

Core Systems

Refactored Logging System: All messages now use LanguageManager for consistent localization
Optimized Initialization Order: Improved component initialization sequence for reliability
Enhanced Component Management: Better listener and command registration/deregistration
Improved Configuration Handling: Better YAML configuration management

Performance & Reliability

Optimized Database Queries: Improved asynchronous database operations
Better Memory Management: Enhanced resource cleanup on plugin disable
Improved Event Handling: More efficient event processing
Enhanced Error Recovery: Better handling of unexpected errors

User Experience

Consistent Message Formatting: All plugin messages now use consistent prefixes
Better Help System: Enhanced /nekoxhelp command with comprehensive information
Improved Language Switching: Smoother language transitions with /nekox language <locale>
Clearer Status Messages: More descriptive feedback for commands and actions

📚 Documentation

Comprehensive README Update

Complete Feature Documentation: All implemented features now documented
Developer Wiki: Detailed API documentation and development guides
Multi-Version Build Instructions: Version-specific build commands and requirements
Troubleshooting Guide: Common issues and solutions
Usage Examples: Practical examples for server owners and developers
API Usage Guide: Detailed instructions for integrating with NekoX API

🔍 Code Quality

Code Refactoring

Removed Hardcoded Messages: All messages now use language files
Improved Code Structure: Clear initialization flow and better separation of concerns
Enhanced Type Safety: Better type checking in language message handling
Consistent Coding Style: Uniform coding conventions across all components

Architecture Improvements

Better Modularity: Clear separation between different plugin systems
Enhanced Extensibility: Improved API design for easier plugin integration
Improved Dependency Management: Better handling of external dependencies
Enhanced Testing: Improved testability of components

🎯 Compatibility

Server Compatibility

Multi-Version Support: Works with Minecraft 1.20.4 and 1.21.4
Bukkit/Spigot Support: Enhanced compatibility with different server software
PlaceholderAPI Compatibility: Better integration with PlaceholderAPI
Java Version Support: Java 17 for 1.20.4, Java 21 for 1.21.4

Plugin Compatibility

Improved API: Better integration with other plugins
Custom Events: More comprehensive event system for plugin interaction
Dependency Management: Better handling of required dependencies

📋 Full Feature List Comparison

New Features Added in 5.2-ProMax+++

Feature	Description	Command
Wall Climbing	Nekos can climb walls	`/climb`
Tail Pulling	Interactive tail pulling	`/pullthetail`
Placeholder List	View all available placeholders	`/nekox placeholders`
Stress Response	Low health power boost	Automatic
Catnip Effects	Temporary speed and jump boost	Consuming catnip
Player Notice System	Proximity alerts	`/playernotice`
Enhanced Owner System	Mutual healing and interactions	`/owner` commands
Multi-Version Support	1.20.4 and 1.21.4 compatibility	-
Improved API	Custom events and methods	Plugin integration

Enhanced Features

Feature	Improvements
Language System	Safe message access, better fallback
Command System	Better localization, error handling
Logging System	Consistent prefixes, no hardcoded messages
Database Management	Improved safety and error handling
PlaceholderAPI	Better compatibility and status display

This update focuses on resolving critical localization issues, improving plugin stability, and adding numerous new features while maintaining full compatibility with existing functionality. The plugin now offers a more comprehensive and polished catgirl experience for Minecraft servers!

NekoX

NekoX 5.2-ProMax+++