Troubleshooting

The plugin does not load

Check the console for errors. Common causes:

Wrong Java version. Reward Pro requires Java 8 or newer. Run java -version to check.
Server version not supported. Reward Pro supports Spigot and Paper 1.8.8 and newer. Pure CraftBukkit is not supported.
Conflicting plugin. If another plugin loads a conflicting library, check the full stacktrace.

The connect link does not work

Link expired. Connection links expire after 10 minutes. Run /rewardpro connect again.
Already used. Each link can only be used once. Run /rewardpro connect to generate a fresh one.
Not logged in. You must be logged in to your Eland Games account on the website to accept the connection.

Cloud config is not loading

Run /rewardpro reload and check the console for a [Reward Pro Cloud] message. Common issues:

Console message	Cause	Fix
`cloud.token is not set`	No token in config.yml	Run `/rewardpro connect`
`cloud.token format is invalid`	Token is malformed	Delete the token line and run `/rewardpro connect` again
`Unauthorized`	Token is invalid or revoked	Reconnect via `/rewardpro connect`
`IP not allowed`	Server IP not whitelisted	Add your server IP at elandgames.com/profile/settings
`Rate limited`	Too many requests	Wait 60 seconds and try again
`Fetch error: ...`	Network issue	Check your server’s outbound internet access

Rewards GUI is empty after reload

This means the cloud config was fetched but contained no GUI data. Go to the web editor , add at least one slot to your reward GUI, save, then run /rewardpro reload.

MySQL connection fails on startup

Check the console for a Failed to initialise player storage message. Verify:

The database exists on your MySQL server
The username and password are correct
The MySQL server allows connections from your Minecraft server’s IP
If use-ssl: true is set, make sure your MySQL server has SSL configured, or set use-ssl: false for local development

NPC presenter does not appear

Citizens must be installed and enabled. Run /plugins and confirm Citizens is listed in green.

Still stuck? Join our Discord or open an issue on GitHub and include your full server log from startup.