Skip to main content

Concept overview

Introduction to concepts here....

Regions​

There are three different types of regions to protect your server:

  • Local Regions: Also known as Claims or Plots are area restricted zones in your world. The area of a region can be defined using a Cuboid or Sphere. More info here ➡️
  • Dimensional Regions: Dimensional Regions have no area restrictions. They work like Local Regions, but are tied to a whole dimension. More info here ➡️
  • The Global Region: The Global Region affects the whole server. It is the parent region to all Dimensional Regions. More info here ➡️

Region Quick Tips​

  • Flags can be added to regions to prevent various actions and events.
  • Regions can have groups to manage permissions. There are currently two default groups : owners, members.
  • You are able to assign vanilla teams and/or specific players to a group.
  • Regions can be de/-activated. The same is true for their flag alerts.
  • Local Regions have a priority to manage overlapping regions and region hierarchy. More info about region hierarchy here ➡️
  • Dimensional Regions can't be created manually. They are in fact automatically generated with each new dimension.

Flags​

Flags are essential rules you can add to regions to prevent or allow specific actions/events/etc. Take a look at the Flags page for more details about flag management.

Looking for a list of all available flags? Take a look here ➡️

If you have a suggestion for new flags feel free to add it to the suggestion list on GitHub or share your idea in the #suggestions channel on discord.

Flag Quick Tips​

  • A flag has an alert message which is displayed when its action is denied and player triggers the flag.
  • You can customize the message displayed by the flag alert (including turning it off).
  • A flag has a flag state. There are three: Denied, Allowed or Disabled.
    • set the flag state to Denied to prevent the action associated with the flag.
    • set the flag state to Allowed to allow the action associated with the flag.
    • set the flag state to Disabled to not consider the flag in checks.
  • You can add flags with
    • /yawp local <dim> <region> add flag <flag> for Local Regions
    • /yawp dim <dim> add flag <flag> for Dimensional Regions
    • /yawp global add flag <flag> for the Global Region
  • You can optionally define the flag state when adding flags:
    • /yawp local <dim> <region> add flag <flag> [flagstate].
    • by default the flag state is set to Denied
  • Manage the properties of flags by using
    • /yawp flag local <dim> <region> <flag> ... for Local Regions
    • /yawp flag dim <dim> <flag> ... for Dimensional Regions
    • /yawp flag global <flag> ... for the Global Region

Groups​

Regions can have owners and normal members. Owners are allowed to manage the region and bypass the flags, members are only allowed to bypass the flags set in the region.

Owners/Members can be individual players or a team.

This allows you to create regions and assign players as their owners. They can then manage their regions themselves and add other players to them, as well as create their own sub-regions within their regions.

Groups Quick Tips​

  • Regions can have groups to manage permissions. There are currently two default groups : owners, members.
  • You are able to assign vanilla teams and/or specific players to a group.
  • Owners and members bypass flags.
  • Owners are allowed to manage their region (use commands)
  • The config setting hierarchy_ownership allows owners and members to have permissions for child regions as well.
  • Groups will be customizable in the future - stay tuned!