{"id":109366,"date":"2026-06-06T13:20:21","date_gmt":"2026-06-06T10:20:21","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/"},"modified":"2026-06-06T13:20:21","modified_gmt":"2026-06-06T10:20:21","slug":"nekolist","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/","title":{"rendered":"NekoList (Whitelist)"},"content":{"rendered":"
\n

# NekoList
\n![License: MIT](https:\/\/opensource.org\/licenses\/MIT)
\n![Modrinth](https:\/\/modrinth.com\/plugin\/nekolist)
\n![GitHub Repo stars](https:\/\/github.com\/hanamuramiyu\/NekoList)<\/p>\n

**A modern whitelist plugin with database support, Folia compatibility, and Discord integration.**<\/p>\n

[\u2003
\ud83c\uddfa\ud83c\uddf8 English (US) [Current]
\u2003<\/kbd>](https:\/\/github.com\/hanamuramiyu\/NekoList\/blob\/main\/README.md) | \u2003
\u2003\ud83c\uddef\ud83c\uddf5 \u65e5\u672c\u8a9e (ja-JP)
\u2003<\/kbd> | \u2003
\u2003\ud83c\udde8\ud83c\uddf3 \u7b80\u4f53\u4e2d\u6587 (zh-CN)
\u2003<\/kbd><\/p>\n<\/div>\n

## \u2728 Features<\/p>\n

### \ud83d\uddc4\ufe0f Database & Storage
\n– **Dual Storage Options**: Use either file-based storage or MySQL\/MariaDB databases
\n– **Automatic Fallback**: Seamlessly switches to file storage if database connection fails
\n– **Data Persistence**: Guaranteed data integrity across server restarts and plugin reloads<\/p>\n

### \u26a1 Performance & Compatibility
\n– **Folia Server Support**: Full compatibility with Folia servers using adaptive schedulers
\n– **Modern Formatting**: MiniMessage support for rich text formatting with `` tags
\n– **Java 21**: Built with the latest Java for optimal performance and security<\/p>\n

### \ud83d\udd10 Security & Management
\n– **UUID-Based Verification**: Advanced player verification using UUIDs with nickname fallback
\n– **Smart Data Sync**: Automatic player data synchronization on login
\n– **Connection Pooling**: Efficient database connections using HikariCP
\n– **Role-Based Permissions**: Granular Discord permission control with user and role whitelists<\/p>\n

—<\/p>\n

## \ud83d\ude80 Installation<\/p>\n

### System Requirements
\n– **Java 21** or higher
\n– **Minecraft 1.21.1** or higher
\n– **Bukkit\/Paper\/Purpur\/Folia** server<\/p>\n

### Installation Steps:
\n1. Download the latest `.jar` file from Modrinth or GitHub Releases
\n2. Place the `.jar` file into your server’s `plugins` folder
\n3. Start or restart your server
\n4. Configure `plugins\/NekoList\/config.yml` as needed<\/p>\n

—<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

### Basic Setup
\n“`yaml
\n# NekoList Configuration v2.0.0
\nlanguage: “en-US”
\n# Available languages: en-US, en-GB, es-ES, es-419, ja-JP, ru-RU, uk-UA, zh-CN, zh-TW<\/p>\n

# Database settings
\ndatabase:
\n type: “file” # “file” or “mysql”
\n mysql:
\n host: “localhost”
\n port: 3306
\n database: “minecraft”
\n username: “username”
\n password: “password”
\n table: “whitelist”
\n use-ssl: false
\n connection-timeout: 30000<\/p>\n

# Discord Bot settings
\ndiscord-bot:
\n enabled: false
\n token: “YOUR_BOT_TOKEN_HERE”
\n allowed-roles: []
\n allowed-users: []
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udd27 Commands & Permissions<\/p>\n

### In-Game Commands (`\/whitelist`)
\n– `\/whitelist help` – Show available commands
\n– `\/whitelist on` – Enable the whitelist
\n– `\/whitelist off` – Disable the whitelist
\n– `\/whitelist list` – List whitelisted players
\n– `\/whitelist add ` – Add a player to whitelist
\n– `\/whitelist remove ` – Remove a player from whitelist
\n– `\/whitelist reload` – Reload configuration<\/p>\n

**Permission Nodes:**
\n– `nekolist.use` – Use whitelist commands
\n– `nekolist.bypass` – Bypass whitelist checks
\n– `nekolist.admin` – Full administrative access<\/p>\n

### Discord Slash Commands
\n– `\/ping` – Check bot latency
\n– `\/whitelist add ` – Add player to whitelist
\n– `\/whitelist remove ` – Remove player from whitelist
\n– `\/whitelist list` – List whitelisted players
\n– `\/whitelist status` – Check whitelist status
\n– `\/whitelist reload` – Reload plugin configuration<\/p>\n

—<\/p>\n

## \ud83d\udea8 Important Notes for v2.0.0<\/p>\n

### \u26a0\ufe0f Breaking Changes
\n1. **Velocity Support Removed**: v2.0.0+ only supports Bukkit, Paper, Purpur, and Folia servers
\n2. **MiniMessage Formatting**: Language files now use `` tags instead of legacy `&` codes
\n4. **Configuration Updates**: Some config options have been restructured<\/p>\n

### \ud83d\udd04 Migration from v1.x
\n1. **Backup your data**: Copy `plugins\/NekoList\/whitelist.yml`
\n2. **Update language files**: Convert `&` codes to MiniMessage format:
\n “`yaml
\n # Old format (v1.x)
\n player-added: “&aPlayer %player% has been added to whitelist.”<\/p>\n

# New format (v2.0.0)
\n player-added: “Player %player% has been added to whitelist.”
\n “`
\n3. **Velocity Users**: Continue using v1.2.1 for Velocity compatibility<\/p>\n

—<\/p>\n

## \ud83c\udf10 Adding New Languages<\/p>\n

1. Navigate to `plugins\/NekoList\/lang\/` directory
\n2. Copy `en-US.yml` as a template
\n3. Rename to your language code (e.g., `fr-FR.yml`, `de-DE.yml`)
\n4. Translate all values using **MiniMessage format** (`` tags)
\n5. Update `language` setting in `config.yml`<\/p>\n

**Example MiniMessage tags:**
\n– `` – Red text
\n– `` – Green text
\n– `` – Yellow text
\n– `` – Gray text
\n– `` – Gold text
\n– `` – **Bold text**<\/p>\n

—<\/p>\n

## \ud83c\udfd7\ufe0f Building from Source<\/p>\n

“`bash
\n# Clone repository
\ngit clone https:\/\/github.com\/hanamuramiyu\/NekoList.git
\ncd NekoList<\/p>\n

# Build plugin
\n.\/gradlew build<\/p>\n

# Output file: build\/libs\/NekoList-2.0.0.jar
\n“`<\/p>\n

**Requirements:**
\n– Java 21 JDK
\n– Gradle 9.2.0+<\/p>\n

—<\/p>\n

## \ud83e\udd1d Contributing<\/p>\n

Contributions are welcome! Please follow these steps:
\n1. Fork the repository
\n2. Create a feature branch
\n3. Make your changes
\n4. Submit a Pull Request<\/p>\n

Please ensure your code follows the existing style and includes appropriate tests.<\/p>\n

—<\/p>\n

## \ud83d\udc1b Issue Reporting<\/p>\n

Found a bug or have a feature request? Please:
\n1. Check existing Issues
\n2. Create a new issue with clear description
\n3. Include server logs and configuration details
\n4. Specify your server type and version<\/p>\n

—<\/p>\n

## \ud83d\udcc4 License<\/p>\n

This project is licensed under the MIT License – see the LICENSE file for details.<\/p>\n

—<\/p>\n

\n

**Made with \u2764\ufe0f by Hanamura Miyu**<\/p>\n

*Looking for Velocity support? Use v1.2.1 for Velocity compatibility.*<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Advanced whitelist management system with Discord integration and multi-language support<\/p>\n","protected":false},"featured_media":109367,"template":"","meta":{"_minecraft_slug":"nekolist","_minecraft_project_id":"MUXv6Dpt","_minecraft_author":"hanamuramiyu","_minecraft_license":"MIT","_minecraft_downloads":937,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nekolist.zip","_minecraft_size_bytes":66208028,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T08:50:41.722304Z","_minecraft_date_created":"2025-11-09T07:59:59.569585Z","_minecraft_date_modified":"2026-01-21T22:02:43.622159Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nekolist","_minecraft_icon_attachment_id":109367,"_minecraft_imported_at":"2026-06-06T10:20:22+00:00","_minecraft_import_hash":"368613bcc48fff87aea8b29a6d17100d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,127,128,867,129,92,985],"mod_loader":[130,131,132,133,134,986],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-109366","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nNekoList (Whitelist) - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NekoList (Whitelist) - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Advanced whitelist management system with Discord integration and multi-language support\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/\",\"name\":\"NekoList (Whitelist) - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp\",\"datePublished\":\"2026-06-06T10:20:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nekolist\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NekoList (Whitelist)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"NekoList (Whitelist) - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/","og_locale":"en_US","og_type":"article","og_title":"NekoList (Whitelist) - Minecraft","og_description":"Advanced whitelist management system with Discord integration and multi-language support","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/","name":"NekoList (Whitelist) - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp","datePublished":"2026-06-06T10:20:21+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nekolist-icon-001022d15f29363a2626ac5a8728ae1fe7d3d0e1_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nekolist\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"NekoList (Whitelist)"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/109366","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/109367"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=109366"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=109366"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=109366"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=109366"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}