Region Quotas

The built-in Quotas feature lets you set limits for the total number of regions a player can own and their size in blocks. These limits apply automatically based on a player's rank or permissions.

There are two quotas available: Regions Amount and Blocks per Region.

Quota Description
Regions Amount This limit sets the maximum number of regions a player can create.
Blocks per Region This limit restricts the total number of blocks a single region can have.

Configuration

You can change quota settings in the module config file under the Limits section.

You can set limits using one of two operation modes:

  • Rank Mode: Set Mode: RANK to assign limits based on a player's permission group. The keys in the Values section are the exact permission group names (e.g., vip, premium).
  • Permission Mode: Set Mode: PERMISSION to assign limits based on specific player permissions. The keys in the Values section act as suffixes attached to the Permission_Prefix setting.
  • Default Values: In either mode, if a player does not have the specified rank or permission, the Default_Value applies.
  • Unlimited Quotas: Use a value of -1 to give an unlimited amount of regions or blocks.
  • Region-Size-3D-Validation: Whether region size caluclates in 3-dimensions instead of 2D.

Example Configuration:

Limits:
  # Controls how many region claims a player can create.
  Max-Regions-Per-Player:
    Mode: RANK # Looks up player ranks.
    Permission_Prefix: regions.amount.
    Default_Value: 4
    Values:
      owner: -1 # Players with the 'owner' rank get unlimited regions.
      vip: 5
      premium: 7

  Max-Blocks-Per-Player:
    Mode: RANK
    Permission_Prefix: regions.size.
    Default_Value: 20000.0
    Values:
      owner: -1.0 # Players with the 'regions.size.owner' permission get unlimited blocks.
      vip: 50000.0
      premium: 70000.0

  Region-Size-3D-Validation: true