Zum Hauptinhalt springen

Region Definition

Protection region definition

Felder

FeldTypStandardBeschreibung
artifactRef<RegionArtifactEntry>—Primary artifact storing runtime data for this region
priorityInt0Priority applied when regions overlap (higher wins)
ownersList<String>emptyUUIDs of players allowed to manage the region
membersList<String>emptyUUIDs of players allowed to interact inside the region
groupsList<Ref<GroupEntry>>emptyGroups synchronized with the region
parentRegionRef<RegionDefinitionEntry>—Optional parent region used for inheritance
flagsList<FlagBinding>emptyFlags applied to the region
FlagBinding (2)
FeldTypStandardBeschreibung
keyRegionFlagKeyBUILD—Werte:BUILDBLOCK_BREAKBLOCK_PLACEUSEINTERACTPVPMOB_DAMAGEMOB_SPAWNINGCREEPER_EXPLOSIONTNTFIRE_SPREADLIGHTNINGENDERMAN_GRIEFGHAST_FIREBALLLAVA_FIRELAVA_FLOWWATER_FLOWICE_MELTSNOW_MELTLEAF_DECAYGRASS_GROWTHVINE_GROWTHENTITY_PAINTING_DESTROYVEHICLE_PLACEVEHICLE_DESTROYENDER_PEARLPOTION_SPLASHEXP_DROPSITEM_PICKUPITEM_DROPENTRYEXITENTRY_ACTIONEXIT_ACTIONPASS_THROUGHINVINCIBLEFALL_DAMAGEHUNGERHEAL_AMOUNTHEAL_DELAYHEAL_MINHEAL_MAXTELEPORTBLOCKED_EFFECTSFLYWALK_SPEEDFLY_SPEEDKEEP_INVENTORYKEEP_EXPCHAT_PREFIXCHAT_SUFFIXGODMODEFROSTWALKERNETHER_PORTALSGLIDECHUNK_UNLOADITEM_DURABILITYJOIN_LOCATIONENTRY_MIN_LEVELENTRY_MAX_LEVEL
valueFlagValue——Varianten:flag_value_actionsflag_value_boolflag_value_colorflag_value_doubleflag_value_intflag_value_listflag_value_locationflag_value_soundflag_value_text
flag_value_actions (1)
FeldTypStandardBeschreibung
actionsList<Ref<ActionEntry>>empty—
flag_value_bool (1)
FeldTypStandardBeschreibung
enabledBooleantrue—
flag_value_color (1)
FeldTypStandardBeschreibung
hexString#FFFFFF—
flag_value_double (1)
FeldTypStandardBeschreibung
valueDouble0.0—
flag_value_int (1)
FeldTypStandardBeschreibung
valueInt0—
flag_value_list (1)
FeldTypStandardBeschreibung
entriesList<String>empty—
flag_value_location (1)
FeldTypStandardBeschreibung
positionPositionORIGIN—
flag_value_sound (3)
FeldTypStandardBeschreibung
soundStringminecraft:block.note_block.pling—
volumeFloat1.0—
pitchFloat1.0—
flag_value_text (1)
FeldTypStandardBeschreibung
contentString——
bluemapSettingsRegionBlueMapDisplaySettings—BlueMap display settings for this region. Enable to show the region on the BlueMap web interface.
RegionBlueMapDisplaySettings (14)
FeldTypStandardBeschreibung
enabledBooleanfalseEnable BlueMap integration for this region
markerSetIdStringprotection_regionsMarker set id for grouping regions on BlueMap. Regions with the same set id are grouped together.
markerSetLabelStringProtection RegionsLabel for the marker set (only used when creating a new marker set)
markerSetToggleableBooleantrueWhether the marker set can be toggled on/off in the BlueMap UI
markerSetDefaultHiddenBooleanfalseWhether the marker set is hidden by default in the BlueMap UI
shapeTypeBlueMapShapeTypeEXTRUDEMarker shape type: EXTRUDE (3D) or SHAPE (flat)Werte:EXTRUDESHAPE
lineColorString#FF0000Line color for the region border (CSS color format: #RRGGBB or #AARRGGBB)
fillColorString#FF000040Fill color for the region area (CSS color format: #RRGGBB or #AARRGGBB)
lineWidthInt2Line width in pixels for the region border
depthTestEnabledBooleantrueEnable depth test (hide marker when behind terrain)
minYDouble-64.0Minimum Y height for extruded markers
maxYDouble320.0Maximum Y height for extruded markers
labelTemplateString{name}Label template for the marker. Placeholders: {name}, {id}, {priority}
sortingInt0Sorting order for this marker within its set (lower = first)

How to use it​

A region exists as soon as its definition is published. The shape comes from the linked artifact: without an artifact, or before you apply a selection, the region covers nothing.

  • priority orders overlapping regions: higher first. A child with priority 0 takes the priority of its parent.
  • owners and members are player UUIDs. They, and players with typewriter.protection.bypass, ignore every flag of the region.
  • parentRegion lets the region inherit flags, owners and members of another region. Circular parents are ignored with a warning in the log.
  • flags is a list of key and value pairs. Booleans set to false deny the action. Several keys are not enforced: see the Flags section of the extension page.
  • groups is stored for information (placeholders) and is not used for enforcement.
  • bluemapSettings draws the region on BlueMap when enabled is on.