# Teams

Teams bündeln Spieler mit eigenem Namen, freiem Rangsystem, Bank, Score/Level, Team-Home, Warps, geteilter Enderchest, Kisten-Claims und Diplomatie (Allianzen, Team-/Ally-Chat). Bedienbar über `/team`, die Team-GUI (`/team` ohne Argumente) und das [Web-Interface](web-interface.html).

Wichtig zum Verständnis: Die Bukkit-Permission (z. B. `team.invite`) entscheidet, ob ein Spieler das Feature grundsätzlich nutzen darf. Das **Rang-Recht** (z. B. `INVITE_MEMBERS`) entscheidet, ob sein Rang im Team die Aktion ausführen darf. Der Owner-Rang (Gewicht 0) hat immer alle Rechte.

## Commands

| Command | Syntax | Permission | Default | Rang-Recht | Beschreibung |
|---|---|---|---|---|---|
| Erstellen | `/team create <name>` | `team.create` | `true` | - | Erstellt ein Team, Ersteller wird Owner |
| Auflösen | `/team disband` | `team.disband` | `true` | `DISBAND_TEAM` | Löst nach Chat-Bestätigung auf |
| Umbenennen | `/team name <name>` | `team.manage` | `true` | `EDIT_NAME` | Ein Wort, alle Daten bleiben erhalten |
| Beschreibung | `/team description [text]` | `team.manage` | `true` | `EDIT_DESCRIPTION` | Setzt/löscht die Beschreibung |
| Farbe | `/team color <farbe>` | `team.manage` | `true` | `EDIT_COLOR` | Benannt oder Hex |
| Tag | `/team tag [tag]` | `team.manage` | `true` | `EDIT_TAG` | Setzt/entfernt das Kürzel |
| Info | `/team info [team\|spieler]` | `team.info` | `true` | - | Details zu einem Team |
| Menü | `/team menu` | `team.menu` | `true` | - | Öffnet die Team-GUI |
| Einladen | `/team invite <spieler>` | `team.invite` | `true` | `INVITE_MEMBERS` | Max. eine offene Einladung pro Ziel, läuft nach `invite-timeout` ab |
| Beitreten | `/team join [team]` | `team.join` | `true` | - | Nimmt Einladung an oder tritt offenem Team bei |
| Ablehnen | `/team deny` | `team.deny` | `true` | - | Lehnt die eigene Einladung ab |
| Verlassen | `/team leave` | `team.leave` | `true` | - | Owner muss vorher übergeben oder auflösen |
| Offen/zu | `/team open` | `team.open` | `true` | `TOGGLE_OPEN` | Freier Beitritt an/aus |
| Kick | `/team kick <spieler>` | `team.kick` | `true` | `KICK_MEMBERS` | Nur bei strikt höherem Rang |
| Bann | `/team ban <spieler>` / `unban` | `team.ban` | `true` | `BAN_MEMBERS` | Bannt (kickt vorher) bzw. entbannt |
| Ränge | `/team ranks <list\|create\|rename\|delete\|perms\|moveup\|movedown>` | `team.rank.manage` | `true` | `MANAGE_RANKS` | Verwaltet die Rang-Liste |
| Rang zuweisen | `/team ranks assign <spieler> <rang>` | `team.rank.assign` | `true` | `PROMOTE_MEMBERS` oder `DEMOTE_MEMBERS` | Nur Ränge unterhalb des eigenen |
| Kontostand | `/team bal` | `team.bal` | `true` | `VIEW_BALANCE` | Team-Kasse anzeigen |
| Einzahlen | `/team deposit <betrag>` | `team.deposit` | `true` | `DEPOSIT` | Spielergeld in die Kasse |
| Abheben | `/team withdraw <betrag>` | `team.withdraw` | `true` | `WITHDRAW` | Kasse an den Spieler |
| Bank-Topliste | `/team baltop [seite]` | `team.baltop` | `true` | - | Teams nach Kontostand (30 s Cache) |
| Level-Info | `/team rank` | `team.rank` | `true` | - | Aktuelles Level und Anforderungen |
| Level-Up | `/team rankup` | `team.rankup` | `true` | `RANKUP_TEAM` | Stuft hoch, wenn Score und Kasse reichen |
| Score-Topliste | `/team top [seite]` | `team.top` | `true` | - | Teams nach Score (30 s Cache) |
| Home | `/team sethome` / `home` / `delhome` | `team.home` | `true` | `SET_HOME` / `USE_HOME` | Team-Home (Warmup/Cooldown/Kosten über `teamhome`) |
| Warps | `/team setwarp <name>` / `warp [name]` / `delwarp <name>` | `team.warp` | `true` | `MANAGE_WARPS` / `USE_WARPS` | Team-Warps im einheitlichen Warp-System, Details auf der [Warps-Seite](warps.html) |
| Enderchest | `/team echest` | `team.echest` | `true` | `USE_ECHEST` | Geteilte 27-Slot-Enderchest in Echtzeit |
| Kisten | `/team chest <claim\|remove\|removeall>` | `team.chest` | `true` | `MANAGE_CHEST_CLAIMS` | Kisten/Fässer fürs Team beanspruchen |
| Shop umwandeln | `/team shop` (Shop anvisieren) | `team.shop` | `true` | `EDIT_TEAM_SHOPS` | Eigenen Chest-Shop in einen Team-Shop umwandeln |
| Allianz | `/team ally <team>` / `neutral <team>` | `team.ally` | `true` | `MANAGE_ALLIES` | Beidseitige Bestätigung; neutral wirkt einseitig |
| Team-Chat | `/team chat [text]` | `team.chat` | `true` | `USE_TEAM_CHAT` | Ohne Text: Dauer-Umschalter |
| Ally-Chat | `/team allychat [text]` | `team.allychat` | `true` | `USE_ALLY_CHAT` | Team + Verbündete; schließt Team-Chat aus |
| PvP | `/team pvp` | `team.pvp` | `true` | `TOGGLE_PVP` | Internes Friendly Fire an/aus |
| Owner übergeben | `/team setowner <spieler>` | `team.setowner` | `true` | `TRANSFER_OWNERSHIP` | Überträgt die Eigentümerschaft |

