NekoList (Whitelist)

NekoList v2.0.0 - Major Update with Database Support & Folia Compatibility

The biggest update yet! Complete architectural overhaul with database support, Folia compatibility, and enhanced performance.

🔥 What's New

Database Support:

• MySQL/MariaDB Integration: Store whitelist data in external databases
• Smart Fallback: Automatically switches to file storage if database connection fails
• Real-time Sync: Seamless data synchronization across server restarts

Performance & Architecture:

• Folia Compatibility: Full support for Folia servers with adaptive schedulers
• Modular Design: Complete codebase restructuring for better maintainability
• Advanced Caching: Optimized whitelist caching with TTL and smart reloading
• MiniMessage Support: Modern text formatting with <color> tags

Enhanced Reliability:

• Connection Pooling: HikariCP for efficient database connections
• Error Recovery: Graceful fallback mechanisms and detailed logging
• Configuration Validation: Improved config validation with helpful error messages
• Update Checker: Automatic version checking via Modrinth API

Discord Bot Improvements:

• Command Cooldowns: Prevent spam with configurable cooldown system
• Enhanced Validation: Better permission checking and input validation
• Improved Stability: Better error handling and connection management

📋 Features

• Complete Whitelist Management: In-game commands for all operations
• Database Support: MySQL/MariaDB with automatic fallback to files
• Folia Compatibility: Works on Folia servers with adaptive scheduling
• MiniMessage Formatting: Modern <color> tags instead of legacy & codes
• Multi-language Support: 9 languages including EN, ES, JA, RU, ZH
• Permission Integration: Compatible with LuckPerms and other permission systems
• Minecraft 1.21.1+ Support: Updated for latest Minecraft versions
• Metrics Integration: Optional bStats metrics (anonymous usage data)

🚨 Breaking Changes

⚠️ Important Note: Version 2.0.0 introduces breaking changes:

1. Velocity Support Removed: This version supports only Bukkit, Paper, Purpur, and Folia servers
2. MiniMessage Formatting: Language files now use MiniMessage format (<color>) instead of legacy & codes

📥 Installation

For Paper/Purpur/Folia servers:

1. Download the jar file below
2. Place in your server's plugins folder
3. Restart server
4. Configure in plugins/NekoList/config.yml

Database Setup (Optional):

1. Edit plugins/NekoList/config.yml
2. Set database.type: "mysql"
3. Configure your MySQL/MariaDB credentials
4. The plugin will automatically create required tables

🔄 Upgrade Instructions

From v1.x to v2.0.0:

1. Backup your data: Copy plugins/NekoList/whitelist.yml and plugins/NekoList/config.yml
2. Remove old plugin jar
3. Install v2.0.0
4. Manual language file update: Copy old messages from your language files to new format (see example below)

Language File Migration Example:

# Old format (v1.x)
player-added: "&aPlayer %player% has been added to whitelist."

# New format (v2.0.0)
player-added: "<green>Player %player% has been added to whitelist."

📊 System Requirements

• Java 21 or higher
• Minecraft 1.21.x
• Bukkit/Paper/Purpur/Folia server
• MySQL/MariaDB (optional, for database mode)

NekoList v1.2.1 - Stability & Correctness Fixes

This patch release focuses on improving the stability, correctness, and maintainability of the plugin, addressing several issues identified in v1.2.0.

🔧 Fixed

• Critical: Duplicate Class Definitions: Resolved the issue where DiscordBot and DiscordEventListener were incorrectly defined as identical classes. The codebase now correctly separates concerns between the bot instance and its event listeners.
• Enhanced Token Validation: Improved the check for the Discord bot token. The bot will now fail to start cleanly if the token is missing or remains the default placeholder "YOUR_BOT_TOKEN_HERE", preventing unintended attempts to connect with invalid credentials.
• Dependency Cleanup: Removed unnecessary snakeyaml dependency. The plugin now correctly relies on the built-in YAML support provided by Bukkit/Spigot and Velocity APIs, reducing the final JAR size.
• Resource Handling: Corrected the Gradle build script's processResources task. It now correctly includes only .yml files from the resources directory, as these are the only types used by the plugin, removing the redundant .yaml inclusion.
• Removed Unused Dependency: Eliminated the unused compileOnly("net.luckperms:api:5.4") dependency from the build configuration.
• Refined Shadow JAR Exclusions: Updated the shadowJar task to correctly exclude Paper and Velocity API dependencies only when they are included via implementation. The existing compileOnly declarations already handle this correctly for the target platforms.
• Documentation Accuracy: Corrected instructions in the README regarding building from source (./gradlew build) and clarified platform-specific sections (Paper/Forks, Velocity/Forks).
• Translation Consistency: Updated the "ping" command response translation placeholders in the example configuration and language files to ensure consistency (e.g., "¡Pong!" in Spanish is now correctly "¡Ping!").

