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

# Placeholders

IslandHologram supports built-in replacements inside `hologram.lines` and optionally resolves PlaceholderAPI placeholders.

## Built-in Hologram Placeholders

| Placeholder     | Description                                                |
| --------------- | ---------------------------------------------------------- |
| `%owner%`       | Island owner's name.                                       |
| `%island_name%` | Island custom name, or a fallback based on the owner name. |
| `%level%`       | Island level from SuperiorSkyblock2.                       |
| `%members%`     | Total island members including the owner.                  |

```yaml
hologram:
  lines:
    - '&7Owner: &#45cdf9%owner%'
    - '&7Island: &#FFD700%island_name%'
    - '&7Level: &#a1eafb%level%'
    - '&7Members: &#FFD700%members%'
```

## PlaceholderAPI

If PlaceholderAPI is installed, IslandHologram resolves PlaceholderAPI placeholders in hologram lines.

```yaml
hologram:
  lines:
    - '&7Level: &#a1eafb%superior_island_level_format%'
    - '&7Bank: &#a1eafb%superior_island_bank%$'
    - '&7Biome: &#FFD700%superior_island_biome%'
```

The plugin also provides this PlaceholderAPI placeholder:

| Placeholder            | Description                                                                       |
| ---------------------- | --------------------------------------------------------------------------------- |
| `%islandholo_enabled%` | Returns the configured enabled or disabled text for the player's island hologram. |

The output values are configured here:

```yaml
placeholders:
  enabled-yes: "yes"
  enabled-no: "no"
```

## Offline Owner Behavior

IslandHologram uses island data directly for important SuperiorSkyblock2 values when the owner is offline.

This prevents holograms from becoming empty when the owner leaves the server. The plugin directly handles common values such as island level, bank, biome, size, and team limit before PlaceholderAPI is called.

## Colors

Hologram lines support:

```
&a
&l
&#FC7A00
```

DecentHolograms processes color codes in hologram lines. Messages from `messages.*` also support `&` and `&#RRGGBB`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://advion.gitbook.io/advion-docs/placeholders.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.