> For the complete documentation index, see [llms.txt](https://spacewservices.gitbook.io/ampland/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spacewservices.gitbook.io/ampland/documentation/getting-started/placeholders.md).

# Placeholders

#### Placeholders

Prefix: `%AmplProtections_<placeholder>%`

**General player info**

| Placeholder                    | Description                                | Example               |
| ------------------------------ | ------------------------------------------ | --------------------- |
| `%AmplProtections_total%`      | Total protections owned by the player      | `3`                   |
| `%AmplProtections_limit%`      | Maximum protections allowed for the player | `5`                   |
| `%AmplProtections_land_count%` | Same as total, number of protections       | `3`                   |
| `%AmplProtections_land_ids%`   | Comma-separated list of protection IDs     | `LAND1, LAND2, LAND3` |

**Per-type limits**

| Placeholder                           | Description                              | Example                                             |
| ------------------------------------- | ---------------------------------------- | --------------------------------------------------- |
| `%AmplProtections_limit_<type>%`      | Limit of protections for a specific type | `%AmplProtections_limit_carbon_protector%` → `3`    |
| `%AmplProtections_type_count_<type>%` | Number of protections of a type owned    | `%AmplProtections_type_count_iron_protector%` → `2` |

**Current protection (requires online player)**

| Placeholder                         | Description                                    | Example             |
| ----------------------------------- | ---------------------------------------------- | ------------------- |
| `%AmplProtections_current_land%`    | ID of the protection the player is standing in | `LAND5`             |
| `%AmplProtections_current_owner%`   | Owner name of the current protection           | `Steve`             |
| `%AmplProtections_current_type%`    | Type of the current protection                 | `DIAMOND PROTECTOR` |
| `%AmplProtections_current_size%`    | Size of the current protection                 | `11x11`             |
| `%AmplProtections_current_world%`   | World of the current protection                | `world`             |
| `%AmplProtections_current_x%`       | Center X coordinate                            | `100`               |
| `%AmplProtections_current_y%`       | Center Y coordinate                            | `64`                |
| `%AmplProtections_current_z%`       | Center Z coordinate                            | `-200`              |
| `%AmplProtections_current_members%` | Number of members in the current protection    | `4`                 |
| `%AmplProtections_current_rank%`    | Player's rank in the current protection        | `Administrator`     |

***

#### 2. Hologram (config.yml → holograms.content)

Available placeholders for `holograms.content`:

| Placeholder        | Description                     | Example             |
| ------------------ | ------------------------------- | ------------------- |
| `%owner%`          | Owner name                      | `Steve`             |
| `%size%`           | Protection size                 | `11x11`             |
| `%members%`        | Total members (including owner) | `5`                 |
| `%members_online%` | Online members                  | `3`                 |
| `%land_id%`        | Protection ID                   | `LAND5`             |
| `%type%`           | Protection type                 | `diamond_protector` |
| `%x%`              | Center X coordinate             | `100`               |
| `%y%`              | Center Y coordinate             | `64`                |
| `%z%`              | Center Z coordinate             | `-200`              |

Config example:

```yaml
holograms:
  content: "<white>%owner%</white> | <gray>%size%</gray> | <green>%members_online%/%members% online</green>"
```

***

#### 3. Buy Commands (config.yml → buy-commands)

Available placeholders for purchase commands:

| Placeholder | Description        | Example            |
| ----------- | ------------------ | ------------------ |
| `%player%`  | Player name        | `Steve`            |
| `%type%`    | Protection type ID | `carbon_protector` |
| `%price%`   | Protection price   | `100.0`            |
| `%size%`    | Protection size    | `11x11`            |
| `%radius%`  | Protection radius  | `5`                |

Special prefixes:

* `player: <command>` → Executes the command as the player
* `console: <command>` → Executes the command from the console
* No prefix → Executes from the console (default)

Example:

```yaml
buy-commands:
  carbon_protector:
    - "console: say %player% bought a Carbon Protector"
    - "player: eco give %player% 10"
```

***

#### 4. System messages (lang/en.yml / lang/es.yml)

**Section `general`**

| Key                         | Placeholders |
| --------------------------- | ------------ |
| `general.no-permission`     | `%prefix%`   |
| `general.only-players`      | `%prefix%`   |
| `general.reload-success`    | `%prefix%`   |
| `general.player-not-found`  | `%prefix%`   |
| `general.not-in-protection` | `%prefix%`   |

**Section `admin`**

| Key                        | Placeholders                        |
| -------------------------- | ----------------------------------- |
| `admin.world-disabled`     | `%prefix%`                          |
| `admin.limit-reached`      | `%prefix%`                          |
| `admin.limit-reached-type` | `%prefix%`, `%type%`, `%limit%`     |
| `admin.collision-error`    | `%prefix%`                          |
| `admin.delete-success`     | `%prefix%`, `%owner%`, `%x%`, `%z%` |
| `admin.not-owner`          | `%prefix%`                          |
| `admin.give-success`       | `%prefix%`, `%type%`, `%player%`    |
| `admin.type-not-found`     | `%prefix%`, `%type%`                |
| `admin.info-no-region`     | `%prefix%`                          |
| `admin.delete-no-region`   | `%prefix%`                          |
| `admin.delete-done`        | `%prefix%`                          |
| `admin.give-usage`         | `%prefix%`                          |

**Section `protection`**

| Key                  | Placeholders          |
| -------------------- | --------------------- |
| `protection.created` | `%prefix%`, `%size%`  |
| `protection.removed` | `%prefix%`            |
| `protection.enter`   | `%prefix%`, `%owner%` |
| `protection.leave`   | `%prefix%`, `%owner%` |

**Section `info`**

| Key                  | Placeholders              |
| -------------------- | ------------------------- |
| `info.land-id`       | `%land%`                  |
| `info.owner`         | `%owner%`                 |
| `info.type`          | `%type%`                  |
| `info.size`          | `%size%`                  |
| `info.center`        | `%x%`, `%y%`, `%z%`       |
| `info.members-title` | `%count%`                 |
| `info.member-entry`  | `%name%`, `%rank%`        |
| `info.flags-summary` | `%enabled%`, `%disabled%` |

**Section `members`**

| Key                                 | Placeholders           |
| ----------------------------------- | ---------------------- |
| `members.added`                     | `%prefix%`, `%member%` |
| `members.removed`                   | `%prefix%`, `%member%` |
| `members.promoted`                  | `%prefix%`, `%member%` |
| `members.promoted-secondary`        | `%prefix%`, `%member%` |
| `members.demoted`                   | `%prefix%`, `%member%` |
| `members.demoted-to-admin`          | `%prefix%`, `%member%` |
| `members.notify-removed`            | `%prefix%`, `%owner%`  |
| `members.notify-promoted`           | `%prefix%`, `%owner%`  |
| `members.notify-promoted-secondary` | `%prefix%`, `%owner%`  |
| `members.notify-demoted`            | `%prefix%`, `%owner%`  |
| `members.already-member`            | `%prefix%`, `%member%` |
| `members.not-member`                | `%prefix%`, `%member%` |
| `members.is-owner`                  | `%prefix%`, `%member%` |
| `members.promote-already-max`       | `%prefix%`, `%member%` |
| `members.demote-already-min`        | `%prefix%`, `%member%` |
| `members.list-header`               | `%protection%`         |
| `members.list-entry`                | `%name%`, `%rank%`     |

**Section `commands`**

| Key                     | Placeholders                              |
| ----------------------- | ----------------------------------------- |
| `commands.flag-updated` | `%prefix%`, `%flag%`, `%value%`           |
| `commands.flag-changed` | `%prefix%`, `%flag%`, `%level%`, `%mode%` |
| `commands.lore-updated` | `%prefix%`                                |

**Section `economy`**

| Key                          | Placeholders            |
| ---------------------------- | ----------------------- |
| `economy.insufficient-funds` | `%prefix%`, `%amount%`  |
| `economy.charged`            | `%prefix%`, `%amount%`  |
| `economy.refunded`           | `%prefix%`, `%amount%`  |
| `economy.balance`            | `%prefix%`, `%balance%` |

**Section `buy`**

| Key                    | Placeholders                    |
| ---------------------- | ------------------------------- |
| `buy.purchase-success` | `%prefix%`, `%type%`, `%price%` |
| `buy.purchase-failed`  | `%prefix%`                      |
| `buy.item-dropped`     | `%prefix%`                      |
| `buy.item-lore-price`  | `%price%`                       |
| `buy.item-lore-size`   | `%size%`                        |
| `buy.item-lore-radius` | `%radius%`                      |

**Section `teleport`**

| Key                   | Placeholders            |
| --------------------- | ----------------------- |
| `teleport.cooldown`   | `%prefix%`, `%seconds%` |
| `teleport.teleported` | `%prefix%`, `%region%`  |

**Section `merge`**

| Key                         | Placeholders                                         |
| --------------------------- | ---------------------------------------------------- |
| `merge.merge-success`       | `%prefix%`, `%size%`                                 |
| `merge.merge-cost`          | `%prefix%`, `%amount%`                               |
| `merge.max-tier-reached`    | `%prefix%`, `%type%`                                 |
| `merge.tier-limit-exceeded` | `%prefix%`, `%count%`, `%radius%`, `%max%`, `%type%` |

**Section `hologram`**

| Key                      | Placeholders |
| ------------------------ | ------------ |
| `hologram.toggled-on`    | `%prefix%`   |
| `hologram.toggled-off`   | `%prefix%`   |
| `hologram.no-permission` | `%prefix%`   |

**Section `preset`**

| Key                     | Placeholders           |
| ----------------------- | ---------------------- |
| `preset.applied`        | `%prefix%`, `%preset%` |
| `preset.create-success` | `%prefix%`, `%name%`   |
| `preset.delete-success` | `%prefix%`, `%name%`   |

**Section `rental`**

| Key                         | Placeholders                     |
| --------------------------- | -------------------------------- |
| `rental.insufficient-funds` | `%prefix%`, `%amount%`           |
| `rental.set-success`        | `%prefix%`, `%price%`, `%days%`  |
| `rental.accept-success`     | `%prefix%`, `%name%`, `%days%`   |
| `rental.notify-owner`       | `%prefix%`, `%renter%`, `%name%` |
| `rental.auto-renewed`       | `%prefix%`, `%name%`             |
| `rental.expired`            | `%prefix%`, `%name%`             |

**Section `rollback`**

| Key                | Placeholders          |
| ------------------ | --------------------- |
| `rollback.success` | `%prefix%`, `%count%` |

**Section `search`**

| Key                 | Placeholders                      |
| ------------------- | --------------------------------- |
| `search.found`      | `%prefix%`, `%player%`, `%count%` |
| `search.teleported` | `%prefix%`, `%region%`            |

**Section `access-denied`**

| Key                              | Placeholders |
| -------------------------------- | ------------ |
| `access-denied.default`          | `%prefix%`   |
| `access-denied.protection-block` | `%prefix%`   |
| All other flags                  | `%prefix%`   |

{% content-ref url="/pages/fb922e107b31a3e9e9fcf81410029e993b0a9afc" %}
[Permissions](/ampland/documentation/core-concepts/permissions.md)
{% endcontent-ref %}