# Land Quotas

The built-in Quotas feature lets you set limits for the total number of lands a player can own and the maximum number of chunks each land can have. 
These limits apply automatically based on a player's rank or permissions.

There are two quotas available: **Lands Amount** and **Chunks per Land**.

{.compact}
| Quota | Description |
| ---   | ---         |
| Lands Amount | This limit sets the maximum number of separate lands a player can create. |
| Chunks per Land | This limit restricts the total number of chunks a single land can have. |

---

## :icon-phs-gear: Configuration

You can change quota settings in the [module config](/lands/configuration) 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 lands or chunks.

**Example Configuration:**

```yaml
Limits:
  # Controls how many land claims a player can create.
  Max-Lands-Per-Player:
    Mode: RANK # Looks up player ranks.
    Permission_Prefix: lands.amount.
    Default_Value: 4
    Values:
      owner: -1 # Players with the 'owner' rank get unlimited lands.
      vip: 5
      premium: 7
      
  # Controls the maximum amount of chunks allowed per land.
  Max-Chunks-Per-Land:
    Mode: PERMISSION # Looks up player permissions.
    Permission_Prefix: lands.size.
    Default_Value: 2
    Values:
      owner: -1 # Players with the 'lands.size.owner' permission get unlimited lands.
      vip: 4
      premium: 6

```