# SurvivalPlus

**Minecraft Plugin für 1.21+**

**Version:** 1.1.3  
**Autor:** M_Viper

---

## 📦 Übersicht & Features

**SurvivalPlus** erweitert das klassische Minecraft-Survival mit Komfort, Schutz und Admin-Tools:

- Homes, Warps, Teleportsystem (Tpa, Back, Spawn)
- Claim-System (Anti-Grief, Trust, Ban, Kick, Claim-Infos)
- Inventar- & Enderchest-Management (auch für Admins)
- Freundesliste, Block- & Report-System
- Shop-System, Lootchests, Sign Shops (Vault)
- Player Heads, Vanish, Freeze, Ride, Sitzfunktion
- CommandBlocker, Clearchat, Clearitems, Closedoors, Lock-System
- Animierte Tablist, bStats, Debug-Logging, umfangreiche Konfiguration

---

## 🛠 Befehle (Commands)

Alle Befehle und Permissions findest du auch in der **plugin.yml**. Hier die wichtigsten:

| Befehl | Beschreibung | Permission |
|--------|--------------|------------|
| /sp | Hauptbefehl (Info, Reload, Help, Share, CommandBlocker) | survivalplus.sp |
| /help | Hilfe & Übersicht | survivalplus.sp |
| /ir <Name> | Item umbenennen | survivalplus.itemrename |
| /workbench | Werkbank-GUI öffnen | survivalplus.workbench |
| /anvil | Amboss-GUI öffnen | survivalplus.anvil |
| /trash | Mülleimer öffnen | survivalplus.trash |
| /showarmorstands | Debug: ArmorStands sichtbar | survivalplus.showarmorstands |
| /cleardebugarmorstands | Debug-ArmorStands entfernen | survivalplus.cleardebugarmorstands |
| /leashcount | Geleinte Tiere anzeigen | survivalplus.leashcount |
| /nick <Name> | Nickname setzen | survivalplus.nick |
| /head <Spieler> | Spieler-Kopf erhalten | survivalplus.head |
| /vanish | Unsichtbar werden | survivalplus.vanish |
| /freeze <Spieler> | Spieler einfrieren | survivalplus.freeze |
| /ride [Spieler] | Reite einen Spieler | survivalplus.ride |
| /tp <Spieler> | Teleport zu Spieler | survivalplus.tp |
| /tphere <Spieler> | Spieler zu dir teleportieren | survivalplus.tphere |
| /tpa <Spieler> | Teleportanfrage senden | survivalplus.tpa |
| /tpaccept | Anfrage akzeptieren | survivalplus.tpaccept |
| /tpdeny | Anfrage ablehnen | survivalplus.tpdeny |
| /back | Zum letzten Todespunkt | survivalplus.back |
| /spawn | Zum Weltspawn | survivalplus.spawn |
| /setspawn | Server-Spawn setzen | survivalplus.setspawn |
| /setworldspawn | Welt-Spawn setzen | survivalplus.setworldspawn |
| /sethome <Name> | Home setzen | survivalplus.homes.set |
| /delhome <Name> | Home löschen | survivalplus.homes.delete |
| /home <Name> | Zu Home teleportieren | survivalplus.homes |
| /homelist | GUI mit allen Homes | survivalplus.homes.list |
| /setwarp <Name> | Persönlichen Warp setzen | survivalplus.setwarp |
| /delwarp <Name> | Warp löschen | survivalplus.delwarp |
| /warps | Warp-GUI öffnen | survivalplus.warps |
| /claim ... | Claim-System verwalten | survivalplus.claim.* |
| /sp cb ... | CommandBlocker verwalten | survivalplus.commandblocker.* |
| /clearchat | Chat leeren | survivalplus.clearchat |
| /clearitems | Items entfernen | survivalplus.clearitems |
| /closedoors <radius> | Türen schließen | survivalplus.closedoors |
| /sp lock | Kisten/Türen sperren | survivalplus.lock |
| /shop ... | Shop verwalten | survivalplus.shop |
| /lootchests | Loot-Kisten auflisten | survivalplus.lootchests |
| /tploot <welt> <x> <y> <z> | Zu Loot-Kiste teleportieren | survivalplus.lootchests |
| /trade <Spieler> | Handel starten | survivalplus.trade |
| /tradeaccept <Spieler> | Handel annehmen | survivalplus.tradeaccept |
| /day | Tag setzen | survivalplus.day |
| /night | Nacht setzen | survivalplus.night |
| /gm <Modus> | Gamemode ändern | survivalplus.gamemode |
| /heal [Spieler] | Spieler heilen | survivalplus.heal |
| /friend ... | Freundesverwaltung | survivalplus.friend |
| /block <Spieler> | Spieler blockieren | survivalplus.block |
| /unblock <Spieler> | Blockierung aufheben | survivalplus.unblock |
| /blocklist | Blockliste anzeigen | survivalplus.blocklist |
| /report <Spieler> [Grund] | Spieler melden | survivalplus.report |
| /showreport <Spieler> | Reports anzeigen | survivalplus.report.show |
| /clearreport <Spieler> | Reports löschen | survivalplus.report.clear |
| /stats | Spielerstatistiken | survivalplus.stats |
| /kit | Starterkit | survivalplus.kit |
| /startchallenge <Name> | Fun-Challenge starten | survivalplus.startchallenge |
| /sit | Hinsetzen | survivalplus.sit |

