> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/ballon/konfiguration.md).

# Konfiguration

Passe die Flughöhe des Ballons, die zulässigen Träger-Entities, die Menünamen und deine Custom-Heads-Texturen flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/Ballon/config.yml`**: Verwaltet alle Einstellungen, Systemnachrichten und das Ballon-Sortiment.

***

## Konfigurations-Bereiche

{% tabs %}
{% tab title="⚙️ Basis-Einstellungen" %}

#### Allgemeine Optionen

```yaml
# Der Präfix vor Systemnachrichten
prefix: '&eBallon &7»'

# Name der GUI zur Ballon-Auswahl
guiname: '&eBallon &7»'

# Flughöhe des Ballons über dem Spieler (in Blöcken)
ballonhigh: '3.5'
```

{% endtab %}

{% tab title="👾 Entity-Steuerung" %}

#### Ballon-Träger-Entities

Da der Ballon per Leine (Leash) an einer unsichtbaren Entity befestigt wird, steuerst du hier deren Verhalten:

```yaml
# Deaktiviert das Spawnen jeglicher Entitäten
cancelspawnentitys: false

# Unterbindet das Anleinen von Entities
cancelfullleashspawnable: true

# Deaktiviert die Geräusche der Träger-Entities
silententity: true

# Der standardmäßige Entity-Typ des Trägers
entitytype: ZOMBIE

# Liste der erlaubten Entities für die Ballons
allowedentity:
- COW
- PIG
```

{% endtab %}

{% tab title="❌ Abbau-Item" %}

#### Ballon entfernen Option

```yaml
# Material des Items im Menü zum Entfernen des Ballons
remove.item: BARRIER
remove.shortid: '0'
remove.name: '&cBallon entfernen'
```

{% endtab %}
{% endtabs %}

***

## Eigene Ballon-Köpfe hinzufügen (`heads`)

Du kannst beliebig viele Köpfe als auswählbare Ballons im Menü auflisten. Es werden sowohl Spieler-Namen als auch Base64-Texturen (Custom Heads) unterstützt.

### Minecraft-Heads.com Texturen verwenden:

1. Suche dir einen Kopf auf [minecraft-heads.com](https://minecraft-heads.com) aus.
2. Kopiere das Feld **Value** (die lange Base64-Zeichenkette).
3. Füge sie in die Liste unter `heads` ein.

```yaml
heads:
# Format: SPIELERNAME/VALUE;MENÜ-DISPLAYNAME
- Dyroxplays;&cDyroxplays
- eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTZhMTA2YmQ3YzViZDNmZDA2ZDkwOGRmZjFjNzczMjVjNTIxZGM4NzM1YzAxYWFkZTc3N2YwNTY0MjFhZDkyOSJ9fX0=;&aCustom Head
```

***

## System- und Fehlermeldungen

```yaml
message.noperm: '&cDazu hast du keine Rechte.'
message.selected: '&aDu hast das Ballon %name% &aausgewählt.'
message.removed: '&aDein Ballon wurde entfernt.'
message.reloaded: '&aDie Config wurde reloaded.'
```