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

# Admin Guide

This page gives a practical setup and maintenance checklist for server administrators.

## Recommended Setup Flow

{% stepper %}
{% step %}

## Install the required plugins

Install SuperiorSkyblock2.
{% endstep %}

{% step %}

## Add hologram support as needed

Install DecentHolograms if you need clickable holograms.

Install FancyHolograms only if you want it as the display backend and do not need click commands.
{% endstep %}

{% step %}

## Add PlaceholderAPI if needed

Install PlaceholderAPI if your hologram lines use PlaceholderAPI placeholders.
{% endstep %}

{% step %}

## Install IslandHologram

Install IslandHologram `2.0.2`.
{% endstep %}

{% step %}

## Start and configure the server

Start the server once.

Edit `plugins/IslandHologram/config.yml`.
{% endstep %}

{% step %}

## Migrate existing islands

Run `/isholo migrate` if the server already has islands.
{% endstep %}

{% step %}

## Verify the setup

Visit a few islands and check placement, text, and click behavior.
{% endstep %}
{% endstepper %}

## Recommended Provider Setup

{% tabs %}
{% tab title="Most servers" %}

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

{% endtab %}

{% tab title="Click commands" %}

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

{% endtab %}

{% tab title="FancyHolograms" %}

```yaml
hologram:
  provider: FANCY_HOLOGRAMS
  scale: 1.0
```

{% endtab %}
{% endtabs %}

## Safe Reload Workflow

{% stepper %}
{% step %}

## Edit the config

Edit `config.yml`.
{% endstep %}

{% step %}

## Save the file

Save the file.
{% endstep %}

{% step %}

## Reload IslandHologram

Run `/isholo reload`.
{% endstep %}

{% step %}

## Check for errors

Check the console for provider or database errors.
{% endstep %}

{% step %}

## Test on an island

Visit an island within spawn-radius.
{% endstep %}
{% endstepper %}

Reload despawns active holograms and re-registers stored islands. The proximity task spawns holograms again when players are nearby.

## Updating the Plugin

{% stepper %}
{% step %}

## Stop the server

Stop the server.
{% endstep %}

{% step %}

## Back up files

Back up `plugins/IslandHologram/config.yml`.

Back up `plugins/IslandHologram/data.db`.
{% endstep %}

{% step %}

## Replace the jar

Replace the old jar with the new jar.
{% endstep %}

{% step %}

## Start the server

Start the server.
{% endstep %}

{% step %}

## Check the console

Check the console.
{% endstep %}

{% step %}

## Reload if needed

Run `/isholo reload` if you changed `config.yml`.
{% endstep %}
{% endstepper %}

Old jar files should be removed from the `plugins` folder before starting the server.

## Backups

Back up these files before updates or large migrations:

```
plugins/IslandHologram/config.yml
plugins/IslandHologram/data.db
```

## Operational Notes

* Holograms exist only while players are near islands.
* Increasing `proximity.spawn-radius` can increase the number of active holograms.
* `hologram.refresh-interval` controls how often visible holograms update their text.
* Setting `hologram.refresh-interval` to `0` disables automatic line refresh.
* `/isholo toggle` is player-facing and only works for island owners.


---

# 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/admin-guide.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.