readme.md aktualisiert
This commit is contained in:
296
readme.md
296
readme.md
@@ -1,174 +1,256 @@
|
||||
# SurvivalPlus
|
||||
|
||||
|
||||
|
||||
|
||||
**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.
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 📦 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 <neuer_name>` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` |
|
||||
|
||||
| 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` | 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 <Name>` | 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 <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 | 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` |
|
||||
| `/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 <name>` | Setzt Home | `survivalplus.homes.set` |
|
||||
| `/delhome <name>` | Löscht Home | `survivalplus.homes.delete` |
|
||||
| `/home <name>` | Teleport zu Home | `survivalplus.homes` |
|
||||
| `/homelist` | GUI mit Homes öffnen | `survivalplus.homes.list` |
|
||||
| `/setwarp <name>` | Persönlichen Warp setzen (Item in Hand) | `survivalplus.setwarp` |
|
||||
| `/delwarp <name>` | Persönlichen Warp löschen | `survivalplus.delwarp` |
|
||||
| `/warps` | GUI aller Warps öffnen | `survivalplus.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 | Usage | 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 delete <name>` (falls implementiert) | Claim löschen | `survivalplus.claim.use` |
|
||||
| `/claim addmember <player>` | Spieler zum Claim hinzufügen | `survivalplus.claim.trust` |
|
||||
| `/claim removemember <player>` | 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 <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 | Usage | Permission |
|
||||
|---|---:|:---|
|
||||
| `/sp cb add <cmd>` | Befehl zur Blockliste hinzufügen | `survivalplus.commandblocker.add` |
|
||||
| `/sp cb remove <cmd>` | 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 <radius>` | 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 <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 | Usage | Permission |
|
||||
|---|---:|:---|
|
||||
| `/shop add <item> <basispreis> <lagerbestand>` | Shop verwalten | `survivalplus.shop` |
|
||||
| `/lootchests` | Listet Loot-Kisten auf (Admins teleportieren) | `survivalplus.lootchests` |
|
||||
| `/tploot <welt> <x> <y> <z>` | Teleportiere zu Loot-Kiste (Admin) | `survivalplus.lootchests` |
|
||||
| `/trade <Spieler>` | Startet Handel | `survivalplus.trade` |
|
||||
| `/tradeaccept <Spieler>` | Akzeptiert Handel | `survivalplus.tradeaccept` |
|
||||
|
||||
| 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 | Usage | Permission |
|
||||
|---|---:|:---|
|
||||
| `/day` | Setzt Zeit auf Tag | `survivalplus.day` |
|
||||
| `/night` | Setzt Zeit auf Nacht | `survivalplus.night` |
|
||||
| `/gm <modus> [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 <modus>` | 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>` | Spieler blockieren | `survivalplus.block` |
|
||||
| `/unblock <Spieler>` | Unblock | `survivalplus.unblock` |
|
||||
| `/blocklist` | Blockierte Spieler anzeigen | `survivalplus.blocklist` |
|
||||
| `/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 | Usage | Permission |
|
||||
|---|---:|:---|
|
||||
| `/stats` | Spielerstatistiken anzeigen | `survivalplus.stats` |
|
||||
| `/kit` | Starterkit erhalten | `survivalplus.kit` |
|
||||
|
||||
| Befehl | Nutzung | Permission |
|
||||
|------|------|-----------|
|
||||
| `/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.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)
|
||||
|
||||
Reference in New Issue
Block a user