FAQ

The plugin disabled itself, saying the licence key is empty

Open plugins/AtlasLoader/atlasrealms.yml and paste your key into the license field, then start the server again. See Licensing & activation.

/realm create costs nothing, or a realm I set a price on looks free

Vault, or an economy plugin behind it, is not installed. Without one, every price in config.yml — the create cost, the bank, both upgrade ladders — is off, not free. A realm nobody paid for and a realm you cannot buy look identical from a player’s side. Install Vault and an economy plugin, then run /realm admin status to confirm AtlasRealms found it.

I set realm.layout: grid and it did not take

The grid needs three things at once:

1. realm.world-storage: polar, with PolarPaper 2.1.0 or newer installed and the server on Java 25.
2. A world named in realm.grid.world that is already loaded at startup — AtlasRealms never creates it for you.
3. No realms left over from the world layout. AtlasRealms refuses the switch rather than stranding realms that have no grid square to sit in.

Run /realm admin status — it prints exactly which of these is missing.

AtlasRealms says it cannot enable on this server

That is Folia refusing a layout it cannot support. Folia cannot create or unload a world, so a realm cannot be a world of its own there — set realm.layout: grid and restart. See World storage & layout.

I switched world-storage from polar back to folder and lost realms

That direction is not supported. folder to polar is safe — existing realms keep working as folders. polar to folder is not: realms already saved as blobs become unreachable. Pick a storage backend once and leave it.

/realm admin purge did not delete anything

/realm admin purge only previews what would be removed — it deletes nothing. Run /realm admin purge confirm to actually delete what the preview listed. Both also need realm.purge.after-days above 0; a realm only qualifies once its owner and every member have been away that many days, and a player AtlasRealms has never recorded keeps the realm regardless.

Does AtlasRealms have PlaceholderAPI placeholders?

Yes, since 2.5.0. With PlaceholderAPI installed, AtlasRealms registers the atlasrealms expansion with twelve placeholders — %atlasrealms_has_realm%, %atlasrealms_role% and the rest. They all answer for an offline player. See Placeholders for the full list.

Can another plugin talk to AtlasRealms?

Yes, since 2.5.0. AtlasRealms provides a developer API — AtlasRealmsAPI from Bukkit’s service manager — to read, change and listen to realms. See the Developer API.