Skip to main content
The Region Definition entry (region_definition) is a Manifest entry that defines the template for a protection zone. It specifies the priority, base permissions (flags), and initial management (owners/members) for any region associated with it.

Configuration

ParameterTypeDescription
priorityIntHigher numbers override lower ones in overlapping areas.
artifactRef<RegionArtifact>Link to the artifact storing the physical boundaries.
ownersList<String>UUIDs or names of players with management rights.
membersList<String>UUIDs or names of players with interaction rights.
groupsList<Ref<Group>>Link to TypeWriter groups for batch permission management.
parentRegionRef<RegionDefinition>Optional parent for permission inheritance.
flagsList<FlagBinding>List of protection rules applied to this region.

Flag Bindings

Each flag in the flags list consists of a Key (the rule name) and a Value (the rule setting).

Common Flags

  • build: Controls block placement and breaking.
  • pvp: Toggles combat between players.
  • mob-spawning: Prevents or allows natural mob spawns.
  • tnt: Toggles TNT explosions.
  • use: Controls interaction with buttons, doors, and machinery.

Inheritance Logic

Regions follow a hierarchical evaluation:
  1. Local Flags: Flags defined directly on the region.
  2. Inherited Flags: Flags inherited from a parentRegion.
  3. Global Flags: Flags defined in the GlobalRegionArtifact.
[!TIP] Use the /protection flags <id> command in-game to see exactly which flags are effective and why they might be blocked by inheritance.