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)