diff --git a/01-installation.-.md b/01-installation.-.md new file mode 100644 index 0000000..daa9b0e --- /dev/null +++ b/01-installation.-.md @@ -0,0 +1,166 @@ +# Installation + +Diese Anleitung erklart Schritt fur Schritt, wie du SurvivalPlus installierst. + +--- + +## Voraussetzungen + +Bevor du loslegst, brauchst du: + +- Einen **Minecraft-Server** (Paper, Spigot oder Bukkit) +- Minecraft Version **1.21** oder hoher +- **Java 21** oder hoher +- (Optional) **Vault** fur Economy-Funktionen +- (Optional) **LuckPerms** fur erweiterte Berechtigungen +- (Optional) **PlaceholderAPI** fur Platzhalter in der Tablist + +--- + +## Schritt 1: Plugin herunterladen + +Lade die `SurvivalPlus.jar` Datei herunter. + +--- + +## Schritt 2: Server stoppen + +**WICHTIG:** Stoppe deinen Server BEVOR du das Plugin hinzufugst! + +**So stoppst du den Server:** +1. Gehe in die Server-Konsole +2. Tippe `stop` und drucke Enter +3. Warte, bis der Server komplett beendet ist + +--- + +## Schritt 3: Plugin kopieren + +1. Offne den Ordner deines Minecraft-Servers +2. Gehe in den Ordner `plugins` +3. Kopiere die `SurvivalPlus.jar` in diesen Ordner + +**Beispiel-Pfad:** +``` +/home/minecraft/server/plugins/SurvivalPlus.jar +``` + +--- + +## Schritt 4: Server starten + +1. Starte deinen Server wieder +2. Warte, bis der Server vollstandig geladen ist +3. Schaue in die Konsole - du solltest diese Nachricht sehen: + +``` +[SurvivalPlus] Plugin wurde erfolgreich geladen! +``` + +--- + +## Schritt 5: Konfiguration uberprufen + +Nach dem ersten Start werden automatisch alle Konfigurationsdateien erstellt. + +Du findest sie hier: +``` +plugins/SurvivalPlus/ + config.yml <- Hauptkonfiguration + lang.yml <- Nachrichten + warps.yml <- Gespeicherte Warps + homes.yml <- Gespeicherte Homes + claims.yml <- Gespeicherte Claims + stats.yml <- Spieler-Statistiken + friends.yml <- Freundeslisten + graves.yml <- Aktive Graber + shop.yml <- Shop-Konfiguration + tablist.yml <- Tablist-Einstellungen + blockedcommands.yml <- Blockierte Befehle + backpacks.yml <- Rucksack-Daten + leashes.yml <- Leinen-Daten +``` + +--- + +## Optionale Plugins installieren + +### Vault (fur Economy) + +Vault wird benotigt fur: +- Reparatur-Schilder (kosten Geld) +- Shop-System + +**Installation:** +1. Lade Vault herunter +2. Kopiere es in den `plugins`-Ordner +3. Installiere ein Economy-Plugin wie EssentialsX oder CMI +4. Starte den Server neu + +### LuckPerms (fur Berechtigungen) + +LuckPerms ermoglicht: +- Gruppen mit unterschiedlichen Rechten +- Prafixe und Suffixe +- Detaillierte Berechtigungsverwaltung + +**Installation:** +1. Lade LuckPerms herunter +2. Kopiere es in den `plugins`-Ordner +3. Starte den Server neu +4. Konfiguriere LuckPerms nach Bedarf + +### PlaceholderAPI (fur Tablist) + +PlaceholderAPI ermoglicht: +- Dynamische Platzhalter in der Tablist +- Spieler-Statistiken anzeigen + +**Installation:** +1. Lade PlaceholderAPI herunter +2. Kopiere es in den `plugins`-Ordner +3. Starte den Server neu + +--- + +## Erste Einrichtung + +Nach der Installation solltest du: + +1. **Spawn setzen:** `/setspawn` +2. **Welt-Spawn setzen:** `/setworldspawn` +3. **config.yml anpassen** (siehe [Konfiguration](02-konfiguration.md)) +4. **Permissions einrichten** (siehe [Permissions](05-permissions.md)) + +--- + +## Update auf neue Version + +1. Stoppe den Server +2. Losche die alte `SurvivalPlus.jar` +3. Kopiere die neue `SurvivalPlus.jar` in den `plugins`-Ordner +4. Starte den Server + +**WICHTIG:** Losche NIEMALS den `SurvivalPlus`-Ordner! Sonst verlierst du alle Daten! + +--- + +## Deinstallation + +Falls du das Plugin entfernen mochtest: + +1. Stoppe den Server +2. Losche die `SurvivalPlus.jar` aus dem `plugins`-Ordner +3. (Optional) Losche den `SurvivalPlus`-Ordner fur alle Daten +4. Starte den Server + +--- + +## Probleme bei der Installation? + +Schau in die [Fehlerbehebung](07-fehlerbehebung.md) oder prufe: + +1. Ist die richtige Minecraft-Version installiert? (1.21+) +2. Ist Java 21 oder hoher installiert? +3. Gibt es Fehlermeldungen in der Konsole? +4. Sind alle optionalen Plugins kompatibel?