readme.md aktualisiert

2026-01-13 17:58:57 +00:00
parent 58927afddc
commit 08b05167d8
1 changed files with 189 additions and 107 deletions
--- a/readme.md
+++ b/readme.md
@@ -1,174 +1,256 @@
 # SurvivalPlus
-![Minecraft Plugin](https://img.shields.io/badge/Minecraft-Plugin-green)
+**Minecraft Plugin**
 ![Version](https://img.shields.io/badge/version-1.1.1-blue)
 ![Author](https://img.shields.io/badge/author-M_Viper-yellow)
-**SurvivalPlus** ist ein Minecraft-Plugin zur Verbesserung des Survival-Erlebnisses.  
+![Minecraft Plugin](https://img.shields.io/badge/Minecraft-Plugin-green)
-Es bietet Homes, Teleports, Inventar-/Enderchest-Verwaltung, Claims (Anti-Grief), Freundeslisten, Shop-System, Loot-Kisten, Tablist-Anpassungen und viele Komfort-Utilities.
+![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)  
+- **Homes & Warps**  
- Teleportation & Anfrage-System (`/tpa`, `/tpaccept`, `/tpdeny`)  
+  Persönliche Warps, Home-Management, GUI-Übersichten
- Claim-System zur Land-Sicherung (trust/untrust, create/delete, info, list)  
+
- Inventar- & Enderchest-Verwaltung (öffnen von Fremd-Inventaren, Admin-Tools)  
+- **Teleportation & Anfrage-System**  
- Shop-System & Lootchests (Verwaltung, Teleport zu Lootchests)  
+  `/tpa`, `/tpaccept`, `/tpdeny`, `/back`, `/spawn`
- CommandBlocker & Server-Utilities (clearchat, clearitems, closedoors, lock)  
+
- Debug-Logging (optionale `debug-logging` in config, Debug/debug.log & Debug/console.log)  
+- **Claim-System (Anti-Grief)**  
- Tablist (animiert / konfigurierbar über `tablist.yml`)  
+  Land sichern, Trust/Untrust, Ban/Kick, Claim-Infos
- bStats Unterstützung (Statistiken)
+
 - **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: In `plugin.yml` sind alle Commands definiert — hier die Übersicht gruppiert nach Kategorie.
+> **Hinweis:**  
 > Alle Commands sind vollständig in der `plugin.yml` definiert.  
 > Nachfolgend eine Übersicht nach Kategorien.
 ---
 ### Allgemein / Haupt
 | Befehl | Nutzung | Permission |
-|---|---:|:---|
+|------|------|-----------|
-| `/sp` | Hauptbefehl (CommandBlocker, reload, info, share, help u.v.m.) | `survivalplus.sp` |
+| `/sp` | Hauptbefehl (Reload, Info, Help, Share, CommandBlocker u.v.m.) | `survivalplus.sp` |
-| `/help` (alias über `/sp help`) | Hilfe / Übersicht | `survivalplus.sp` |
+| `/help` | Hilfe / Übersicht (Alias: `/sp help`) | `survivalplus.sp` |
 ---
 ### Item & Utility
-| Befehl | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/ir <neuer_name>` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` |
+|------|------|-----------|
 | `/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` | Alle (debug) ArmorStands sichtbar machen | `survivalplus.showarmorstands` |
+| `/showarmorstands` | Debug: ArmorStands sichtbar | `survivalplus.showarmorstands` |
 | `/cleardebugarmorstands` | Entfernt Debug-ArmorStands | `survivalplus.cleardebugarmorstands` |
-| `/leashcount` | Anzahl geleinter Tiere anzeigen | `survivalplus.leashcount` |
+| `/leashcount` | Zeigt geleinte Tiere | `survivalplus.leashcount` |
-| `/nick <Name>` | Nickname ändern (Farben/Hex möglich) | `survivalplus.nick` |
+| `/nick <Name>` | Nickname setzen (Farben/Hex) | `survivalplus.nick` |
-| `/nick off` | Entfernt den Nickname wieder (Zurücksetzen zum echten Namen). | `survivalplus.nick` |
+| `/nick off` | Nickname entfernen | `survivalplus.nick` |
-| `/nick reset` | Alias für /nick off | `survivalplus.nick` |
+| `/head <Spieler>` | Spieler-Kopf erhalten | `survivalplus.head` |
-| `/nick remove` | Alias für /nick off | `survivalplus.nick` |
+
 ---
 ### 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 | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
 |------|------|-----------|
 | `/tp <Spieler>` | Teleport zu Spieler | `survivalplus.tp` |
-| `/tphere <Spieler>` | Teleportiert Spieler zu dir | `survivalplus.tphere` |
+| `/tphere <Spieler>` | Spieler zu dir teleportieren | `survivalplus.tphere` |
 | `/tpa <Spieler>` | Teleportanfrage senden | `survivalplus.tpa` |
-| `/tpaccept` | Teleportanfrage annehmen | `survivalplus.tpaccept` |
+| `/tpaccept` | Anfrage akzeptieren | `survivalplus.tpaccept` |
-| `/tpdeny` | Teleportanfrage ablehnen | `survivalplus.tpdeny` |
+| `/tpdeny` | Anfrage ablehnen | `survivalplus.tpdeny` |
-| `/back` | Zum letzten Todespunkt teleportieren | `survivalplus.back` |
+| `/back` | Zum letzten Todespunkt | `survivalplus.back` |
-| `/spawn` | Teleport zum Weltspawn | `survivalplus.spawn` |
+| `/spawn` | Zum Weltspawn | `survivalplus.spawn` |
-| `/setspawn` | Setzt Server-Spawn | `survivalplus.setspawn` |
+| `/setspawn` | Server-Spawn setzen | `survivalplus.setspawn` |
-| `/setworldspawn` | Setzt Weltspawn (aktuelle Welt) | `survivalplus.setworldspawn` |
+| `/setworldspawn` | Welt-Spawn setzen | `survivalplus.setworldspawn` |
 ---
 ### Homes & Warps
-| Befehl | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/sethome <name>` | Setzt Home | `survivalplus.homes.set` |
+|------|------|-----------|
-| `/delhome <name>` | Löscht Home | `survivalplus.homes.delete` |
+| `/sethome <name>` | Home setzen | `survivalplus.homes.set` |
-| `/home <name>` | Teleport zu Home | `survivalplus.homes` |
+| `/delhome <name>` | Home löschen | `survivalplus.homes.delete` |
-| `/homelist` | GUI mit Homes öffnen | `survivalplus.homes.list` |
+| `/home <name>` | Zu Home teleportieren | `survivalplus.homes` |
-| `/setwarp <name>` | Persönlichen Warp setzen (Item in Hand) | `survivalplus.setwarp` |
+| `/homelist` | GUI mit allen Homes | `survivalplus.homes.list` |
-| `/delwarp <name>` | Persönlichen Warp löschen | `survivalplus.delwarp` |
+| `/setwarp <name>` | Persönlichen Warp setzen | `survivalplus.setwarp` |
-| `/warps` | GUI aller Warps öffnen | `survivalplus.warps` |
+| `/delwarp <name>` | Warp löschen | `survivalplus.delwarp` |
 | `/warps` | Warp-GUI öffnen | `survivalplus.warps` |
 ---
 ### Claim (Anti-Grief)
-| Befehl | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/claim [unclaim / trust <player> / untrust <player>]` | Claim-Management (Trust/Untrust/Unclaim) | `survivalplus.claim.use` |
+|------|------|-----------|
-| `/claim create <name>` (falls implementiert) | Neues Claim anlegen | `survivalplus.claim.use` |
+| `/claim mark 1|2` | Auswahlpunkt setzen | — |
-| `/claim delete <name>` (falls implementiert) | Claim löschen | `survivalplus.claim.use` |
+| `/claim` | Gebiet claimen | `survivalplus.claim.use` |
-| `/claim addmember <player>` | Spieler zum Claim hinzufügen | `survivalplus.claim.trust` |
+| `/claim unclaim` | Claim löschen | `survivalplus.claim.use` |
-| `/claim removemember <player>` | Spieler entfernen | `survivalplus.claim.trust` |
+| `/claim unclaim <Spieler>` | Alle Claims löschen (Admin) | `survivalplus.claim.admin` |
-| `/claim info` | Claim-Informationen anzeigen | `survivalplus.claim.use` |
+| `/claim trust <Spieler>` | Spieler hinzufügen | `survivalplus.claim.trust` |
-| `/claim list` | Eigene Claims auflisten | `survivalplus.claim.use` |
+| `/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 | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/sp cb add <cmd>` | Befehl zur Blockliste hinzufügen | `survivalplus.commandblocker.add` |
+|------|------|-----------|
-| `/sp cb remove <cmd>` | Befehl entfernen | `survivalplus.commandblocker.remove` |
+| `/sp cb add <cmd>` | Befehl blockieren | `survivalplus.commandblocker.add` |
-| `/sp cb list` | Blockierte Befehle anzeigen | `survivalplus.commandblocker.list` |
+| `/sp cb remove <cmd>` | Blockierung entfernen | `survivalplus.commandblocker.remove` |
-| `/clearchat` | Chat löschen | `survivalplus.clearchat` |
+| `/sp cb list` | Blockierte Befehle | `survivalplus.commandblocker.list` |
-| `/clearitems` | Items aufsammeln/entfernen | `survivalplus.clearitems` |
+| `/clearchat` | Chat leeren | `survivalplus.clearchat` |
-| `/closedoors <radius>` | Türen in Radius schließen | `survivalplus.closedoors` |
+| `/clearitems` | Items entfernen | `survivalplus.clearitems` |
-| `/sp lock /unlock/friendadd/friendremove [player]` | Kisten/Türen sperren / freigeben | `survivalplus.lock` |
+| `/closedoors <radius>` | Türen schließen | `survivalplus.closedoors` |
 | `/sp lock` | Kisten/Türen sperren | `survivalplus.lock` |
 ---
 ### Shop, Loot & Trade
-| Befehl | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/shop add <item> <basispreis> <lagerbestand>` | Shop verwalten | `survivalplus.shop` |
+|------|------|-----------|
-| `/lootchests` | Listet Loot-Kisten auf (Admins teleportieren) | `survivalplus.lootchests` |
+| **Sign Shops** | `[Buy] Menge Item Preis` | automatisch |
-| `/tploot <welt> <x> <y> <z>` | Teleportiere zu Loot-Kiste (Admin) | `survivalplus.lootchests` |
+| `/shop add <item> <preis> <bestand>` | Shop verwalten | `survivalplus.shop` |
-| `/trade <Spieler>` | Startet Handel | `survivalplus.trade` |
+| `/lootchests` | Loot-Kisten auflisten | `survivalplus.lootchests` |
-| `/tradeaccept <Spieler>` | Akzeptiert Handel | `survivalplus.tradeaccept` |
+| `/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 | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/day` | Setzt Zeit auf Tag | `survivalplus.day` |
+|------|------|-----------|
-| `/night` | Setzt Zeit auf Nacht | `survivalplus.night` |
+| `/day` | Tag setzen | `survivalplus.day` |
-| `/gm <modus> [spieler]` (alias `gamemode`) | Spielmodus ändern | `survivalplus.gamemode` |
+| `/night` | Nacht setzen | `survivalplus.night` |
-| `/heal [spieler]` | Heilt Spieler (oder andere) | `survivalplus.heal`, `survivalplus.heal.others` |
+| `/gm <modus>` | Gamemode ändern | `survivalplus.gamemode` |
 | `/heal [Spieler]` | Spieler heilen | `survivalplus.heal` |
 ---
 ### Freundes-, Block- & Report-System
-| Befehl | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/friend [add/accept/deny/list/del/tp] [Spieler]` | Freundschaften verwalten | `survivalplus.friend` |
+|------|------|-----------|
 | `/friend add|accept|deny` | Freundesverwaltung | — |
 | `/block <Spieler>` | Spieler blockieren | `survivalplus.block` |
-| `/unblock <Spieler>` | Unblock | `survivalplus.unblock` |
+| `/unblock <Spieler>` | Blockierung aufheben | `survivalplus.unblock` |
-| `/blocklist` | Blockierte Spieler anzeigen | `survivalplus.blocklist` |
+| `/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 | Usage | Permission |
+
-|---|---:|:---|
+| Befehl | Nutzung | Permission |
-| `/stats` | Spielerstatistiken anzeigen | `survivalplus.stats` |
+|------|------|-----------|
-| `/kit` | Starterkit erhalten | `survivalplus.kit` |
+| `/stats` | Spielerstatistiken | `survivalplus.stats` |
 | `/kit` | Starterkit | `survivalplus.kit` |
 | `/startchallenge <name>` | Fun-Challenge starten | `survivalplus.startchallenge` |
 | `/lootchests` | Übersicht über Lootkisten | `survivalplus.lootchests` |
 | `/sit` | Hinsetzen | `survivalplus.sit` |
 | `/ride` | Auf spieler Reiten | `survivalplus.ride` |
 ---
 ## 🔐 Permissions (Kurzüberblick)
 Vollständige Permission-Deklaration findest du in `plugin.yml`.  
 Wichtige Permissions:
- `survivalplus.*` — Vollzugriff (OP)  
+- `survivalplus.*` — Vollzugriff (OP)
- `survivalplus.sp` — Zugriff auf `/sp` (Hauptbefehl)  
+- `survivalplus.sp` — Zugriff auf Hauptbefehl
- `survivalplus.homes.*` — Homes verwalten  
+- `survivalplus.claim.use / trust / admin` — Claim-System
- `survivalplus.claim.use` / `survivalplus.claim.trust` — Claim-Management & Trust  
+- `survivalplus.vanish.silent` — Silent Join
- `survivalplus.shop` — Shopverwaltung  
+- `survivalplus.vanish.no-pickup` — Keine Item-Aufnahme
- `survivalplus.lootchests` — Lootchest-Adminrechte  
+- `survivalplus.head` — `/head` nutzen
- `survivalplus.notify` — Admin-Benachrichtigung bei Besitz von Command/Structure-Blocks  
+- `survivalplus.notify` — Admin-Benachrichtigungen
- uvm. — siehe `plugin.yml` für die vollständige Liste
+
 ➡ Vollständige Liste: **plugin.yml**
 ---
 ## ⚙ Installation
-1. Lade die aktuelle `.jar` Datei herunter.  
+1. Aktuelle `.jar` herunterladen  
-2. Kopiere sie in den `plugins`-Ordner deines Servers.  
+2. In den `plugins/` Ordner legen  
-3. Starte den Server neu oder nutze `/reload`.  
+3. **LuckPerms** und **Vault** installieren  
-4. Stelle sicher, dass **LuckPerms** und **PlaceholderAPI** installiert sind.
+4. Server neu starten oder `/reload`
 ---
 ## 🐞 Debug & Fehlerberichte
- Aktiviere in `config.yml` `debug-logging: true` wenn du Probleme hast.  
+- In `config.yml` setzen:  
-  - `Debug/debug.log` — enthält Plugin-Fehler/Stacktraces (nur wenn aktiviert).  
+  ```yml
-  - `Debug/console.log` — dupliziert den Konsolenoutput (komplette Ausgabe), damit du diesen als Datei an Entwickler schicken kannst.
+  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. Für Fragen, Bug-Reports oder Feature-Wünsche: **M_Viper** (Repo-Owner / Gitea).
 ---
 Dieses Projekt ist frei für den **privaten Gebrauch**.
 **Kontakt / Support / Feature-Wünsche:**  
 **M_Viper** (Repo-Owner / GitHub)