Upload readme.md via GUI

This commit is contained in:
2026-02-05 21:15:10 +00:00
parent 1ca544fadc
commit d2fd8c496d

187
readme.md
View File

@@ -1,73 +1,162 @@
<div align="center">
# SurvivalPlus # SurvivalPlus
### Das ultimative Survival-Plugin für deinen Minecraft Server **Minecraft Plugin für 1.21+**
[![Version](https://img.shields.io/badge/Version-1.1.2--Beta-blue?style=for-the-badge)](https://github.com/username/SurvivalPlus) **Version:** 1.1.3
[![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-green?style=for-the-badge&logo=minecraft)](https://www.minecraft.net/) **Autor:** M_Viper
[![Java](https://img.shields.io/badge/Java-21+-orange?style=for-the-badge&logo=openjdk)](https://openjdk.org/)
[![Spigot](https://img.shields.io/badge/Spigot-API-yellow?style=for-the-badge)](https://www.spigotmc.org/)
--- ---
**SurvivalPlus** erweitert dein Minecraft Survival-Erlebnis mit uber 50 Befehlen, umfangreichen Schutzsystemen und zahlreichen Quality-of-Life Features. Entwickelt fur Performance und einfache Konfiguration. ## 📦 Übersicht & Features
</div> **SurvivalPlus** erweitert das klassische Minecraft-Survival mit Komfort, Schutz und Admin-Tools:
- Homes, Warps, Teleportsystem (Tpa, Back, Spawn)
- Claim-System (Anti-Grief, Trust, Ban, Kick, Claim-Infos)
- Inventar- & Enderchest-Management (auch für Admins)
- Freundesliste, Block- & Report-System
- Shop-System, Lootchests, Sign Shops (Vault)
- Player Heads, Vanish, Freeze, Ride, Sitzfunktion
- CommandBlocker, Clearchat, Clearitems, Closedoors, Lock-System
- Animierte Tablist, bStats, Debug-Logging, umfangreiche Konfiguration
--- ---
## 📦 Beschreibung ## 🛠 Befehle (Commands)
**SurvivalPlus** ist ein umfangreiches Minecraft-Plugin zur Verbesserung des klassischen Survival-Erlebnisses. Alle Befehle und Permissions findest du auch in der **plugin.yml**. Hier die wichtigsten:
Es kombiniert Komfort-Features für Spieler mit leistungsstarken Verwaltungs- und Schutzmechanismen für Serverbetreiber.
Enthalten sind unter anderem: | Befehl | Beschreibung | Permission |
Homes, Teleports, Inventar- & Enderchest-Verwaltung, Claims (Anti-Grief), Freundeslisten, Shop-System, Loot-Kisten, Tablist-Anpassungen, Player Heads, erweiterte Vanish-Funktionen sowie zahlreiche Server-Utilities. |--------|--------------|------------|
| /sp | Hauptbefehl (Info, Reload, Help, Share, CommandBlocker) | survivalplus.sp |
| /help | Hilfe & Übersicht | survivalplus.sp |
| /ir <Name> | Item umbenennen | survivalplus.itemrename |
| /workbench | Werkbank-GUI öffnen | survivalplus.workbench |
| /anvil | Amboss-GUI öffnen | survivalplus.anvil |
| /trash | Mülleimer öffnen | survivalplus.trash |
| /showarmorstands | Debug: ArmorStands sichtbar | survivalplus.showarmorstands |
| /cleardebugarmorstands | Debug-ArmorStands entfernen | survivalplus.cleardebugarmorstands |
| /leashcount | Geleinte Tiere anzeigen | survivalplus.leashcount |
| /nick <Name> | Nickname setzen | survivalplus.nick |
| /head <Spieler> | Spieler-Kopf erhalten | survivalplus.head |
| /vanish | Unsichtbar werden | survivalplus.vanish |
| /freeze <Spieler> | Spieler einfrieren | survivalplus.freeze |
| /ride [Spieler] | Reite einen Spieler | survivalplus.ride |
| /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 |
| /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 |
| /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 ... | Claim-System verwalten | survivalplus.claim.* |
| /sp cb ... | CommandBlocker verwalten | survivalplus.commandblocker.* |
| /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 ... | 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 |
| /day | Tag setzen | survivalplus.day |
| /night | Nacht setzen | survivalplus.night |
| /gm <Modus> | Gamemode ändern | survivalplus.gamemode |
| /heal [Spieler] | Spieler heilen | survivalplus.heal |
| /friend ... | Freundesverwaltung | survivalplus.friend |
| /block <Spieler> | Spieler blockieren | survivalplus.block |
| /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 |
| /stats | Spielerstatistiken | survivalplus.stats |
| /kit | Starterkit | survivalplus.kit |
| /startchallenge <Name> | Fun-Challenge starten | survivalplus.startchallenge |
| /sit | Hinsetzen | survivalplus.sit |
--- ---
## ⚡ Highlights / Features ## 🔐 Permissions
- **Homes & Warps** - `survivalplus.*` — Vollzugriff (OP)
Persönliche Warps, Home-Management, GUI-Übersichten - `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
- **Teleportation & Anfrage-System** ➡ Vollständige Liste: **plugin.yml**
`/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
--- ---
## Befehlsübersicht ## ⚙️ Installation & Setup
1. Aktuelle `.jar` herunterladen
2. In den `plugins/` Ordner legen
3. **LuckPerms** und **Vault** installieren (empfohlen)
4. Server neu starten oder `/reload`
5. Konfigurationsdateien (`config.yml`, `lang.yml`, `help.yml`, etc.) nach Wunsch anpassen
---
## ⚙️ Konfiguration & Platzhalter
- **Alle Nachrichten**: In `lang.yml` anpassbar (außer feste Plugin-Infos)
- **Hilfe & Gruppen**: In `help.yml` strukturierbar
- **Tablist**: In `tablist.yml` animierbar
- **Shop, Claims, Homes, etc.**: Eigene YAML-Dateien
- **Platzhalter**: `%player%`, `%x%`, `%y%`, `%z%`, `%world%`, `{item}`, `{price}`, `{stock}` u.v.m.
---
## 🐞 Debug & Fehlerberichte
- In `config.yml` aktivieren:
```yml
debug-logging: true
```
- Logs: `Debug/debug.log` (Fehler, Stacktraces), `Debug/console.log` (Konsolenausgabe)
---
## 📊 Statistiken & bStats
- Anonyme Nutzungsstatistiken via [bStats](https://bstats.org/plugin/bukkit/SurvivalPlus)
---
## 📜 Lizenz & Support
Dieses Projekt ist **frei für privaten Gebrauch**.
**Kontakt / Support / Feature-Wünsche:**
- [SpigotMC-Profil](https://www.spigotmc.org/resources/authors/m-lukas-17.618600/)
- [Bugtracker](https://git.viper.ipv64.net/M_Viper/Survival-Plus/issues)
---
## ❓ FAQ & Hinweise
- **Welche Minecraft-Version?** 1.21+ (Paper/Spigot/Bukkit)
- **Welche Plugins werden unterstützt?** LuckPerms, Vault, PlaceholderAPI, ProtocolLib (softdepend)
- **Wie kann ich alle Texte anpassen?** Über `lang.yml` und `help.yml`
- **Wie kann ich Claims, Shops, Homes sichern?** YAML-Dateien im `plugins/SurvivalPlus/`-Ordner
- **Wie kann ich Fehler melden?** Siehe Support-Links oben
---
> **Hinweis:** > **Hinweis:**
> Alle Commands sind vollständig in der `plugin.yml` definiert. > Alle Commands sind vollständig in der `plugin.yml` definiert.