NekoX

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!