# Holograms

Set up text-based holograms for your players to show global leaderboard for a specific type of statistic without any extra plugin dependency.

### Features

* Create any amount of holograms as you want
* Set view distance/range of the hologram (how far can players see this hologram)
* Set maximum line width before wrapping text
* Customisable title and line text for all hologram
* Set different customisation options for hologram text when creating
* Automatic updates for all created holograms on game end or forced update using `/rm hologram leaderboard update` command

### Creation

{% hint style="info" %}
When creating holograms, make sure there is at least 2 blocks distance between each hologram. Otherwise, they will not be created.
{% endhint %}

<details>

<summary>Watch: Create hologram</summary>

<figure><img src="/files/NNzte1uSF6mQZmB1Wdf2" alt=""><figcaption></figcaption></figure>

</details>

You can configure holograms with these optional options:

* `seethrough` - Makes text seen through
* `textopacity` - Sets text opacity
* `shadowed` - Sets if text is shadowed
* `backgroundcolor` - Sets a background colour for this hologram
  * You can use names specified in [org.bukkit.Color](https://jd.papermc.io/paper/org/bukkit/Color.html) docs, or from [ARGB](https://en.wikipedia.org/wiki/RGBA_color_model) integer
* `billboard` - Sets the [billboard](https://jd.papermc.io/paper/org/bukkit/entity/Display.Billboard.html) setting of this hologram. The billboard setting controls the automatic rotation of the hologram to face the player.
* `textalignment` - Sets the [text alignment](https://jd.papermc.io/paper/org/bukkit/entity/TextDisplay.TextAlignment.html) for this hologram

### Removing

Removing holograms can be done using `/rm hologram leaderboard remove`. This command removes the closest hologram and you can not restore it afterwards.


---

# Agent Instructions: 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:

```
GET https://mdswork.gitbook.io/ragemode-docs/guides/holograms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.