
NekoList (Whitelist)
Advanced whitelist management system with Discord integration and multi-language support
- Загрузки
- 1K
- Подписчики
- 2
- Обновлён
- 21 января 2026 г.
- Лицензия
- MIT
Опубликован 7 ноября 2025 г.
NekoList
A modern whitelist plugin with database support, Folia compatibility, and Discord integration.
🇺🇸 English (US) [Current]
|
🇯🇵 日本語 (ja-JP)
|
🇨🇳 简体中文 (zh-CN)
✨ Features
🗄️ Database & Storage
- Dual Storage Options: Use either file-based storage or MySQL/MariaDB databases
- Automatic Fallback: Seamlessly switches to file storage if database connection fails
- Data Persistence: Guaranteed data integrity across server restarts and plugin reloads
⚡ Performance & Compatibility
- Folia Server Support: Full compatibility with Folia servers using adaptive schedulers
- Modern Formatting: MiniMessage support for rich text formatting with
<color>tags - Java 21: Built with the latest Java for optimal performance and security
🔐 Security & Management
- UUID-Based Verification: Advanced player verification using UUIDs with nickname fallback
- Smart Data Sync: Automatic player data synchronization on login
- Connection Pooling: Efficient database connections using HikariCP
- Role-Based Permissions: Granular Discord permission control with user and role whitelists
🚀 Installation
System Requirements
- Java 21 or higher
- Minecraft 1.21.1 or higher
- Bukkit/Paper/Purpur/Folia server
Installation Steps:
- Download the latest
.jarfile from Modrinth or GitHub Releases - Place the
.jarfile into your server'spluginsfolder - Start or restart your server
- Configure
plugins/NekoList/config.ymlas needed
⚙️ Configuration
Basic Setup
# NekoList Configuration v2.0.0
language: "en-US"
# Available languages: en-US, en-GB, es-ES, es-419, ja-JP, ru-RU, uk-UA, zh-CN, zh-TW
# Database settings
database:
type: "file" # "file" or "mysql"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "username"
password: "password"
table: "whitelist"
use-ssl: false
connection-timeout: 30000
# Discord Bot settings
discord-bot:
enabled: false
token: "YOUR_BOT_TOKEN_HERE"
allowed-roles: []
allowed-users: []
🔧 Commands & Permissions
In-Game Commands (/whitelist)
/whitelist help- Show available commands/whitelist on- Enable the whitelist/whitelist off- Disable the whitelist/whitelist list- List whitelisted players/whitelist add <player>- Add a player to whitelist/whitelist remove <player>- Remove a player from whitelist/whitelist reload- Reload configuration
Permission Nodes:
nekolist.use- Use whitelist commandsnekolist.bypass- Bypass whitelist checksnekolist.admin- Full administrative access
Discord Slash Commands
/ping- Check bot latency/whitelist add <player>- Add player to whitelist/whitelist remove <player>- Remove player from whitelist/whitelist list- List whitelisted players/whitelist status- Check whitelist status/whitelist reload- Reload plugin configuration
🚨 Important Notes for v2.0.0
⚠️ Breaking Changes
- Velocity Support Removed: v2.0.0+ only supports Bukkit, Paper, Purpur, and Folia servers
- MiniMessage Formatting: Language files now use
<color>tags instead of legacy&codes - Configuration Updates: Some config options have been restructured
🔄 Migration from v1.x
- Backup your data: Copy
plugins/NekoList/whitelist.yml - Update language files: Convert
&codes to MiniMessage format:# 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." - Velocity Users: Continue using v1.2.1 for Velocity compatibility
🌐 Adding New Languages
- Navigate to
plugins/NekoList/lang/directory - Copy
en-US.ymlas a template - Rename to your language code (e.g.,
fr-FR.yml,de-DE.yml) - Translate all values using MiniMessage format (
<color>tags) - Update
languagesetting inconfig.yml
Example MiniMessage tags:
<red>- Red text<green>- Green text<yellow>- Yellow text<gray>- Gray text<gold>- Gold text<bold>- Bold text
🏗️ Building from Source
# Clone repository
git clone https://github.com/hanamuramiyu/NekoList.git
cd NekoList
# Build plugin
./gradlew build
# Output file: build/libs/NekoList-2.0.0.jar
Requirements:
- Java 21 JDK
- Gradle 9.2.0+
🤝 Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a Pull Request
Please ensure your code follows the existing style and includes appropriate tests.
🐛 Issue Reporting
Found a bug or have a feature request? Please:
- Check existing Issues
- Create a new issue with clear description
- Include server logs and configuration details
- Specify your server type and version
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Hanamura Miyu
Looking for Velocity support? Use v1.2.1 for Velocity compatibility.
Ченджлог
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 21 января 2026 г.
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:
- Velocity Support Removed: This version supports only Bukkit, Paper, Purpur, and Folia servers
- MiniMessage Formatting: Language files now use MiniMessage format (
<color>) instead of legacy&codes
📥 Installation
For Paper/Purpur/Folia servers:
- Download the jar file below
- Place in your server's
pluginsfolder - Restart server
- Configure in
plugins/NekoList/config.yml
Database Setup (Optional):
- Edit
plugins/NekoList/config.yml - Set
database.type: "mysql" - Configure your MySQL/MariaDB credentials
- The plugin will automatically create required tables
🔄 Upgrade Instructions
From v1.x to v2.0.0:
- Backup your data: Copy
plugins/NekoList/whitelist.ymlandplugins/NekoList/config.yml - Remove old plugin jar
- Install v2.0.0
- 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)
1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 20 декабря 2025 г.
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
DiscordBotandDiscordEventListenerwere 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
snakeyamldependency. 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
processResourcestask. It now correctly includes only.ymlfiles from the resources directory, as these are the only types used by the plugin, removing the redundant.yamlinclusion. - Removed Unused Dependency: Eliminated the unused
compileOnly("net.luckperms:api:5.4")dependency from the build configuration. - Refined Shadow JAR Exclusions: Updated the
shadowJartask to correctly exclude Paper and Velocity API dependencies only when they are included viaimplementation. The existingcompileOnlydeclarations 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.
1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 13 ноября 2025 г.
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:
- Download the jar file below
- Place in your server's
pluginsfolder - Restart server
- Configure in
plugins/NekoList/config.yml
For Velocity proxy:
- Download the jar file below
- Place in Velocity's
pluginsfolder - Restart proxy
- 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.
1.1.1Релиз1.21.9, 1.21.10, 1.21.11 · 9 ноября 2025 г.
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:
- Download the jar file below
- Place in your server's
pluginsfolder - Restart server
- Configure in
plugins/NekoList/config.yml
For Velocity proxy:
- Download the jar file below
- Place in Velocity's
pluginsfolder - Restart proxy
- Configure in
plugins/NekoList/config.yml
Upgrade Note: This version maintains full compatibility with v1.1.0 configurations.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 8 ноября 2025 г.
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:
- Download the jar file below
- Place in your server's
pluginsfolder - Restart server
- Configure in
plugins/NekoList/config.yml
For Velocity proxy:
- Download the jar file below
- Place in Velocity's
pluginsfolder - Restart proxy
- Configure in
plugins/NekoList/config.yml
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 7 ноября 2025 г.
Initial release of NekoList - Advanced Whitelist Management
Features:
- Complete whitelist management system
- Discord bot integration with slash commands
- Multi-language support (13 languages)
- Permission system compatibility
- Real-time player management
Комментарии
Загружаем…