---

## 🔐 Permissions

- `survivalplus.*` — Vollzugriff (OP)
- `survivalplus.sp` — Zugriff auf Hauptbefehl
- `survivalplus.claim.use / trust / admin` — Claim-System
- `survivalplus.vanish.silent` — Silent Join
- `survivalplus.vanish.no-pickup` — Keine Item-Aufnahme
- `survivalplus.head` — `/head` nutzen
- `survivalplus.notify` — Admin-Benachrichtigungen

➡ Vollständige Liste: **plugin.yml**

---

## ⚙️ Installation & Setup

1. Aktuelle `.jar` herunterladen
2. In den `plugins/` Ordner legen
3. **LuckPerms** und **Vault** installieren (empfohlen)
4. Server neu starten oder `/reload`
5. Konfigurationsdateien (`config.yml`, `lang.yml`, `help.yml`, etc.) nach Wunsch anpassen

---

## ⚙️ Konfiguration & Platzhalter

- **Alle Nachrichten**: In `lang.yml` anpassbar (außer feste Plugin-Infos)
- **Hilfe & Gruppen**: In `help.yml` strukturierbar
- **Tablist**: In `tablist.yml` animierbar
- **Shop, Claims, Homes, etc.**: Eigene YAML-Dateien
- **Platzhalter**: `%player%`, `%x%`, `%y%`, `%z%`, `%world%`, `{item}`, `{price}`, `{stock}` u.v.m.

---

## 🐞 Debug & Fehlerberichte

- In `config.yml` aktivieren:
  ```yml
  debug-logging: true
  ```
- Logs: `Debug/debug.log` (Fehler, Stacktraces), `Debug/console.log` (Konsolenausgabe)

---

## 📊 Statistiken & bStats

