> 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

**Allgemeine Einstellungen**

* **`prefix`**: Das Präfix für alle Plugin-Nachrichten.

  ```yaml
  prefix: '&eBallon &7»'
  ```
* **`ballonhigh`**: Bestimmt die Höhe, in der der Ballon fliegt.

  ```yaml
  ballonhigh: '3.5'
  ```
* **`guiname`**: Der Name des GUI, das beim Öffnen des Ballon-Menüs angezeigt wird.

  ```yaml
  guiname: '&eBallon &7»'
  ```

#### **Entity-Einstellungen**

* **`cancelspawnentitys`**: Gibt an, ob das Spawnen von Entitäten deaktiviert werden soll.

  ```yaml
  cancelspawnentitys: false
  ```
* **`cancelfullleashspawnable`**: Deaktiviert das volle Anleinen von Entitäten.

  ```yaml
  cancelfullleashspawnable: true
  ```
* **`silententity`**: Entitäten sind still (ohne Geräusche).

  ```yaml
  silententity: true
  ```
* **`entitytype`**: Der Standardtyp der Entität für den Ballon.

  ```yaml
  entitytype: ZOMBIE
  ```
* **`allowedentity`**: Liste der erlaubten Entitätentypen, die als Ballon verwendet werden können.

  ```yaml
  allowedentity:
  - COW
  - PIG
  ```

#### **Nachrichten**

* **`message.noperm`**: Nachricht, wenn ein Spieler keine Berechtigung hat.

  ```yaml
  message.noperm: '&cDazu hast du keine Rechte.'
  ```
* **`message.selected`**: Nachricht, wenn ein Spieler einen Ballon ausgewählt hat. `%name%` wird durch den Namen des Ballons ersetzt.

  ```yaml
  message.selected: '&aDu hast das Ballon %name% &aausgewählt.'
  ```
* **`message.removed`**: Nachricht, wenn ein Ballon entfernt wurde.

  ```yaml
  message.removed: '&aDein Ballon wurde entfernt.'
  ```
* **`message.reloaded`**: Nachricht, wenn die Konfiguration neu geladen wurde.

  ```yaml
  message.reloaded: '&aDie Config wurde reloaded.'
  ```

#### **Ballon Entfernen**

* **`remove.item`**: Der Gegenstand, der zum Entfernen eines Ballons verwendet wird.

  ```yaml
  remove.item: BARRIER
  ```
* **`remove.shortid`**: Die Kurz-ID des Gegenstands.

  ```yaml
  remove.shortid: '0'
  ```
* **`remove.name`**: Der Name des Gegenstands, der zum Entfernen eines Ballons verwendet wird.

  ```yaml
  remove.name: '&cBallon entfernen'
  ```

#### **Köpfe**

* **`heads`**: Liste der verfügbaren Köpfe für Ballons. Jeder Eintrag besteht aus einem Spielernamen und einem angezeigten Namen.

**Wichtig:** Um Custom Heads zu benutzen, musst du auf <https://minecraft-heads.com> und dort dann einen Kopf raussuchen. Von diesem Kopf siehst du dann eine "Value" auf der Seite, diese kopierst du und fügst sie in die Config wie im Beispiel gezeigt ein.<br>

<figure><img src="/files/azSI4oHACZnV4rpPQzqu" alt=""><figcaption><p>Value Beispiel auf minecraft-heads.com<br><a href="https://minecraft-heads.com/custom-heads/head/98407-chalice">https://minecraft-heads.com/custom-heads/head/98407-chalice</a></p></figcaption></figure>

```yaml
heads:
- Dyroxplays;&cDyroxplays
- eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTZhMTA2YmQ3YzViZDNmZDA2ZDkwOGRmZjFjNzczMjVjNTIxZGM4NzM1YzAxYWFkZTc3N2YwNTY0MjFhZDkyOSJ9fX0=;&aCustom Head
```

***

Diese Konfigurationsdatei ermöglicht es dir, die Ballon-Einstellungen für deinen Minecraft-Server vollständig anzupassen. Von der Höhe des Ballons über die Art der verwendeten Entitäten bis hin zu benutzerdefinierten Kopf-Designs kannst du alles nach deinen Wünschen einstellen.


---

# 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.dyroxplays.de/ballon/konfiguration.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.
