FAQ & Troubleshooting

The plugin does not load

Symptom: Console shows UnsupportedClassVersionError or the plugin simply does not appear in /plugins.

Fix: You are running a Java version below 21. LandRealms requires Java 21. Upgrade your JDK, then restart the server.

realm create says I already have a realm

Each player is limited to one realm. Delete your existing realm with /realm delete before creating a new one.

Players cannot join my realm

Check the following:

1. The player has the landrealms.command.join permission.
2. Your realm is not set to private (or they are on your member list).
3. Your realm’s max-players limit has not been reached.

The realm world failed to delete

If you see NoSuchFileException in the console during deletion, update to v1.1.0 or later, which fixes the world unload sequence before cleanup.

MySQL connection refused

Verify:

• database.type is set to MySQL in config.yml.
• The host, port, username, and password are correct.
• The MySQL user has CREATE, INSERT, SELECT, UPDATE, DELETE privileges on the target database.
• Your server firewall allows the connection.

/realm reload does not apply my changes

Confirm you saved the file before running the command. If the issue persists, check the console for YAML parse errors — an invalid config.yml is silently ignored.

How do I give all players realm access?

Grant the default player group the base permissions via LuckPerms:

lp group default permission set landrealms.command.create true
lp group default permission set landrealms.command.join true
lp group default permission set landrealms.command.leave true
lp group default permission set landrealms.command.home true

Something else is broken

Open an issue on GitHub  and include:

• Your server software and version (/version)
• Java version (java -version)
• LandRealms version
• The full stack trace from the console