> 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/betterspawner/konfiguration.md).

# Konfiguration

Hier findest du die Erklärung der Hauptkonfiguration (`config.yml`) sowie eine detaillierte Schritt-für-Schritt-Anleitung zur Erstellung eigener Spawner-Typen.

{% hint style="info" %}
**Tipp:** Nach Änderungen an der Konfiguration empfiehlt es sich, den Server neu zu starten, damit alle Spawner-Dateien und Rezepte korrekt geladen werden.
{% endhint %}

***

## Hauptkonfiguration (config.yml)

Die `config.yml` steuert das globale Verhalten des Plugins. Hier ist die vollständige Erklärung aller Sektionen:

### Allgemeine Einstellungen

```yaml
prefix: '&7[&6BetterSpawner&7]'  # Das Prefix vor allen Plugin-Nachrichten
backupLastEntryOfSpawnerymlonsave: true  # Sichert die Spawner-Datenbank vor jedem Speichern
permissionneededtouse: true  # Ob Spieler die Permission 'betterspawner.use' benötigen
keepupgrades.onswitch: true  # Behält Upgrades bei, wenn zwischen aktivem und passivem Modus gewechselt wird
placingabetterspawn: true  # Ob passive Spawner überhaupt platziert werden dürfen
forceasynctimemanager: true  # Nutzt einen asynchronen Zeitmanager zur Performance-Schonung
changemins: 300  # Cooldown in Minuten für den Wechsel des Spawner-Modus
```

### Spawner-Zerstörung (destory)

> \[!IMPORTANT] **Achtung zur Schreibweise:** In der Konfiguration und bei den Berechtigungen wird das Wort "destroy" als **`destory`** geschrieben!

```yaml
destory:
  onlywithpermission: false  # Nur Spieler mit der Permission 'betterspawner.destory' dürfen Spawner abbauen
  needpermission: false  # Ob generell eine Permission zum Zerstören benötigt wird
  havebeownerofspawner: false  # Wenn true, darf NUR der Besitzer des Spawners diesen wieder abbauen
```

### Einsatzbereiche (whereenable)

Bestimme, in welchen Welten oder Regionen das Plugin aktiv sein soll.

```yaml
whereenable:
  alloweverywhere: true  # Aktiviert das Plugin in allen Welten
  worlds:
    enablethisfeature: false  # Aktiviert die Welten-Blacklist/Whitelist
    onthelistenable: true  # Wenn true, ist das Plugin NUR in den Welten auf der Liste aktiv
    list:
      - world
  ONLYonplots: false  # Wenn true, können passive Spawner NUR auf Plots platziert werden
  onplots: true  # Erlaubt die Nutzung auf Plots generell
```

### Entity-Stapeln (stackonspawn)

Falls Spawner im aktiven Modus betrieben werden, können Entities gestapelt werden, um Laggs zu vermeiden.

```yaml
stackonspawn:
  enable: true  # Aktiviert das Stapeln von Entities
  radius: 8.0  # Suchradius für Mobs desselben Typs
  entityname: '&e%type% &fx%stack%'  # Namensanzeige über dem gestapelten Mob
  entitys:
    all: true  # Stapelt alle Mobs
    only:  # Falls 'all' auf false steht, werden nur diese Mobs gestapelt
      - ZOMBIE
      - PIG
  alloweverywhere: true  # Überall erlauben
  worlds:
    enablethisfeature: false
    onthelistenable: true
    list:
      - world
```

### Benutzeroberfläche & Texte (lore & guiname)

```yaml
lore:
  buy: '&7Kaufe jetzt für %price% $'
  bought: '&aGekauft'
  notreaced: '&7Du musst vorher die Items einzahlen und die vorherigen Stufen freischalten'
  havetobuyfilter: '&cDu musst davor den Filter erst kaufen'
  filteractivated: '&aAktiviert'
  filterdeactivated: '&cDeaktiviert'

guiname:
  active: '&7SpawnerMenu'
  main: '&7BetterSpawner'
  settings: '&7BetterSpawner | Einstellungen'
  stuff: '&7BetterSpawner | ItemInventar'

confirminv:
  name: '&cBist du sicher?'
  accept: '&aKaufen'
  cancel: '&cAbbrechen'
```

***

## 🧟 Eigene Spawner-Typen erstellen

Die detaillierte Anleitung zur Erstellung deiner eigenen Spawner-Typen (z. B. Erz-Generatoren) inklusive einer Kopiervorlage für Config-Dateien findest du auf der folgenden Seite:

* 👉 [🧟 Eigene Spawner-Typen erstellen](/betterspawner/konfiguration/eigene-spawner.md)