Flags & roles

Flags versus roles

A role (access level) decides what one player may do inside a realm — build, use containers, fight, and so on — through the rights in roles.yml. A flag decides what the realm allows at all, for everyone inside it. The two stack: hitting another player needs both the realm’s pvp flag on and the attacker’s damage-players right held. Either one missing refuses the hit.

The flags

An owner toggles these from the Flags menu (/realm flags or Settings → Flags). An admin can set any of them directly with /realm admin flag <player> <flag> <true|false>, which ignores realm.locked-flags.

Flag	Default	What it allows
`pvp`	`false`	Members hurting each other. A visitor still cannot fight, whatever this says, unless `roles.yml` grants them `damage-players`.
`tnt-explosion`	`true`	TNT explosions breaking blocks.
`creeper-explosion`	`true`	Creeper explosions breaking blocks.
`fire-spread`	`true`	Fire spreading to the block beside it and burning blocks away.
`lava-flow`	`true`	Lava flowing and destroying what it touches.
`water-flow`	`true`	Water flowing.
`enderman-grief`	`true`	An enderman picking a block up.
`mob-griefing`	`true`	Every other mob changing a block — a zombie on a door, a sheep on grass, a ravager.
`crop-trample`	`true`	Walking on farmland turning it back to dirt.
`natural-monster-spawn`	`false`	Mobs the world spawns on its own. A spawner is somebody asking for it, so it has its own flag below.
`natural-animal-spawn`	`true`	Animals the world spawns on its own.
`spawner-spawn`	`true`	Mobs a spawner (or trial spawner) produces.
`fall-damage`	`true`	Fall damage inside the realm.
`keep-inventory`	`false`	Keeping inventory and experience on death inside the realm.
`always-day`	`false`	Locks the sky to day for anyone inside. Beats `always-night` when both are on.
`always-night`	`false`	Locks the sky to night.
`always-rain`	`false`	Locks the weather to rain. Beats `always-clear` when both are on.
`always-clear`	`false`	Locks the weather to clear.
`visitor-item-pickup`	`true`	A player who is neither member nor owner picking items up off the ground.

Locked flags

realm:
  locked-flags:
    - keep-inventory
    - pvp

A flag named in realm.locked-flags still holds whatever value realm.flags gives it — only the owner’s switch to change it is taken away. The Flags menu shows it as locked instead of hiding it.

How overrides persist

config.yml’s realm.flags section is what a new realm is worth on the day it is made. From then on, a realm only stores the flags its owner has actually changed — the rest follow config.yml live. Editing a default in config.yml therefore moves every realm that has never touched that flag, without touching the realms that have.

/realm admin reload re-reads realm.flags and realm.locked-flags live, with no restart.