## Weitere Permissions

| Permission | Default | Beschreibung |
|---|---|---|
| `team.bypass.createcost` | `false` | Team-Erstellung kostenlos |
| `team.bypass.changecost` | `false` | Änderungskosten (Name, Tag, Farbe, ...) umgehen |
| `team.bypass.friendlyfire` / `team.bypass.allyfriendlyfire` | `false` | Schadet Team-/Ally-Mitgliedern trotz Schutz |
| `team.bypass.chestclaim` | `false` | Öffnet/bricht fremde Team-Kisten |
| `team.bypass.depositcooldown` / `team.bypass.withdrawcooldown` | `false` | Bank-Cooldowns umgehen |
| `team.bypass.limit` | `false` | Warp-/Rang-Limits umgehen |

## Rang-Rechte

Jedes Recht ist pro Rang einzeln vergebbar (`/team ranks perms` oder GUI). Ränge haben ID, Anzeigename (3 bis 24 Zeichen), Gewicht (0 = Owner, höher = niedriger), Icon und Rechte. Rang-Limit: 3 Preset-Ränge + `max-ranks` + Level-Bonus, hart gedeckelt bei 16.

| Kategorie | Rechte |
|---|---|
| Mitglieder | `INVITE_MEMBERS`, `KICK_MEMBERS`, `BAN_MEMBERS`, `PROMOTE_MEMBERS`, `DEMOTE_MEMBERS`, `MANAGE_RANKS` |
| Identität | `EDIT_NAME`, `EDIT_TAG`, `EDIT_DESCRIPTION`, `EDIT_COLOR`, `TOGGLE_OPEN`, `TOGGLE_PVP` |
| Diplomatie | `MANAGE_ALLIES`, `USE_ALLY_CHAT`, `USE_TEAM_CHAT` |
| Wirtschaft | `VIEW_BALANCE`, `DEPOSIT`, `WITHDRAW`, `RANKUP_TEAM` |
| Orte | `USE_HOME`, `SET_HOME`, `USE_WARPS`, `MANAGE_WARPS` |
| Lagerung | `USE_ECHEST`, `MANAGE_CHEST_CLAIMS` |
| Gefahrenzone | `DISBAND_TEAM`, `TRANSFER_OWNERSHIP` |
| Claims & Shops | `BUILD_IN_TEAM_SUBDIVISIONS`, `BUILD_IN_ALLY_SUBDIVISIONS`, `MANAGE_TEAM_CLAIM_FLAGS` (genutzt von [CoreEngineClaim](../claim/index.html)), `EDIT_TEAM_SHOPS` (Shop-System + Web) |

Preset-Rechte: Owner alles; Admin alles außer `EDIT_NAME`, `DISBAND_TEAM`, `TRANSFER_OWNERSHIP`, `RANKUP_TEAM`; Member `USE_TEAM_CHAT`, `USE_ALLY_CHAT`, `VIEW_BALANCE`, `DEPOSIT`, `USE_HOME`, `USE_WARPS`, `USE_ECHEST`, `BUILD_IN_TEAM_SUBDIVISIONS`.

