diff --git a/readme.md b/readme.md index 97ab9db..3b9a6c8 100644 --- a/readme.md +++ b/readme.md @@ -1,256 +1,255 @@ -# 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 ` | 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 ` | 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 | Nutzung | Permission | -|------|------|-----------| -| `/tp ` | Teleport zu Spieler | `survivalplus.tp` | -| `/tphere ` | Spieler zu dir teleportieren | `survivalplus.tphere` | -| `/tpa ` | 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 ` | 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 | 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 | 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 | 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 | 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 | Nutzung | Permission | -|------|------|-----------| -| `/friend add|accept|deny` | Freundesverwaltung | — | -| `/block ` | Spieler blockieren | `survivalplus.block` | -| `/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 | Nutzung | Permission | -|------|------|-----------| -| `/stats` | Spielerstatistiken | `survivalplus.stats` | -| `/kit` | Starterkit | `survivalplus.kit` | -| `/startchallenge ` | 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) +# SurvivalPlus + +**Minecraft Plugin** + +**Version:** _bitte eintragen_ +**Author:** M_Viper + +--- + +## 📦 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 ` | 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 ` | 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 | Nutzung | Permission | +|------|------|-----------| +| `/tp ` | Teleport zu Spieler | `survivalplus.tp` | +| `/tphere ` | Spieler zu dir teleportieren | `survivalplus.tphere` | +| `/tpa ` | 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 ` | 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 | 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 | 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 | 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 | 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 | Nutzung | Permission | +|------|------|-----------| +| `/friend add|accept|deny` | Freundesverwaltung | — | +| `/block ` | Spieler blockieren | `survivalplus.block` | +| `/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 | Nutzung | Permission | +|------|------|-----------| +| `/stats` | Spielerstatistiken | `survivalplus.stats` | +| `/kit` | Starterkit | `survivalplus.kit` | +| `/startchallenge ` | 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)