# SurvivalPlus

**Minecraft Plugin**

![Minecraft Plugin](https://img.shields.io/badge/Minecraft-Plugin-green)
![Version](https://img.shields.io/badge/version-1.1.2-blue)
![Author](https://img.shields.io/badge/author-M_Viper-yellow) 

---

## 📦 Beschreibung

**SurvivalPlus** ist ein umfangreiches Minecraft-Plugin zur Verbesserung des klassischen Survival-Erlebnisses.  
Es kombiniert Komfort-Features für Spieler mit leistungsstarken Verwaltungs- und Schutzmechanismen für Serverbetreiber.

Enthalten sind unter anderem:
Homes, Teleports, Inventar- & Enderchest-Verwaltung, Claims (Anti-Grief), Freundeslisten, Shop-System, Loot-Kisten, Tablist-Anpassungen, Player Heads, erweiterte Vanish-Funktionen sowie zahlreiche Server-Utilities.

---

## ⚡ Highlights / Features

- **Homes & Warps**  
  Persönliche Warps, Home-Management, GUI-Übersichten

- **Teleportation & Anfrage-System**  
  `/tpa`, `/tpaccept`, `/tpdeny`, `/back`, `/spawn`

- **Claim-System (Anti-Grief)**  
  Land sichern, Trust/Untrust, Ban/Kick, Claim-Infos

- **Inventar- & Enderchest-Verwaltung**  
  Admin-Zugriff auf Fremd-Inventare

- **Neu: Player Heads**  
  Köpfe bei Tod oder per `/head` Befehl

- **Neu: Erweiterte Vanish-Funktionen**  
  Silent Join, keine Item-Aufnahme

- **Neu: Sign Shops**  
  Schilder-Shops mit Vault-Integration

- **Shop-System & Lootchests**  
  Verwaltung & Teleport zu Loot-Kisten

- **CommandBlocker & Server-Utilities**  
  Clearchat, Clearitems, Closedoors, Lock-System

- **Debug-Logging**  
  Optionales Logging in `debug.log` & `console.log`

- **Tablist**  
  Animiert & konfigurierbar über `tablist.yml`

- **bStats Unterstützung**  
  Anonyme Statistiken

---

## 🛠 Komplette Befehlsübersicht

> **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)