diff --git a/07-fehlerbehebung.-.md b/07-fehlerbehebung.-.md new file mode 100644 index 0000000..4ed0a31 --- /dev/null +++ b/07-fehlerbehebung.-.md @@ -0,0 +1,349 @@ +# Fehlerbehebung + +Hier findest du Losungen fur haufige Probleme. + +--- + +## Plugin ladt nicht + +### Symptom +Das Plugin erscheint nicht in `/plugins` oder zeigt "red" (rot) an. + +### Losungen + +**1. Prufe die Minecraft-Version** +``` +Das Plugin benotigt Minecraft 1.21 oder hoher! +``` + +**2. Prufe die Java-Version** +``` +Das Plugin benotigt Java 21 oder hoher! + +Prufen mit: java -version +``` + +**3. Prufe die Konsole auf Fehler** +Schaue beim Serverstart in die Konsole. Suche nach: +``` +[SurvivalPlus] ERROR: ... +``` + +**4. Lad die .jar neu herunter** +Vielleicht ist die Datei beschadigt. + +--- + +## Befehle funktionieren nicht + +### Symptom +Beim Eingeben eines Befehls passiert nichts oder "Unknown command". + +### Losungen + +**1. Prufe die Schreibweise** +``` +Richtig: /sethome basis +Falsch: /set home basis +Falsch: /sethome!basis +``` + +**2. Prufe die Permission** +Der Spieler braucht die richtige Permission. Prufe mit LuckPerms: +``` +/lp user permission check +``` + +**3. Ist der Befehl blockiert?** +Prufe mit: +``` +/sp cb list +``` + +**4. Plugin neu laden** +``` +/sp reload +``` + +--- + +## "Du hast keine Berechtigung" + +### Symptom +Spieler bekommen "Du hast keine Berechtigung" obwohl sie es haben sollten. + +### Losungen + +**1. Prufe die Permission genau** +``` +/lp user permission check survivalplus.homes +``` + +**2. Prufe die Gruppe** +``` +/lp user parent info +``` + +**3. Permission explizit setzen** +``` +/lp user permission set survivalplus.homes true +``` + +**4. Ist der Spieler OP?** +OPs haben alle Rechte. Zum Testen: +``` +/deop +``` + +--- + +## Homes/Warps/Claims gehen verloren + +### Symptom +Nach Server-Neustart sind Daten weg. + +### Losungen + +**1. Server richtig stoppen** +Immer mit `/stop` beenden, NIEMALS den Prozess killen! + +**2. Dateien prufen** +Schaue in: +``` +plugins/SurvivalPlus/homes.yml +plugins/SurvivalPlus/warps.yml +plugins/SurvivalPlus/claims.yml +``` + +Sind die Dateien leer? Dann wurden sie uberschrieben. + +**3. Backup wiederherstellen** +Hast du Backups? Stelle die .yml Dateien wieder her. + +--- + +## Graber funktionieren nicht + +### Symptom +Beim Tod wird kein Grab erstellt. + +### Losungen + +**1. Permission prufen** +Der Spieler braucht: `survivalplus.graves` + +**2. Ist Keep-Inventory an?** +Wenn Keep-Inventory aktiv ist, gibt es keine Graber (weil keine Items droppen). + +Prufe in config.yml: +```yaml +set-keepinventory: false # Auf false setzen fur Graber +``` + +**3. Wurde das Grab erstellt aber nicht gefunden?** +Das Grab ist unsichtbar. Gehe zu den Koordinaten und drucke Rechtsklick. + +--- + +## Shop funktioniert nicht + +### Symptom +Shop zeigt keine Items oder kaufen funktioniert nicht. + +### Losungen + +**1. Vault installiert?** +Der Shop braucht Vault! Prufe: +``` +/plugins +``` +Vault sollte grun sein. + +**2. Economy-Plugin installiert?** +Vault braucht ein Economy-Plugin (z.B. EssentialsX, CMI). + +**3. shop.yml prufen** +Schaue ob Items definiert sind: +```yaml +items: + DIAMOND: + price: 100 + stock: 1000 +``` + +--- + +## Claim-Schutz funktioniert nicht + +### Symptom +Andere konnen in meinem Claim bauen. + +### Losungen + +**1. Ist der Claim richtig erstellt?** +Prufe mit: +``` +/claim info +``` + +**2. Hat der Spieler Trust?** +Prufe in `/claim info` ob der Spieler unter "Trusted" steht. + +**3. Ist der Spieler OP?** +OPs konnen uberall bauen. + +**4. Ist der Spieler Admin?** +Admins mit `survivalplus.claim.admin` konnen uberall bauen. + +--- + +## Lock funktioniert nicht + +### Symptom +Gesperrte Truhen konnen von anderen geoffnet werden. + +### Losungen + +**1. Ist der Block wirklich gesperrt?** +Prufe mit: +``` +/splock info +``` +(dann auf den Block klicken) + +**2. Ist der andere Spieler OP?** +OPs konnen alles offnen. + +**3. Hat der andere Spieler Friend-Zugriff?** +Prufe mit `/splock info` ob er unter "Friends" steht. + +--- + +## Server laggt + +### Symptom +Der Server hat Lag, TPS fallen. + +### Losungen + +**1. Mob-Cap aktivieren** +In config.yml: +```yaml +mob-cap: + enabled: true + max-animals-per-chunk: 10 +``` + +**2. Auto-Clear aktivieren** +In config.yml: +```yaml +auto-clear-enabled: true +auto-clear-interval-minutes: 5 # Alle 5 Minuten Items loschen +``` + +**3. Debug-Logging deaktivieren** +In config.yml: +```yaml +debug-logging: false +``` + +**4. Graber-Zeit reduzieren** +In config.yml: +```yaml +graves: + despawn-time: 600 # Nur 10 Minuten statt 30 +``` + +--- + +## Fehler in der Konsole + +### NullPointerException + +**Bedeutet:** Etwas ist null, das nicht null sein sollte. + +**Losung:** +1. Plugin neu laden: `/sp reload` +2. Server neustarten +3. Wenn es weiterhin auftritt: config.yml loschen und neu generieren lassen + +--- + +### ClassNotFoundException + +**Bedeutet:** Eine Klasse fehlt. + +**Losung:** +1. Richtige Minecraft-Version? (1.21+) +2. Plugin neu herunterladen +3. Abhangigkeiten prufen + +--- + +### FileNotFoundException + +**Bedeutet:** Eine Datei fehlt. + +**Losung:** +1. Server neustarten (Dateien werden automatisch erstellt) +2. Manuell leere Datei erstellen + +--- + +### YAMLException + +**Bedeutet:** Eine .yml Datei hat einen Syntaxfehler. + +**Losung:** +1. Finde die fehlerhafte Datei (steht in der Fehlermeldung) +2. Prufe die Datei auf: + - Fehlende Doppelpunkte + - Falsche Einruckung (immer 2 Leerzeichen!) + - Fehlende Anfuhrungszeichen bei Texten mit Sonderzeichen +3. Oder: Datei loschen und neu generieren lassen + +--- + +## config.yml zurucksetzen + +Wenn gar nichts mehr hilft: + +1. Server stoppen +2. `plugins/SurvivalPlus/config.yml` loschen +3. Server starten +4. Neue config.yml wird automatisch erstellt +5. Einstellungen neu vornehmen + +**WARNUNG:** Alle Einstellungen gehen verloren! + +--- + +## Alle Daten zurucksetzen + +**LETZTE OPTION - ALLE DATEN GEHEN VERLOREN!** + +1. Server stoppen +2. Den ganzen Ordner `plugins/SurvivalPlus/` loschen +3. Server starten +4. Alles wird neu erstellt + +Dies loscht: +- Alle Homes +- Alle Warps +- Alle Claims +- Alle Statistiken +- Alle Einstellungen + +--- + +## Support kontaktieren + +Wenn nichts hilft: + +1. Sammle diese Informationen: + - Minecraft-Version + - Plugin-Version + - Vollstandige Fehlermeldung aus der Konsole + - Was du getan hast bevor der Fehler auftrat + +2. Kontaktiere den Plugin-Entwickler mit diesen Informationen