readme.md aktualisiert

This commit is contained in:
2026-01-22 20:00:13 +00:00
parent 40295f3711
commit 197acc6750

527
readme.md
View File

@@ -1,255 +1,272 @@
# SurvivalPlus <div align="center">
**Minecraft Plugin** # SurvivalPlus
**Version:** _bitte eintragen_ ### Das ultimative Survival-Plugin für deinen Minecraft Server
**Author:** M_Viper
[![Version](https://img.shields.io/badge/Version-1.1.2--Beta-blue?style=for-the-badge)](https://github.com/username/SurvivalPlus)
--- [![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-green?style=for-the-badge&logo=minecraft)](https://www.minecraft.net/)
[![Java](https://img.shields.io/badge/Java-21+-orange?style=for-the-badge&logo=openjdk)](https://openjdk.org/)
## 📦 Beschreibung [![Spigot](https://img.shields.io/badge/Spigot-API-yellow?style=for-the-badge)](https://www.spigotmc.org/)
**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.
**SurvivalPlus** erweitert dein Minecraft Survival-Erlebnis mit uber 50 Befehlen, umfangreichen Schutzsystemen und zahlreichen Quality-of-Life Features. Entwickelt fur Performance und einfache Konfiguration.
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. [Wiki](wiki/gitea/Home.md) |
[Installation](#installation) |
--- [Features](#features) |
[Befehle](#befehle) |
## ⚡ Highlights / Features [Konfiguration](#konfiguration) |
[Support](#support)
- **Homes & Warps**
Persönliche Warps, Home-Management, GUI-Übersichten </div>
- **Teleportation & Anfrage-System** ---
`/tpa`, `/tpaccept`, `/tpdeny`, `/back`, `/spawn`
## 📦 Beschreibung
- **Claim-System (Anti-Grief)**
Land sichern, Trust/Untrust, Ban/Kick, Claim-Infos **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.
- **Inventar- & Enderchest-Verwaltung**
Admin-Zugriff auf Fremd-Inventare 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.
- **Neu: Player Heads**
Köpfe bei Tod oder per `/head` Befehl ---
- **Neu: Erweiterte Vanish-Funktionen** ## ⚡ Highlights / Features
Silent Join, keine Item-Aufnahme
- **Homes & Warps**
- **Neu: Sign Shops** Persönliche Warps, Home-Management, GUI-Übersichten
Schilder-Shops mit Vault-Integration
- **Teleportation & Anfrage-System**
- **Shop-System & Lootchests** `/tpa`, `/tpaccept`, `/tpdeny`, `/back`, `/spawn`
Verwaltung & Teleport zu Loot-Kisten
- **Claim-System (Anti-Grief)**
- **CommandBlocker & Server-Utilities** Land sichern, Trust/Untrust, Ban/Kick, Claim-Infos
Clearchat, Clearitems, Closedoors, Lock-System
- **Inventar- & Enderchest-Verwaltung**
- **Debug-Logging** Admin-Zugriff auf Fremd-Inventare
Optionales Logging in `debug.log` & `console.log`
- **Neu: Player Heads**
- **Tablist** Köpfe bei Tod oder per `/head` Befehl
Animiert & konfigurierbar über `tablist.yml`
- **Neu: Erweiterte Vanish-Funktionen**
- **bStats Unterstützung** Silent Join, keine Item-Aufnahme
Anonyme Statistiken
- **Neu: Sign Shops**
--- Schilder-Shops mit Vault-Integration
## 🛠 Komplette Befehlsübersicht - **Shop-System & Lootchests**
Verwaltung & Teleport zu Loot-Kisten
> **Hinweis:**
> Alle Commands sind vollständig in der `plugin.yml` definiert. - **CommandBlocker & Server-Utilities**
> Nachfolgend eine Übersicht nach Kategorien. Clearchat, Clearitems, Closedoors, Lock-System
--- - **Debug-Logging**
Optionales Logging in `debug.log` & `console.log`
### Allgemein / Haupt
- **Tablist**
| Befehl | Nutzung | Permission | Animiert & konfigurierbar über `tablist.yml`
|------|------|-----------|
| `/sp` | Hauptbefehl (Reload, Info, Help, Share, CommandBlocker u.v.m.) | `survivalplus.sp` | - **bStats Unterstützung**
| `/help` | Hilfe / Übersicht (Alias: `/sp help`) | `survivalplus.sp` | Anonyme Statistiken
--- ---
### Item & Utility ## 🛠 Komplette Befehlsübersicht
| Befehl | Nutzung | Permission | > **Hinweis:**
|------|------|-----------| > Alle Commands sind vollständig in der `plugin.yml` definiert.
| `/ir <name>` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` | > Nachfolgend eine Übersicht nach Kategorien.
| `/workbench` | Öffnet Werkbank-GUI | `survivalplus.workbench` |
| `/anvil` | Öffnet Amboss-GUI | `survivalplus.anvil` | ---
| `/trash` | Öffnet Mülleimer | `survivalplus.trash` |
| `/showarmorstands` | Debug: ArmorStands sichtbar | `survivalplus.showarmorstands` | ### Allgemein / Haupt
| `/cleardebugarmorstands` | Entfernt Debug-ArmorStands | `survivalplus.cleardebugarmorstands` |
| `/leashcount` | Zeigt geleinte Tiere | `survivalplus.leashcount` | | Befehl | Nutzung | Permission |
| `/nick <Name>` | Nickname setzen (Farben/Hex) | `survivalplus.nick` | |------|------|-----------|
| `/nick off` | Nickname entfernen | `survivalplus.nick` | | `/sp` | Hauptbefehl (Reload, Info, Help, Share, CommandBlocker u.v.m.) | `survivalplus.sp` |
| `/head <Spieler>` | Spieler-Kopf erhalten | `survivalplus.head` | | `/help` | Hilfe / Übersicht (Alias: `/sp help`) | `survivalplus.sp` |
--- ---
### Admin & Tools ### Item & Utility
| Befehl | Nutzung | Permission | | Befehl | Nutzung | Permission |
|------|------|-----------| |------|------|-----------|
| `/vanish` | Unsichtbar (Silent, No-Pickup optional) | `survivalplus.vanish` | | `/ir <name>` | Item umbenennen (Item in Hand) | `survivalplus.itemrename` |
| `/freeze <Spieler>` | Spieler einfrieren | `survivalplus.freeze` | | `/workbench` | Öffnet Werkbank-GUI | `survivalplus.workbench` |
| `/ride [Spieler]` | Reite einen Spieler | `survivalplus.ride` | | `/anvil` | Öffnet Amboss-GUI | `survivalplus.anvil` |
| `/trash` | Öffnet Mülleimer | `survivalplus.trash` |
--- | `/showarmorstands` | Debug: ArmorStands sichtbar | `survivalplus.showarmorstands` |
| `/cleardebugarmorstands` | Entfernt Debug-ArmorStands | `survivalplus.cleardebugarmorstands` |
### Teleportation | `/leashcount` | Zeigt geleinte Tiere | `survivalplus.leashcount` |
| `/nick <Name>` | Nickname setzen (Farben/Hex) | `survivalplus.nick` |
| Befehl | Nutzung | Permission | | `/nick off` | Nickname entfernen | `survivalplus.nick` |
|------|------|-----------| | `/head <Spieler>` | Spieler-Kopf erhalten | `survivalplus.head` |
| `/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` | ### Admin & Tools
| `/tpdeny` | Anfrage ablehnen | `survivalplus.tpdeny` |
| `/back` | Zum letzten Todespunkt | `survivalplus.back` | | Befehl | Nutzung | Permission |
| `/spawn` | Zum Weltspawn | `survivalplus.spawn` | |------|------|-----------|
| `/setspawn` | Server-Spawn setzen | `survivalplus.setspawn` | | `/vanish` | Unsichtbar (Silent, No-Pickup optional) | `survivalplus.vanish` |
| `/setworldspawn` | Welt-Spawn setzen | `survivalplus.setworldspawn` | | `/freeze <Spieler>` | Spieler einfrieren | `survivalplus.freeze` |
| `/ride [Spieler]` | Reite einen Spieler | `survivalplus.ride` |
---
---
### Homes & Warps
### Teleportation
| Befehl | Nutzung | Permission |
|------|------|-----------| | Befehl | Nutzung | Permission |
| `/sethome <name>` | Home setzen | `survivalplus.homes.set` | |------|------|-----------|
| `/delhome <name>` | Home löschen | `survivalplus.homes.delete` | | `/tp <Spieler>` | Teleport zu Spieler | `survivalplus.tp` |
| `/home <name>` | Zu Home teleportieren | `survivalplus.homes` | | `/tphere <Spieler>` | Spieler zu dir teleportieren | `survivalplus.tphere` |
| `/homelist` | GUI mit allen Homes | `survivalplus.homes.list` | | `/tpa <Spieler>` | Teleportanfrage senden | `survivalplus.tpa` |
| `/setwarp <name>` | Persönlichen Warp setzen | `survivalplus.setwarp` | | `/tpaccept` | Anfrage akzeptieren | `survivalplus.tpaccept` |
| `/delwarp <name>` | Warp löschen | `survivalplus.delwarp` | | `/tpdeny` | Anfrage ablehnen | `survivalplus.tpdeny` |
| `/warps` | Warp-GUI öffnen | `survivalplus.warps` | | `/back` | Zum letzten Todespunkt | `survivalplus.back` |
| `/spawn` | Zum Weltspawn | `survivalplus.spawn` |
--- | `/setspawn` | Server-Spawn setzen | `survivalplus.setspawn` |
| `/setworldspawn` | Welt-Spawn setzen | `survivalplus.setworldspawn` |
### Claim (Anti-Grief)
---
| Befehl | Nutzung | Permission |
|------|------|-----------| ### Homes & Warps
| `/claim mark 1|2` | Auswahlpunkt setzen | — |
| `/claim` | Gebiet claimen | `survivalplus.claim.use` | | Befehl | Nutzung | Permission |
| `/claim unclaim` | Claim löschen | `survivalplus.claim.use` | |------|------|-----------|
| `/claim unclaim <Spieler>` | Alle Claims löschen (Admin) | `survivalplus.claim.admin` | | `/sethome <name>` | Home setzen | `survivalplus.homes.set` |
| `/claim trust <Spieler>` | Spieler hinzufügen | `survivalplus.claim.trust` | | `/delhome <name>` | Home löschen | `survivalplus.homes.delete` |
| `/claim untrust <Spieler>` | Spieler entfernen | `survivalplus.claim.trust` | | `/home <name>` | Zu Home teleportieren | `survivalplus.homes` |
| `/claim ban <Spieler>` | Spieler bannen | `survivalplus.claim.ban` | | `/homelist` | GUI mit allen Homes | `survivalplus.homes.list` |
| `/claim kick <Spieler>` | Spieler kicken | `survivalplus.claim.kick` | | `/setwarp <name>` | Persönlichen Warp setzen | `survivalplus.setwarp` |
| `/claim info` | Claim-Infos anzeigen | `survivalplus.claim.use` | | `/delwarp <name>` | Warp löschen | `survivalplus.delwarp` |
| `/warps` | Warp-GUI öffnen | `survivalplus.warps` |
---
---
### CommandBlocker / Server-Management
### Claim (Anti-Grief)
| Befehl | Nutzung | Permission |
|------|------|-----------| | Befehl | Nutzung | Permission |
| `/sp cb add <cmd>` | Befehl blockieren | `survivalplus.commandblocker.add` | |------|------|-----------|
| `/sp cb remove <cmd>` | Blockierung entfernen | `survivalplus.commandblocker.remove` | | `/claim mark 1|2` | Auswahlpunkt setzen | — |
| `/sp cb list` | Blockierte Befehle | `survivalplus.commandblocker.list` | | `/claim` | Gebiet claimen | `survivalplus.claim.use` |
| `/clearchat` | Chat leeren | `survivalplus.clearchat` | | `/claim unclaim` | Claim löschen | `survivalplus.claim.use` |
| `/clearitems` | Items entfernen | `survivalplus.clearitems` | | `/claim unclaim <Spieler>` | Alle Claims löschen (Admin) | `survivalplus.claim.admin` |
| `/closedoors <radius>` | Türen schließen | `survivalplus.closedoors` | | `/claim trust <Spieler>` | Spieler hinzufügen | `survivalplus.claim.trust` |
| `/sp lock` | Kisten/Türen sperren | `survivalplus.lock` | | `/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` |
### Shop, Loot & Trade
---
| Befehl | Nutzung | Permission |
|------|------|-----------| ### CommandBlocker / Server-Management
| **Sign Shops** | `[Buy] Menge Item Preis` | automatisch |
| `/shop add <item> <preis> <bestand>` | Shop verwalten | `survivalplus.shop` | | Befehl | Nutzung | Permission |
| `/lootchests` | Loot-Kisten auflisten | `survivalplus.lootchests` | |------|------|-----------|
| `/tploot <welt> <x> <y> <z>` | Zu Loot-Kiste teleportieren | `survivalplus.lootchests` | | `/sp cb add <cmd>` | Befehl blockieren | `survivalplus.commandblocker.add` |
| `/trade <Spieler>` | Handel starten | `survivalplus.trade` | | `/sp cb remove <cmd>` | Blockierung entfernen | `survivalplus.commandblocker.remove` |
| `/tradeaccept <Spieler>` | Handel annehmen | `survivalplus.tradeaccept` | | `/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` |
### Zeit, Gamemode & Admin | `/sp lock` | Kisten/Türen sperren | `survivalplus.lock` |
| Befehl | Nutzung | Permission | ---
|------|------|-----------|
| `/day` | Tag setzen | `survivalplus.day` | ### Shop, Loot & Trade
| `/night` | Nacht setzen | `survivalplus.night` |
| `/gm <modus>` | Gamemode ändern | `survivalplus.gamemode` | | Befehl | Nutzung | Permission |
| `/heal [Spieler]` | Spieler heilen | `survivalplus.heal` | |------|------|-----------|
| **Sign Shops** | `[Buy] Menge Item Preis` | automatisch |
--- | `/shop add <item> <preis> <bestand>` | Shop verwalten | `survivalplus.shop` |
| `/lootchests` | Loot-Kisten auflisten | `survivalplus.lootchests` |
### Freundes-, Block- & Report-System | `/tploot <welt> <x> <y> <z>` | Zu Loot-Kiste teleportieren | `survivalplus.lootchests` |
| `/trade <Spieler>` | Handel starten | `survivalplus.trade` |
| Befehl | Nutzung | Permission | | `/tradeaccept <Spieler>` | Handel annehmen | `survivalplus.tradeaccept` |
|------|------|-----------|
| `/friend add|accept|deny` | Freundesverwaltung | — | ---
| `/block <Spieler>` | Spieler blockieren | `survivalplus.block` |
| `/unblock <Spieler>` | Blockierung aufheben | `survivalplus.unblock` | ### Zeit, Gamemode & Admin
| `/blocklist` | Blockliste anzeigen | `survivalplus.blocklist` |
| `/report <Spieler> [Grund]` | Spieler melden | `survivalplus.report` | | Befehl | Nutzung | Permission |
| `/showreport <Spieler>` | Reports anzeigen | `survivalplus.report.show` | |------|------|-----------|
| `/clearreport <Spieler>` | Reports löschen | `survivalplus.report.clear` | | `/day` | Tag setzen | `survivalplus.day` |
| `/night` | Nacht setzen | `survivalplus.night` |
--- | `/gm <modus>` | Gamemode ändern | `survivalplus.gamemode` |
| `/heal [Spieler]` | Spieler heilen | `survivalplus.heal` |
### Sonstiges
---
| Befehl | Nutzung | Permission |
|------|------|-----------| ### Freundes-, Block- & Report-System
| `/stats` | Spielerstatistiken | `survivalplus.stats` |
| `/kit` | Starterkit | `survivalplus.kit` | | Befehl | Nutzung | Permission |
| `/startchallenge <name>` | Fun-Challenge starten | `survivalplus.startchallenge` | |------|------|-----------|
| `/sit` | Hinsetzen | `survivalplus.sit` | | `/friend add|accept|deny` | Freundesverwaltung | — |
| `/block <Spieler>` | Spieler blockieren | `survivalplus.block` |
--- | `/unblock <Spieler>` | Blockierung aufheben | `survivalplus.unblock` |
| `/blocklist` | Blockliste anzeigen | `survivalplus.blocklist` |
## 🔐 Permissions (Kurzüberblick) | `/report <Spieler> [Grund]` | Spieler melden | `survivalplus.report` |
| `/showreport <Spieler>` | Reports anzeigen | `survivalplus.report.show` |
- `survivalplus.*` — Vollzugriff (OP) | `/clearreport <Spieler>` | Reports löschen | `survivalplus.report.clear` |
- `survivalplus.sp` — Zugriff auf Hauptbefehl
- `survivalplus.claim.use / trust / admin` — Claim-System ---
- `survivalplus.vanish.silent` — Silent Join
- `survivalplus.vanish.no-pickup` — Keine Item-Aufnahme ### Sonstiges
- `survivalplus.head``/head` nutzen
- `survivalplus.notify` — Admin-Benachrichtigungen | Befehl | Nutzung | Permission |
|------|------|-----------|
➡ Vollständige Liste: **plugin.yml** | `/stats` | Spielerstatistiken | `survivalplus.stats` |
| `/kit` | Starterkit | `survivalplus.kit` |
--- | `/startchallenge <name>` | Fun-Challenge starten | `survivalplus.startchallenge` |
| `/sit` | Hinsetzen | `survivalplus.sit` |
## ⚙ Installation
---
1. Aktuelle `.jar` herunterladen
2. In den `plugins/` Ordner legen ## 🔐 Permissions (Kurzüberblick)
3. **LuckPerms** und **Vault** installieren
4. Server neu starten oder `/reload` - `survivalplus.*` — Vollzugriff (OP)
- `survivalplus.sp` — Zugriff auf Hauptbefehl
--- - `survivalplus.claim.use / trust / admin` — Claim-System
- `survivalplus.vanish.silent` — Silent Join
## 🐞 Debug & Fehlerberichte - `survivalplus.vanish.no-pickup` — Keine Item-Aufnahme
- `survivalplus.head``/head` nutzen
- In `config.yml` setzen: - `survivalplus.notify` — Admin-Benachrichtigungen
```yml
debug-logging: true ➡ Vollständige Liste: **plugin.yml**
```
---
## 🐞 Debug & Logs
## ⚙ Installation
- `Debug/debug.log` — Enthält Plugin-Fehler und Stacktraces (nur bei aktiviertem Debug-Logging)
- `Debug/console.log` — Kompletter Konsolenoutput zur Weitergabe an Entwickler 1. Aktuelle `.jar` herunterladen
2. In den `plugins/` Ordner legen
--- 3. **LuckPerms** und **Vault** installieren
4. Server neu starten oder `/reload`
## 📜 Lizenz & Kontakt
---
Dieses Projekt ist frei für den **privaten Gebrauch**.
## 🐞 Debug & Fehlerberichte
**Kontakt / Support / Feature-Wünsche:**
**M_Viper** (Repo-Owner / GitHub) - 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)