# 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.html): 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` | `false` | 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.

## 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 /sethome und /home gesperrt sind. 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: 5

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.
  commands:
    home:
      duration: 3
```

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