> **Hinweis:** Kick, Bann, Befördern, Degradieren und Rang-Zuweisung prüfen zusätzlich die Hierarchie (nur strikt höherer Rang darf handeln, Owner steht über allen). Die Rechte werden überall gleich durchgesetzt: Befehle, GUI und Web-Interface, bei Team-/Ally-Chat sogar pro Nachricht neu.

## Score und Level

PvP-Kills zwischen verschiedenen Teams geben dem Killer-Team `per-kill` Punkte und ziehen dem Opfer-Team `per-death` ab (nie unter 0). Zwei Schutzmechanismen: gleiche IP von Killer und Opfer wird komplett ignoriert (`ip-check`), und ab `spam-kill-max-kills` Kills am selben Gegner innerhalb von `spam-kill-window` Sekunden gibt es keinen Score mehr.

`/team rankup` prüft erst den benötigten Score, bucht dann den Level-Preis aus der Team-Kasse ab. Die Bonus-Werte jedes Levels addieren sich auf die Basis-Limits; `bonus-shops` erhöht `max-shops-per-team` aus dem [Shop-Modul](shop.html).

> **Hinweis:** In der Standard-Config ist `required-score` überall 0, der Aufstieg ist also nur durch Geld begrenzt. Wer PvP-Score als Aufstiegs-Bedingung will, setzt `required-score` pro Level hoch.

## Kisten-Claims

Claimbar sind Truhen, Fallentruhen und Fässer (Doppeltruhen immer als Ganzes). Geschützt sind sie gegen Öffnen durch Fremde, Abbau (nur mit `MANAGE_CHEST_CLAIMS`), Hopper (auch teameigene) und Explosionen. ChestShops und Team-Kisten schließen sich gegenseitig aus. Mit installiertem [CoreEngineClaim](../claim/index.html) muss die Kiste in einem Team-Claim des eigenen Teams liegen. Limit: `max-chest-claims` + Level-Bonus.

## Admin-Commands (/teama)

Alle mit Permission `team.admin.<subcommand>`, Default `false`.

| Command | Syntax | Beschreibung |
|---|---|---|
| `/teama disband\|name\|description\|color\|tag` | `/teama <sub> <team> [wert]` | Beliebiges Team zwangsverwalten |
| `/teama join` / `leave` | `/teama join <team> <spieler>` / `/teama leave <spieler>` | Spieler in Team zwingen/entfernen |
| `/teama promote` / `demote` / `setowner` | `/teama <sub> <spieler>` | Rang-Schritt hoch/runter bzw. Owner erzwingen |
| `/teama rank` | `/teama rank <team> <create\|delete\|rename\|list\|perms\|assign\|moveup\|movedown\|reset>` | Vollzugriff aufs Rangsystem, `reset` = zurück auf 3 Standard-Ränge |
| `/teama score` / `money` | `/teama <sub> <set\|add\|remove> <team> <wert>` | Score/Kasse direkt ändern |
| `/teama home` / `echest` / `chest` | `/teama <sub> <team> [...]` | Home betreten, Enderchest öffnen, Kisten-Claims verwalten |
| `/teama purge` | `/teama purge` | Score ALLER Teams auf 0 |
| `/teama chatspy` | `/teama chatspy` | Team-/Ally-Chat mitlesen |
| `/teama reload` | `/teama reload` | Team-Config neu laden |

## Konfiguration (modules/team.yml)

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

