Add-on-Probleme beheben

Manchmal funktioniert ein Add-on nach der Installation nicht sofort wie erwartet. Keine Sorge, die meisten Probleme lassen sich einfach lösen. In diesem Leitfaden behandeln wir die häufigsten Probleme und wie du sie behebst.

Das Pack wird nicht geladen

Das ist das häufigste Problem. Es gibt verschiedene mögliche Ursachen:

Falsche Ordnerstruktur

Der häufigste Fehler ist, dass das Pack in einer falschen Ordnerstruktur liegt. Prüfe Folgendes:

Die Datei manifest.json muss direkt im Pack-Ordner liegen, nicht in einem extra Unterordner.
Falsch: behavior_packs/cool-mobs/cool-mobs-v1/manifest.json
Richtig: behavior_packs/cool-mobs/manifest.json

Wenn du ein Pack hochgeladen hast und ein extra Ordner darum liegt, verschiebe alle Dateien eine Ebene nach oben, damit manifest.json direkt im Pack-Ordner erreichbar ist.

UUID stimmt nicht überein

Die UUID, die du in world_behavior_packs.json oder world_resource_packs.json eingetragen hast, muss exakt mit der UUID in der manifest.json des Packs übereinstimmen. Prüfe auf:

Tippfehler in der UUID (ein falsches Zeichen reicht, damit es fehlschlägt)
Verwendung der falschen UUID – du brauchst die Header-UUID, nicht die Modul-UUID
Extra Leerzeichen oder Anführungszeichen, die nicht hingehören

Tipp: Kopiere die UUID direkt aus manifest.json, um Tippfehler zu vermeiden. Nutze die Suchfunktion (Strg+F) in deinem Texteditor, um die UUID zu finden.

Versionskonflikt

Es gibt zwei Arten von Versionsproblemen, auf die du stoßen kannst:

Pack-Version stimmt nicht überein – die Version in world_behavior_packs.json oder world_resource_packs.json muss mit der Version in manifest.json übereinstimmen. Hat das Pack Version [1, 2, 0], du aber [1, 0, 0] eingetragen, wird das Pack möglicherweise nicht geladen.
Minecraft-Version ist zu alt – viele Packs haben eine min_engine_version in ihrem Manifest. Wenn dein Server eine ältere Bedrock-Version nutzt als das Pack erfordert, funktioniert es nicht. Prüfe, ob dein Server aktuell ist.

Um die Version deines Servers zu prüfen, schau beim Start in der Console. Dort wird die Bedrock-Version angezeigt.

Ungültige JSON-Syntax

Die Dateien world_behavior_packs.json und world_resource_packs.json müssen gültiges JSON sein. Häufige Fehler sind:

Ein Komma zwischen zwei Pack-Einträgen vergessen
Ein extra Komma nach dem letzten Pack (das ist in JSON nicht erlaubt)
Fehlende geschweifte Klammern { } oder eckige Klammern [ ]
Anführungszeichen um die UUID vergessen

Ein Beispiel für fehlerhaftes JSON:

[
    {
        "pack_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "version": [1, 0, 0]
    },  ← dieses Komma darf nicht stehen, wenn dies der letzte Eintrag ist
]

Und die korrekte Version:

[
    {
        "pack_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "version": [1, 0, 0]
    }
]

Tipp: Nutze einen Online-JSON-Validator wie jsonlint.com, um zu prüfen, ob dein JSON gültig ist.

Konflikte zwischen Packs

Manchmal funktionieren zwei Add-ons nicht gut zusammen. Das kann passieren, wenn:

Zwei Packs denselben Mob, dasselbe Item oder denselben Block anpassen wollen
Zwei Resource Packs dieselben Texturen überschreiben
Packs für verschiedene Bedrock-Versionen erstellt wurden

Um zu testen, ob ein Konflikt vorliegt:

Entferne alle Packs aus world_behavior_packs.json und world_resource_packs.json (mache die Arrays leer: []).
Füge die Packs einzeln wieder hinzu und starte den Server nach jeder Hinzufügung neu.
Wenn der Server mit Pack A funktioniert, aber nicht mehr mit Pack A und B zusammen, hast du den Konflikt gefunden.

Leider gibt es nicht immer eine einfache Lösung für Konflikte. Du musst dann wählen, welches Pack du behalten möchtest, oder nach einer Alternative suchen, die kompatibel ist.

Logs in der Console prüfen

Die Server-Console ist dein bester Freund beim Beheben von Problemen. Hier siehst du Fehlermeldungen, die genau anzeigen, was schiefgeht:

Gehe zu mijn.hytalenode.nl und öffne deinen Server.
Gehe zum Tab Console.
Starte den Server neu und achte auf die Meldungen beim Start.
Suche nach Zeilen, die auf deinen Pack-Namen, die UUID oder Wörter wie error, failed, warning oder could not load verweisen.

Häufige Fehlermeldungen und ihre Bedeutung:

„Pack not found" oder „Could not find pack" – die UUID in der World-Packs-Datei verweist auf ein Pack, das nicht im Ordner behavior_packs/ oder resource_packs/ existiert. Prüfe Ordnerstruktur und UUID.
„Pack version mismatch" – die Version in der World-Packs-Datei stimmt nicht mit der Version in manifest.json überein.
„Invalid manifest" – die manifest.json des Packs ist ungültig oder beschädigt. Lade das Pack erneut herunter.

Ein Pack entfernen

Wenn ein Pack Probleme verursacht und du es vollständig entfernen möchtest, folge diesen Schritten:

Pack deaktivieren – öffne world_behavior_packs.json oder world_resource_packs.json im Tab Dateien und entferne den Eintrag des Packs aus dem JSON-Array.
Pack-Dateien löschen – gehe zu behavior_packs/ oder resource_packs/ und lösche den Ordner des Packs.
Server neu starten – starte deinen Server über den Tab Console neu, damit die Änderungen wirksam werden.

Achtung: Wenn ein Behavior Pack neue Items oder Mobs zu deiner Welt hinzugefügt hat, können diese nach dem Entfernen verschwinden oder Fehlermeldungen verursachen. Deshalb ist es immer ratsam, vor dem Installieren oder Entfernen von Packs ein Backup deiner Welt zu erstellen. Das geht, indem du deinen Weltordner über den Tab Dateien herunterlädst.

Immer noch Probleme?

Wenn du mit diesem Leitfaden nicht weiterkommst, kannst du jederzeit unser Support-Team kontaktieren. Erstelle ein Ticket über das Panel auf mijn.hytalenode.nl und gib dabei an:

Welches Pack du installieren möchtest (Name und Quelle)
Was du genau gemacht hast (welche Schritte)
Was die Fehlermeldung in der Console lautet
Den Inhalt deiner world_behavior_packs.json und/oder world_resource_packs.json

Mit diesen Informationen können wir dir schnell und gezielt helfen, das Problem zu lösen.