roles.yml

roles.yml is optional. Delete it and AtlasRealms falls back to its built-in defaults — the table below. A key you leave out keeps its default too. /realm admin reload reads the file again, live, with no restart needed.

Access levels

Every player standing in a realm holds one of four access levels:

Level	Who
Visitor	Anybody who is not a member of the realm.
Resident Member	Invited to build, not to open the owner’s storage.
Trusted Member	Invited to everything.
Owner	Not listed in roles.yml and cannot be changed — the owner always holds every right in their own realm.

Rights

Each level holds a set of rights. A right is a single kind of action:

Right	What it covers
build	Breaking and placing blocks, buckets, flint and steel, and walking on a crop (which destroys it).
containers	Anything that holds items: chests, barrels, hoppers, furnaces, brewing stands, shulker boxes.
interact-blocks	Doors, trapdoors, gates, buttons, levers, pressure plates, repeaters and comparators.
utility-blocks	The workbenches that hold nothing: crafting table, anvil, enchanting table, grindstone, stonecutter, loom, cartography table, smithing table.
damage-entities	Hitting anything that is not a player, including animals, item frames and armour stands.
damage-players	Hitting another player.
ride-entities	Sitting on a horse, a boat, a minecart.
take-from-frames	Taking from or turning an item frame, and dressing an armour stand.

Note

damage-players can only take the right away, never grant it past the realm’s own limits. A realm’s pvp flag has to allow fighting too, and a visitor is refused by default even when pvp is on — grant damage-players to visitors if you want strangers fighting inside the realm. See Flags & roles.

Defaults

visitor:
  interact-blocks: true
  utility-blocks: true
  ride-entities: true

resident:
  build: true
  interact-blocks: true
  utility-blocks: true
  damage-entities: true
  damage-players: true
  ride-entities: true

trusted:
  build: true
  containers: true
  interact-blocks: true
  utility-blocks: true
  damage-entities: true
  damage-players: true
  ride-entities: true
  take-from-frames: true

Right	Visitor	Resident	Trusted	Owner
build		✓	✓	always
containers			✓	always
interact-blocks	✓	✓	✓	always
utility-blocks	✓	✓	✓	always
damage-entities		✓	✓	always
damage-players		✓	✓	always
ride-entities	✓	✓	✓	always
take-from-frames			✓	always