- Anonyme Nutzungsstatistiken via [bStats](https://bstats.org/plugin/bukkit/SurvivalPlus)

---

## 📜 Lizenz & Support

Dieses Projekt ist **frei für privaten Gebrauch**.

**Kontakt / Support / Feature-Wünsche:**
- [SpigotMC-Profil](https://www.spigotmc.org/resources/authors/m-lukas-17.618600/)
- [Bugtracker](https://git.viper.ipv64.net/M_Viper/Survival-Plus/issues)

---

## ❓ FAQ & Hinweise

- **Welche Minecraft-Version?** 1.21+ (Paper/Spigot/Bukkit)
- **Welche Plugins werden unterstützt?** LuckPerms, Vault, PlaceholderAPI, ProtocolLib (softdepend)
- **Wie kann ich alle Texte anpassen?** Über `lang.yml` und `help.yml`
- **Wie kann ich Claims, Shops, Homes sichern?** YAML-Dateien im `plugins/SurvivalPlus/`-Ordner
- **Wie kann ich Fehler melden?** Siehe Support-Links oben

---

> **Hinweis:**  
> Alle Commands sind vollständig in der `plugin.yml` definiert.  
> Nachfolgend eine Übersicht nach Kategorien.

---

### Allgemein / Haupt

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/sp` | Hauptbefehl (Reload, Info, Help, Share, CommandBlocker u.v.m.) | `survivalplus.sp` |
| `/help` | Hilfe / Übersicht (Alias: `/sp help`) | `survivalplus.sp` |

---

### Item & Utility

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/ir <name>` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` |
| `/workbench` | Öffnet Werkbank-GUI | `survivalplus.workbench` |
| `/anvil` | Öffnet Amboss-GUI | `survivalplus.anvil` |
| `/trash` | Öffnet Mülleimer | `survivalplus.trash` |
| `/showarmorstands` | Debug: ArmorStands sichtbar | `survivalplus.showarmorstands` |
| `/cleardebugarmorstands` | Entfernt Debug-ArmorStands | `survivalplus.cleardebugarmorstands` |
| `/leashcount` | Zeigt geleinte Tiere | `survivalplus.leashcount` |
| `/nick <Name>` | Nickname setzen (Farben/Hex) | `survivalplus.nick` |
| `/nick off` | Nickname entfernen | `survivalplus.nick` |
| `/head <Spieler>` | Spieler-Kopf erhalten | `survivalplus.head` |

---

### Admin & Tools

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/vanish` | Unsichtbar (Silent, No-Pickup optional) | `survivalplus.vanish` |
| `/freeze <Spieler>` | Spieler einfrieren | `survivalplus.freeze` |
| `/ride [Spieler]` | Reite einen Spieler | `survivalplus.ride` |

---

### Teleportation

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/tp <Spieler>` | Teleport zu Spieler | `survivalplus.tp` |
| `/tphere <Spieler>` | Spieler zu dir teleportieren | `survivalplus.tphere` |
| `/tpa <Spieler>` | Teleportanfrage senden | `survivalplus.tpa` |
| `/tpaccept` | Anfrage akzeptieren | `survivalplus.tpaccept` |
| `/tpdeny` | Anfrage ablehnen | `survivalplus.tpdeny` |
| `/back` | Zum letzten Todespunkt | `survivalplus.back` |
| `/spawn` | Zum Weltspawn | `survivalplus.spawn` |
| `/setspawn` | Server-Spawn setzen | `survivalplus.setspawn` |
| `/setworldspawn` | Welt-Spawn setzen | `survivalplus.setworldspawn` |

---

### Homes & Warps

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/sethome <name>` | Home setzen | `survivalplus.homes.set` |
| `/delhome <name>` | Home löschen | `survivalplus.homes.delete` |
| `/home <name>` | Zu Home teleportieren | `survivalplus.homes` |
| `/homelist` | GUI mit allen Homes | `survivalplus.homes.list` |
| `/setwarp <name>` | Persönlichen Warp setzen | `survivalplus.setwarp` |
| `/delwarp <name>` | Warp löschen | `survivalplus.delwarp` |
| `/warps` | Warp-GUI öffnen | `survivalplus.warps` |

---

### Claim (Anti-Grief)

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/claim mark 1|2` | Auswahlpunkt setzen | — |
| `/claim` | Gebiet claimen | `survivalplus.claim.use` |
| `/claim unclaim` | Claim löschen | `survivalplus.claim.use` |
| `/claim unclaim <Spieler>` | Alle Claims löschen (Admin) | `survivalplus.claim.admin` |
| `/claim trust <Spieler>` | Spieler hinzufügen | `survivalplus.claim.trust` |
| `/claim untrust <Spieler>` | Spieler entfernen | `survivalplus.claim.trust` |
| `/claim ban <Spieler>` | Spieler bannen | `survivalplus.claim.ban` |
| `/claim kick <Spieler>` | Spieler kicken | `survivalplus.claim.kick` |
| `/claim info` | Claim-Infos anzeigen | `survivalplus.claim.use` |

---

### CommandBlocker / Server-Management

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/sp cb add <cmd>` | Befehl blockieren | `survivalplus.commandblocker.add` |
| `/sp cb remove <cmd>` | Blockierung entfernen | `survivalplus.commandblocker.remove` |
| `/sp cb list` | Blockierte Befehle | `survivalplus.commandblocker.list` |
| `/clearchat` | Chat leeren | `survivalplus.clearchat` |
| `/clearitems` | Items entfernen | `survivalplus.clearitems` |
| `/closedoors <radius>` | Türen schließen | `survivalplus.closedoors` |
| `/sp lock` | Kisten/Türen sperren | `survivalplus.lock` |

---

### Shop, Loot & Trade

| Befehl | Nutzung | Permission |
|------|------|-----------|
| **Sign Shops** | `[Buy] Menge Item Preis` | automatisch |
| `/shop add <item> <preis> <bestand>` | Shop verwalten | `survivalplus.shop` |
| `/lootchests` | Loot-Kisten auflisten | `survivalplus.lootchests` |
| `/tploot <welt> <x> <y> <z>` | Zu Loot-Kiste teleportieren | `survivalplus.lootchests` |
| `/trade <Spieler>` | Handel starten | `survivalplus.trade` |
| `/tradeaccept <Spieler>` | Handel annehmen | `survivalplus.tradeaccept` |

---

### Zeit, Gamemode & Admin

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/day` | Tag setzen | `survivalplus.day` |
| `/night` | Nacht setzen | `survivalplus.night` |
| `/gm <modus>` | Gamemode ändern | `survivalplus.gamemode` |
| `/heal [Spieler]` | Spieler heilen | `survivalplus.heal` |

---

### Freundes-, Block- & Report-System

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/friend add|accept|deny` | Freundesverwaltung | — |
| `/block <Spieler>` | Spieler blockieren | `survivalplus.block` |
| `/unblock <Spieler>` | Blockierung aufheben | `survivalplus.unblock` |
| `/blocklist` | Blockliste anzeigen | `survivalplus.blocklist` |
| `/report <Spieler> [Grund]` | Spieler melden | `survivalplus.report` |
| `/showreport <Spieler>` | Reports anzeigen | `survivalplus.report.show` |
| `/clearreport <Spieler>` | Reports löschen | `survivalplus.report.clear` |

---

### Sonstiges

| Befehl | Nutzung | Permission |
|------|------|-----------|
| `/stats` | Spielerstatistiken | `survivalplus.stats` |
| `/kit` | Starterkit | `survivalplus.kit` |
| `/startchallenge <name>` | Fun-Challenge starten | `survivalplus.startchallenge` |
| `/sit` | Hinsetzen | `survivalplus.sit` |

---

## 🔐 Permissions (Kurzüberblick)

- `survivalplus.*` — Vollzugriff (OP)
- `survivalplus.sp` — Zugriff auf Hauptbefehl
- `survivalplus.claim.use / trust / admin` — Claim-System
- `survivalplus.vanish.silent` — Silent Join
- `survivalplus.vanish.no-pickup` — Keine Item-Aufnahme
- `survivalplus.head` — `/head` nutzen
- `survivalplus.notify` — Admin-Benachrichtigungen

➡ Vollständige Liste: **plugin.yml**

---

## ⚙ Installation

1. Aktuelle `.jar` herunterladen  
2. In den `plugins/` Ordner legen  
3. **LuckPerms** und **Vault** installieren  
4. Server neu starten oder `/reload`

---

## 🐞 Debug & Fehlerberichte

- In `config.yml` setzen:  
  ```yml
  debug-logging: true
  ```

## 🐞 Debug & Logs

- `Debug/debug.log` — Enthält Plugin-Fehler und Stacktraces (nur bei aktiviertem Debug-Logging)
- `Debug/console.log` — Kompletter Konsolenoutput zur Weitergabe an Entwickler

---

## 📜 Lizenz & Kontakt

Dieses Projekt ist frei für den **privaten Gebrauch**.

**Kontakt / Support / Feature-Wünsche:**  
**M_Viper** (Repo-Owner / GitHub)