> 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/troubleshooting.md).

# Troubleshooting

This page lists common IslandHologram issues and how to resolve them.

## No Holograms Appear

Check:

1. SuperiorSkyblock2 is installed and enabled.
2. DecentHolograms or FancyHolograms is installed and enabled.
3. `hologram.provider` matches an installed provider, or is set to `AUTO`.
4. The island is registered. For existing islands, run `/isholo migrate`.
5. A player is within `proximity.spawn-radius`.
6. The island owner has not disabled the hologram with `/isholo toggle`.

## Provider Not Found

If the console says no hologram provider was found, install DecentHolograms or FancyHolograms.

Example provider config:

```yaml
hologram:
  provider: AUTO
```

If using a forced provider, make sure the matching plugin is installed:

```yaml
hologram:
  provider: DECENT_HOLOGRAMS
```

## Existing Islands Do Not Show Holograms

Run:

```
/isholo migrate
```

Existing islands are not always registered automatically if they were created before IslandHologram was installed.

## Hologram Becomes Empty When Owner Leaves

Use IslandHologram `2.0.2` or newer.

The plugin includes offline-owner handling for important island values. If a custom PlaceholderAPI placeholder still becomes empty, verify that the PlaceholderAPI expansion supports offline players.

## HEX Colors Do Not Work in Messages

Messages support HEX colors like this:

```yaml
messages:
  plugin-reloaded: "&#FC7A00Plugin reloaded."
```

Use `&#RRGGBB`, not `#RRGGBB`.

After editing `config.yml`, run:

```
/isholo reload
```

## Click Commands Do Not Work

Click commands work only with DecentHolograms.

If you use FancyHolograms, these settings are ignored:

```yaml
hologram:
  commands:
    left-click: "is panel"
    right-click: "is settings"
```

## Reload Did Not Apply Provider Changes

Run:

```
/isholo reload
```

If the selected provider is not installed, the plugin keeps the previous adapter and logs an error.

## Database Errors

If migration or reload reports a database error:

1. Check the server console for the detailed SQLite or HikariCP message.
2. Confirm the server can write to `plugins/IslandHologram`.
3. Stop the server and back up `data.db`.
4. Restart the server and try again.

## Hologram Position Is Wrong

Adjust the offset:

```yaml
hologram:
  offset:
    x: -2.0
    y: 4.5
    z: 0.0
```

For FancyHolograms, a lower `y` value such as `1.5` may look better.


---

# 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/troubleshooting.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.