# Homes

Jeder Spieler kann benannte Homes anlegen, bis zu seinem individuellen Limit. Homes bleiben über Neustarts erhalten. Home-Teleports laufen über die [Teleport-Engine](teleport.md): Warmup, Cooldown, Kosten, Sicherheitsprüfung und Kampf-Sperre gelten wie bei jedem anderen Teleport.

## Commands

| Command | Syntax | Permission | Default | Beschreibung |
|---|---|---|---|---|
| `/home` | `/home [name]` | `home.use` | `true` | Teleportiert zu einem Home (Standardname `home`) |
| `/sethome` | `/sethome [name]` | `home.set` | `true` | Setzt ein Home an der aktuellen Position |
| `/delhome` | `/delhome <name>` | `home.delete` | `true` | Löscht ein Home |
| `/homes` | `/homes` (Alias `/homelist`) | `home.list` | `true` | Listet alle eigenen Homes klickbar auf |
| `/homeof` | `/homeof <spieler> [name]` | `home.admin` | op | Admin: fremde Homes auflisten oder sofort hinteleportieren |

## Weitere Permissions

| Permission | Default | Beschreibung |
|---|---|---|
| `home.bypass.worldblacklist` | false | Ignoriert die Welt-Sperre für Homes |
| `home.limit.<n>` | `false` | Erhöht das Home-Limit auf n (höchster Wert gilt) |
| `home.limit.unlimited` | false | Hebt das Home-Limit komplett auf |

> **Tipp:** `/homeof` ohne Home-Namen listet nur die Homes des Zielspielers (auch offline), erst mit Namen wird teleportiert. Das Überschreiben eines vorhandenen Homes zählt nicht gegen das Limit.

**Welt-Sperrliste:** `homes.world-blacklist` verhindert das Setzen UND das Benutzen von Homes in diesen Welten (auch als Respawn-Ziel). Bypass: `home.bypass.worldblacklist`.

**Nicht geladene Welten:** Homes in Welten, die beim Serverstart noch nicht geladen sind (z. B. Welt-Plugins), bleiben erhalten: Sie zählen weiter zum Limit, blockieren ihren Namen, erscheinen in `/homes` mit dem Zusatz "(not loaded)" und werden aktiv, sobald die Welt geladen wird. `/delhome` funktioniert auch für sie.

## Konfiguration (modules/homes.yml)

```yaml
# Schaltet das Homes-Modul ein oder aus.
enabled: true

homes:
  # Anzahl Homes ohne Zusatz-Permission. Mehr über home.limit.<n>.
  default-limit: 3
  # Maximale Zeichenlänge eines Home-Namens.
  max-name-length: 32
  # Welten, in denen Homes weder gesetzt noch benutzt werden können (auch
  # nicht als Respawn-Ziel). Bypass: home.bypass.worldblacklist. Name,
  # Welt-Sperre und Limit werden VOR der Abbuchung geprüft, ein Fehlschlag
  # kostet nichts.
  world-blacklist: []

cooldown:
  # Wartezeit in Sekunden. 0 = kein Cooldown.
  commands:
    home: 180

cost:
  # Preis pro Nutzung. 0 = kostenlos.
  commands:
    home: 0
    sethome: 0

warmup:
  # Countdown vor dem Teleport. Fehlende Optionen erben warmup.default
  # aus der config.yml. Abbruch bei Bewegung, Ausloggen, fremdem Teleport
  # und Tod; mit cancel-on-damage: true auch bei jedem Schaden.
  commands:
    home:
      duration: 3
      cancel-on-damage: false
```

## Komplette Beispiel-Config

```yaml
enabled: true

homes:
  default-limit: 5
  max-name-length: 24
  world-blacklist:
    - world_nether
    - arena

cooldown:
  commands:
    home: 10

cost:
  commands:
    home: 15.0
    sethome: 100.0

warmup:
  commands:
    home:
      duration: 5
      cancel-on-damage: true
```