🏗️ Internal Improvements

• Code Structure: Refactored internal structures to ensure better separation of logic between core plugin, Bukkit module, and Velocity module.
• Build Process: Streamlined the Gradle build process for clarity and efficiency.
• Maintainability: Addressed structural issues that could lead to confusion or errors in future development.

Advanced whitelist management system with UUID support and enhanced reliability!

What's New in v1.2.0:

• UUID-Based Whitelist System: Advanced player verification for licensed servers
• Nickname Change Protection: Players stay whitelisted even after changing names
• Enhanced Data Reliability: Guaranteed data integrity across plugin reloads
• Universal Compatibility: Works seamlessly across all server types

UUID System Features:

• Smart Verification: Checks UUID first, falls back to nickname for compatibility
• Automatic Updates: Real-time synchronization of player data on login
• Migration Support: Automatic upgrade from legacy nickname-only entries
• Mode Awareness: Different behavior for licensed vs offline servers

Licensed Servers (online-mode=true):

• Players remain whitelisted after nickname changes
• Protection against nickname spoofing
• Automatic UUID registration on first join

Offline Servers (online-mode=false):

• Classic nickname-based verification
• Full backward compatibility
• Simple and predictable behavior

Reliability Improvements:

• Fixed data loss issues during plugin reloads
• Enhanced file handling and error recovery
• Synchronized operations preventing corruption
• Robust configuration parsing

Features:

• Complete whitelist management with in-game commands
• Discord bot integration with modern slash commands
• Multi-language support (13 languages)
• Cross-platform compatibility (Bukkit/Paper/Velocity)
• Permission system compatibility
• Minecraft 1.21.x support

Installation:

For Bukkit/Paper servers:

1. Download the jar file below
2. Place in your server's plugins folder
3. Restart server
4. Configure in plugins/NekoList/config.yml

For Velocity proxy:

1. Download the jar file below
2. Place in Velocity's plugins folder
3. Restart proxy
4. Configure in plugins/NekoList/config.yml

Upgrade Note: This version maintains full compatibility with previous configurations. Existing whitelists will be automatically upgraded to the new format.

Advanced whitelist management system for Minecraft servers with Discord integration - now with major performance improvements!

What's New in v1.1.1:

• Major Performance Boost: In-memory whitelist caching for instant player checks
• Code Architecture Overhaul: Simplified and optimized plugin structure
• Enhanced Discord Bot: Better configuration validation and localization
• Improved Reliability: Fixed reload functionality and permission systems

Performance Improvements:

• Whitelist checks now happen in memory (100x faster)
• Eliminated disk I/O during player login events
• Optimized configuration reloading
• Better resource management

Bug Fixes:

• Fixed Discord bot permission validation
• Resolved language file loading issues
• Corrected Velocity reload commands
• Improved configuration error handling

Features:

• Complete whitelist management with in-game commands
• Discord bot integration with modern slash commands
• Multi-language support (13 languages)
• Cross-platform compatibility (Bukkit/Paper/Velocity)
• Permission system compatibility
• Minecraft 1.21.x support

Installation:

For Bukkit/Paper servers:

1. Download the jar file below
2. Place in your server's plugins folder
3. Restart server
4. Configure in plugins/NekoList/config.yml

For Velocity proxy:

1. Download the jar file below
2. Place in Velocity's plugins folder
3. Restart proxy
4. Configure in plugins/NekoList/config.yml

Upgrade Note: This version maintains full compatibility with v1.1.0 configurations.

Advanced whitelist management system for Minecraft servers with Discord integration - now with Velocity support!

New in v1.1.0:

• Full Velocity proxy compatibility
• Support for Bukkit, Spigot, Paper, Purpur, and Velocity
• Cross-platform configuration system
• Automatic platform detection

Features:

• Complete whitelist management with in-game commands
• Discord bot integration with modern slash commands
• Multi-language support (13 languages)
• Permission system compatibility
• Works with both standalone servers and proxy networks
• Minecraft 1.21.x support

Installation:

For Bukkit/Paper servers:

1. Download the jar file below
2. Place in your server's plugins folder
3. Restart server
4. Configure in plugins/NekoList/config.yml

For Velocity proxy:

1. Download the jar file below
2. Place in Velocity's plugins folder
3. Restart proxy
4. Configure in plugins/NekoList/config.yml