team:
  # Basis-Limits, Level-Boni kommen oben drauf.
  max-team-size: 20
  min-name-length: 3
  max-name-length: 8
  # MiniMessage in Teamnamen erlauben (dann zählt die sichtbare Länge).
  allow-minimessage-names: false
  min-tag-length: 2
  max-tag-length: 4
  max-description-length: 100
  max-warps: 1
  # Eigene Rang-Plätze auf Level 1, ZUSÄTZLICH zu den 3 Preset-Rängen.
  # Effektiv = 3 + max-ranks + bonus-ranks des Levels, Deckel bei 16.
  max-ranks: 2
  # Basis-Kisten-Claims, plus bonus-claims des Levels.
  max-chest-claims: 25
  max-allies: 3
  # Preis der Team-Erstellung. 0 = kostenlos.
  create-cost: 5000.0
  # Preis pro Änderung; Entfernen von Tag/Beschreibung ist immer
  # kostenlos, abgebucht wird erst nach erfolgreicher Änderung.
  change-costs:
    rename: 0.0
    tag: 0.0
    color: 0.0
    description: 0.0
    sethome: 0.0
  # Obergrenzen für Kasse und Score.
  max-balance: 1000000000.0
  max-score: 1000000
  # PvP-Standard neuer Teams, serverweiter Ally-Friendly-Fire-Schalter
  # und Kollisions-Abschaltung zwischen Mitgliedern.
  friendly-fire-default: false
  ally-friendly-fire: false
  collision-disabled: false
  # Verbotene Namensbestandteile (Substring-Filter).
  blocked-names: ["admin", "server", "staff", "moderator", "console", "system"]
  # Sekunden bis eine Einladung abläuft.
  invite-timeout: 60
  score:
    per-kill: 10
    per-death: 5
    spam-kill-window: 300
    spam-kill-max-kills: 3
    ip-check: true
  # Level: required-score und cost gelten für den Aufstieg AUF das Level,
  # bonus-* addiert sich auf die Basis-Limits.
  levels:
    1: { name: "Bronze",  required-score: 0, cost: 0,      bonus-members: 0,  bonus-warps: 0, bonus-claims: 0,   bonus-ranks: 0, bonus-shops: 0 }
    2: { name: "Silver",  required-score: 0, cost: 5000,   bonus-members: 5,  bonus-warps: 1, bonus-claims: 25,  bonus-ranks: 2, bonus-shops: 5 }
    3: { name: "Gold",    required-score: 0, cost: 25000,  bonus-members: 10, bonus-warps: 2, bonus-claims: 50,  bonus-ranks: 4, bonus-shops: 10 }
    4: { name: "Diamond", required-score: 0, cost: 100000, bonus-members: 20, bonus-warps: 3, bonus-claims: 75,  bonus-ranks: 6, bonus-shops: 20 }
    5: { name: "Emerald", required-score: 0, cost: 500000, bonus-members: 30, bonus-warps: 5, bonus-claims: 100, bonus-ranks: 8, bonus-shops: 40 }
  ranks:
    min-name-length: 3
    max-name-length: 24
    name-blacklist: ["owner"]
    # Material-Auswahl für Rang-Icons. Leer = eingebaute Liste.
    icon-picker-materials: []
  gui:
    members-per-page: 28
    # /team ohne Argumente öffnet die GUI.
    open-on-empty-command: true
    # Doppelte Bestätigung für zerstörerische Aktionen.
    danger-double-confirm: true
  integrations:
    coreprotect:
      # Protokolliert Kisten-Claim-Abbau (#teamclaim-<spieler>).
      chest-claim-logging: true

cooldown:
  commands:
    teamhome: 10
    teamwarp: 10
    teamdeposit: 5
    teamwithdraw: 10
    teamcreate: 5
    teamrankup: 5

cost:
  commands:
    teamhome: 0
    teamwarp: 0

warmup:
  commands:
    teamhome:
      duration: 5
    teamwarp:
      duration: 5
```

## Komplette Beispiel-Config

```yaml
enabled: true

team:
  max-team-size: 10
  min-name-length: 3
  max-name-length: 12
  allow-minimessage-names: false
  min-tag-length: 2
  max-tag-length: 5
  max-description-length: 80
  max-warps: 2
  max-ranks: 3
  max-chest-claims: 15
  max-allies: 2
  create-cost: 10000.0
  change-costs:
    rename: 2500.0
    tag: 1000.0
    color: 500.0
    description: 0.0
    sethome: 500.0
  max-balance: 50000000.0
  max-score: 100000
  friendly-fire-default: false
  ally-friendly-fire: false
  collision-disabled: true
  blocked-names: ["admin", "server", "staff", "mod"]
  invite-timeout: 120
  score:
    per-kill: 15
    per-death: 10
    spam-kill-window: 600
    spam-kill-max-kills: 2
    ip-check: true
  levels:
    1: { name: "Rekrut",  required-score: 0,     cost: 0,      bonus-members: 0,  bonus-warps: 0, bonus-claims: 0,  bonus-ranks: 0, bonus-shops: 0 }
    2: { name: "Veteran", required-score: 500,   cost: 20000,  bonus-members: 5,  bonus-warps: 1, bonus-claims: 10, bonus-ranks: 2, bonus-shops: 5 }
    3: { name: "Elite",   required-score: 2500,  cost: 100000, bonus-members: 10, bonus-warps: 2, bonus-claims: 25, bonus-ranks: 4, bonus-shops: 10 }
  ranks:
    min-name-length: 3
    max-name-length: 16
    name-blacklist: ["owner", "admin"]
    icon-picker-materials: []
  gui:
    members-per-page: 28
    open-on-empty-command: true
    danger-double-confirm: true
  integrations:
    coreprotect:
      chest-claim-logging: true

cooldown:
  commands:
    teamhome: 30
    teamwarp: 30
    teamdeposit: 5
    teamwithdraw: 30
    teamcreate: 60
    teamrankup: 10

cost:
  commands:
    teamhome: 10.0
    teamwarp: 10.0

warmup:
  commands:
    teamhome:
      duration: 5
    teamwarp:
      duration: 5
```