diff --git a/readme.md b/readme.md index 39237af..97ab9db 100644 --- a/readme.md +++ b/readme.md @@ -1,174 +1,256 @@ # SurvivalPlus -![Minecraft Plugin](https://img.shields.io/badge/Minecraft-Plugin-green) -![Version](https://img.shields.io/badge/version-1.1.1-blue) -![Author](https://img.shields.io/badge/author-M_Viper-yellow) +**Minecraft Plugin** -**SurvivalPlus** ist ein Minecraft-Plugin zur Verbesserung des Survival-Erlebnisses. -Es bietet Homes, Teleports, Inventar-/Enderchest-Verwaltung, Claims (Anti-Grief), Freundeslisten, Shop-System, Loot-Kisten, Tablist-Anpassungen und viele Komfort-Utilities. +![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) -- Teleportation & Anfrage-System (`/tpa`, `/tpaccept`, `/tpdeny`) -- Claim-System zur Land-Sicherung (trust/untrust, create/delete, info, list) -- Inventar- & Enderchest-Verwaltung (öffnen von Fremd-Inventaren, Admin-Tools) -- Shop-System & Lootchests (Verwaltung, Teleport zu Lootchests) -- CommandBlocker & Server-Utilities (clearchat, clearitems, closedoors, lock) -- Debug-Logging (optionale `debug-logging` in config, Debug/debug.log & Debug/console.log) -- Tablist (animiert / konfigurierbar über `tablist.yml`) -- bStats Unterstützung (Statistiken) +- **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: 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` | -| `/help` (alias über `/sp help`) | Hilfe / Übersicht | `survivalplus.sp` | +|------|------|-----------| +| `/sp` | Hauptbefehl (Reload, Info, Help, Share, CommandBlocker u.v.m.) | `survivalplus.sp` | +| `/help` | Hilfe / Übersicht (Alias: `/sp help`) | `survivalplus.sp` | + +--- ### Item & Utility -| Befehl | Usage | Permission | -|---|---:|:---| -| `/ir ` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/ir ` | 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` | -| `/nick ` | Nickname ändern (Farben/Hex möglich) | `survivalplus.nick` | -| `/nick off` | Entfernt den Nickname wieder (Zurücksetzen zum echten Namen). | `survivalplus.nick` | -| `/nick reset` | Alias für /nick off | `survivalplus.nick` | -| `/nick remove` | Alias für /nick off | `survivalplus.nick` | +| `/leashcount` | Zeigt geleinte Tiere | `survivalplus.leashcount` | +| `/nick ` | Nickname setzen (Farben/Hex) | `survivalplus.nick` | +| `/nick off` | Nickname entfernen | `survivalplus.nick` | +| `/head ` | Spieler-Kopf erhalten | `survivalplus.head` | + +--- + +### Admin & Tools + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/vanish` | Unsichtbar (Silent, No-Pickup optional) | `survivalplus.vanish` | +| `/freeze ` | Spieler einfrieren | `survivalplus.freeze` | +| `/ride [Spieler]` | Reite einen Spieler | `survivalplus.ride` | + +--- ### Teleportation -| Befehl | Usage | Permission | -|---|---:|:---| + +| Befehl | Nutzung | Permission | +|------|------|-----------| | `/tp ` | Teleport zu Spieler | `survivalplus.tp` | -| `/tphere ` | Teleportiert Spieler zu dir | `survivalplus.tphere` | +| `/tphere ` | Spieler zu dir teleportieren | `survivalplus.tphere` | | `/tpa ` | Teleportanfrage senden | `survivalplus.tpa` | -| `/tpaccept` | Teleportanfrage annehmen | `survivalplus.tpaccept` | -| `/tpdeny` | Teleportanfrage ablehnen | `survivalplus.tpdeny` | -| `/back` | Zum letzten Todespunkt teleportieren | `survivalplus.back` | -| `/spawn` | Teleport zum Weltspawn | `survivalplus.spawn` | -| `/setspawn` | Setzt Server-Spawn | `survivalplus.setspawn` | -| `/setworldspawn` | Setzt Weltspawn (aktuelle Welt) | `survivalplus.setworldspawn` | +| `/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 | Usage | Permission | -|---|---:|:---| -| `/sethome ` | Setzt Home | `survivalplus.homes.set` | -| `/delhome ` | Löscht Home | `survivalplus.homes.delete` | -| `/home ` | Teleport zu Home | `survivalplus.homes` | -| `/homelist` | GUI mit Homes öffnen | `survivalplus.homes.list` | -| `/setwarp ` | Persönlichen Warp setzen (Item in Hand) | `survivalplus.setwarp` | -| `/delwarp ` | Persönlichen Warp löschen | `survivalplus.delwarp` | -| `/warps` | GUI aller Warps öffnen | `survivalplus.warps` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/sethome ` | Home setzen | `survivalplus.homes.set` | +| `/delhome ` | Home löschen | `survivalplus.homes.delete` | +| `/home ` | Zu Home teleportieren | `survivalplus.homes` | +| `/homelist` | GUI mit allen Homes | `survivalplus.homes.list` | +| `/setwarp ` | Persönlichen Warp setzen | `survivalplus.setwarp` | +| `/delwarp ` | Warp löschen | `survivalplus.delwarp` | +| `/warps` | Warp-GUI öffnen | `survivalplus.warps` | + +--- ### Claim (Anti-Grief) -| Befehl | Usage | Permission | -|---|---:|:---| -| `/claim [unclaim / trust / untrust ]` | Claim-Management (Trust/Untrust/Unclaim) | `survivalplus.claim.use` | -| `/claim create ` (falls implementiert) | Neues Claim anlegen | `survivalplus.claim.use` | -| `/claim delete ` (falls implementiert) | Claim löschen | `survivalplus.claim.use` | -| `/claim addmember ` | Spieler zum Claim hinzufügen | `survivalplus.claim.trust` | -| `/claim removemember ` | Spieler entfernen | `survivalplus.claim.trust` | -| `/claim info` | Claim-Informationen anzeigen | `survivalplus.claim.use` | -| `/claim list` | Eigene Claims auflisten | `survivalplus.claim.use` | + +| 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 ` | Alle Claims löschen (Admin) | `survivalplus.claim.admin` | +| `/claim trust ` | Spieler hinzufügen | `survivalplus.claim.trust` | +| `/claim untrust ` | Spieler entfernen | `survivalplus.claim.trust` | +| `/claim ban ` | Spieler bannen | `survivalplus.claim.ban` | +| `/claim kick ` | Spieler kicken | `survivalplus.claim.kick` | +| `/claim info` | Claim-Infos anzeigen | `survivalplus.claim.use` | + +--- ### CommandBlocker / Server-Management -| Befehl | Usage | Permission | -|---|---:|:---| -| `/sp cb add ` | Befehl zur Blockliste hinzufügen | `survivalplus.commandblocker.add` | -| `/sp cb remove ` | Befehl entfernen | `survivalplus.commandblocker.remove` | -| `/sp cb list` | Blockierte Befehle anzeigen | `survivalplus.commandblocker.list` | -| `/clearchat` | Chat löschen | `survivalplus.clearchat` | -| `/clearitems` | Items aufsammeln/entfernen | `survivalplus.clearitems` | -| `/closedoors ` | Türen in Radius schließen | `survivalplus.closedoors` | -| `/sp lock /unlock/friendadd/friendremove [player]` | Kisten/Türen sperren / freigeben | `survivalplus.lock` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/sp cb add ` | Befehl blockieren | `survivalplus.commandblocker.add` | +| `/sp cb remove ` | Blockierung entfernen | `survivalplus.commandblocker.remove` | +| `/sp cb list` | Blockierte Befehle | `survivalplus.commandblocker.list` | +| `/clearchat` | Chat leeren | `survivalplus.clearchat` | +| `/clearitems` | Items entfernen | `survivalplus.clearitems` | +| `/closedoors ` | Türen schließen | `survivalplus.closedoors` | +| `/sp lock` | Kisten/Türen sperren | `survivalplus.lock` | + +--- ### Shop, Loot & Trade -| Befehl | Usage | Permission | -|---|---:|:---| -| `/shop add ` | Shop verwalten | `survivalplus.shop` | -| `/lootchests` | Listet Loot-Kisten auf (Admins teleportieren) | `survivalplus.lootchests` | -| `/tploot ` | Teleportiere zu Loot-Kiste (Admin) | `survivalplus.lootchests` | -| `/trade ` | Startet Handel | `survivalplus.trade` | -| `/tradeaccept ` | Akzeptiert Handel | `survivalplus.tradeaccept` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| **Sign Shops** | `[Buy] Menge Item Preis` | automatisch | +| `/shop add ` | Shop verwalten | `survivalplus.shop` | +| `/lootchests` | Loot-Kisten auflisten | `survivalplus.lootchests` | +| `/tploot ` | Zu Loot-Kiste teleportieren | `survivalplus.lootchests` | +| `/trade ` | Handel starten | `survivalplus.trade` | +| `/tradeaccept ` | Handel annehmen | `survivalplus.tradeaccept` | + +--- ### Zeit, Gamemode & Admin -| Befehl | Usage | Permission | -|---|---:|:---| -| `/day` | Setzt Zeit auf Tag | `survivalplus.day` | -| `/night` | Setzt Zeit auf Nacht | `survivalplus.night` | -| `/gm [spieler]` (alias `gamemode`) | Spielmodus ändern | `survivalplus.gamemode` | -| `/heal [spieler]` | Heilt Spieler (oder andere) | `survivalplus.heal`, `survivalplus.heal.others` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/day` | Tag setzen | `survivalplus.day` | +| `/night` | Nacht setzen | `survivalplus.night` | +| `/gm ` | Gamemode ändern | `survivalplus.gamemode` | +| `/heal [Spieler]` | Spieler heilen | `survivalplus.heal` | + +--- ### Freundes-, Block- & Report-System -| Befehl | Usage | Permission | -|---|---:|:---| -| `/friend [add/accept/deny/list/del/tp] [Spieler]` | Freundschaften verwalten | `survivalplus.friend` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/friend add|accept|deny` | Freundesverwaltung | — | | `/block ` | Spieler blockieren | `survivalplus.block` | -| `/unblock ` | Unblock | `survivalplus.unblock` | -| `/blocklist` | Blockierte Spieler anzeigen | `survivalplus.blocklist` | +| `/unblock ` | Blockierung aufheben | `survivalplus.unblock` | +| `/blocklist` | Blockliste anzeigen | `survivalplus.blocklist` | | `/report [Grund]` | Spieler melden | `survivalplus.report` | | `/showreport ` | Reports anzeigen | `survivalplus.report.show` | | `/clearreport ` | Reports löschen | `survivalplus.report.clear` | +--- + ### Sonstiges -| Befehl | Usage | Permission | -|---|---:|:---| -| `/stats` | Spielerstatistiken anzeigen | `survivalplus.stats` | -| `/kit` | Starterkit erhalten | `survivalplus.kit` | + +| Befehl | Nutzung | Permission | +|------|------|-----------| +| `/stats` | Spielerstatistiken | `survivalplus.stats` | +| `/kit` | Starterkit | `survivalplus.kit` | | `/startchallenge ` | 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.sp` — Zugriff auf `/sp` (Hauptbefehl) -- `survivalplus.homes.*` — Homes verwalten -- `survivalplus.claim.use` / `survivalplus.claim.trust` — Claim-Management & Trust -- `survivalplus.shop` — Shopverwaltung -- `survivalplus.lootchests` — Lootchest-Adminrechte -- `survivalplus.notify` — Admin-Benachrichtigung bei Besitz von Command/Structure-Blocks -- uvm. — siehe `plugin.yml` für die vollständige Liste +- `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. Lade die aktuelle `.jar` Datei herunter. -2. Kopiere sie in den `plugins`-Ordner deines Servers. -3. Starte den Server neu oder nutze `/reload`. -4. Stelle sicher, dass **LuckPerms** und **PlaceholderAPI** installiert sind. +1. Aktuelle `.jar` herunterladen +2. In den `plugins/` Ordner legen +3. **LuckPerms** und **Vault** installieren +4. Server neu starten oder `/reload` --- ## 🐞 Debug & Fehlerberichte -- Aktiviere in `config.yml` `debug-logging: true` wenn du Probleme hast. - - `Debug/debug.log` — enthält Plugin-Fehler/Stacktraces (nur wenn aktiviert). - - `Debug/console.log` — dupliziert den Konsolenoutput (komplette Ausgabe), damit du diesen als Datei an Entwickler schicken kannst. +- 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. 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)