Installation
This guide walks you through installing and initializing NookureStaff on your backend game servers and proxy gateways.
System Requirements
Section titled “System Requirements”- Java Runtime: Java 25 (source and bytecode compatibility require Java 25).
- Backend Server Platform:
- Paper 1.21+ (or modern forks maintaining Paper’s modern plugin loader).
NookureStaff relies on Paper’s modern
StaffPaperPluginLoader,paper-plugin.yml,AsyncChatEvent, and async scheduler contracts. Standard Spigot or CraftBukkit servers cannot load this plugin.
- Proxy Gateway (Optional for Networks):
- Velocity 3.4.0+
BungeeCord is not supported. For network deployments, use Velocity.
- Database Backend:
- SQLite: Supported for single, standalone Paper servers.
- MySQL / MariaDB: Required for multi-server networks and Velocity proxy enforcement.
Installation Steps
Section titled “Installation Steps”- Ensure your server is running with Java 25.
- Download the latest
NookureStaff-Paper-xxx.jar. - Place the JAR file into your server’s
plugins/directory. - Start or restart the server. NookureStaff will generate its default folder at
plugins/NookureStaff/. - Configure your settings in
plugins/NookureStaff/config.yml. - Grant the wildcard permission
nookure.staff.*to your administrator account (ornookure.staff.adminfor/nkstaffmanagement commands).
- Database Setup: Create a shared MySQL or MariaDB database accessible by both your Velocity proxy and all Paper backend instances.
- Velocity Proxy:
- Place
NookureStaff-Velocity-xxx.jarinto your proxy’splugins/directory. - Start the proxy to generate
plugins/nookurestaff/velocity.yml. - Configure your MySQL database credentials in
velocity.yml.
- Place
- Paper Backends:
- Place
NookureStaff-Paper-xxx.jarinto each Paper server’splugins/folder. - In
plugins/NookureStaff/config.yml, configure thedatabasesection to connect to the same shared MySQL database. - Set a unique
serverNamefor each backend server (e.g.,survival-1,lobby).
- Place
- Network Messenger:
- In
plugins/NookureStaff/messenger.yml, configure your synchronization bus (REDIS,PMfor Velocity Plugin Messaging, orMYSQL). See the Choosing a Messenger guide to pick the best option for your network.
- In
- Restart your proxy and backend servers.
Verifying Installation
Section titled “Verifying Installation”Join your server in-game and run:
/staffMake sure your account has the required permissions (nookure.staff and nookure.staff.mode). If the plugin is installed and configured properly, you will enter Staff Mode and receive your configured staff hotbar items.