# Signs Configuration

### Step 1

1. Stop the server.
2. Go to plugins directory (server-root/plugins/HolographicPlaceholders)
3. Open the file named signs.yml
4. **BALTOP ISN'T SUPPORTED BY SIGNS AND HEADS**

### Step 2

On top of the file, you'll see a comment with placeholders (replacements) that you can use on signs text.

```
# Placeholders you can use in sign texts:
# {position} - Position in number user is on
# {player} - Returns player name
# {value} - Gets replaced with value like money

```

After that you'll see example of configurations for signs.

```yaml
'%statistic_deaths%': # Name of configuration
  1: #Top 1 user on leaderboard will use this sign configuration
    lines:
      - "&bTop 1"
      - "&e{player}"
      - "&fDeaths: &e{value}"
      - "&f=========="
  2: #Top 3 user on leaderboard will use this sign configuration
    lines:
      - "&bTop 2"
      - "&b{player}"
      - "&fDeaths: &e{value}"
      - "&f=========="
  3:
    lines:
      - "&bTop 3"
      - "&d{player}"
      - "&fDeaths: &e{value}"
      - "&f=========="
  default: # All other users not defined with positions will use this configuration
    lines:
      - "&bTop {position}"
      - "&7{player}"
      - "&fDeaths: &e{value}"
      - "&f=========="
```

You can see there is name of configuration and 4 sections to it,  three of them are numbered and one that says default. You can now copy this configuration and change its name to name of addon you specified in config.yml, follow the PAPi Examples configuration tutorial. After that you can add as many of numbered configurations as you want but make sure you have the default one to or signs will just be empty when plugin tries to display data on them.

### Step 3

Start the server and build the signs where you want the leaderboard. After you finished building your leaderboard you can start setting the signs that plugin needs to update. To do that you have to point your crosshair onto sign (block has to be selected) then you type the next command: 

/hpe setsign \<name of addon (PAPi placeholder)> \<position on leaderboard (1,2,3,4...)>

{% hint style="info" %}
Similar command is used for setting heads (point at head) type:

/hpe sethead \<name of addon (PAPi placeholder)> \<position on leaderboard (1,2,3,4...)>
{% endhint %}

After that, you should see sign update after like 10 seconds or the delay you specified in config.yml

If you want to remove the sign you have to select the block (point at it with crosshair) and type the next command

{% hint style="info" %}
Similar command is used for removing heads (point at head) type:

/hpe removehead \<name of addon (PAPi placeholder)>
{% endhint %}

/hpe removesign \<name of addon (PAPi placeholder>

&#x20;


---

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

```
GET https://wiki.virtusdevelops.eu/holograpicplaceholders/configuration/heads-and-signs-configuration.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.