Add-on problemen oplossen

Soms werkt een add-on niet meteen zoals verwacht na installatie. Geen zorgen, de meeste problemen zijn eenvoudig op te lossen. In deze gids behandelen we de meest voorkomende problemen en hoe je ze kunt verhelpen.

Het pack wordt niet geladen

Dit is het meest voorkomende probleem. Er zijn verschillende oorzaken mogelijk:

Verkeerde mapstructuur

De meest voorkomende fout is dat het pack in een verkeerde mapstructuur staat. Controleer het volgende:

Het bestand manifest.json moet direct in de pack-map staan, niet in een extra submap.
Fout: behavior_packs/cool-mobs/cool-mobs-v1/manifest.json
Goed: behavior_packs/cool-mobs/manifest.json

Als je een pack hebt geüpload en er staat een extra map omheen, verplaats dan alle bestanden één niveau omhoog zodat manifest.json direct bereikbaar is in de pack-map.

UUID komt niet overeen

De UUID die je hebt ingevuld in world_behavior_packs.json of world_resource_packs.json moet exact overeenkomen met de UUID in het manifest.json bestand van het pack. Controleer op:

Typfouten in de UUID (een verkeerd karakter is genoeg om het te laten falen)
Het gebruik van de verkeerde UUID – je hebt de header UUID nodig, niet de module UUID
Extra spaties of aanhalingstekens die er niet horen

Tip: kopieer de UUID direct uit manifest.json om typfouten te voorkomen. Gebruik de zoekfunctie (Ctrl+F) in je tekstverwerker om de UUID te vinden.

Versie mismatch

Er zijn twee soorten versie-problemen die je kunt tegenkomen:

Pack versie komt niet overeen – de versie in world_behavior_packs.json of world_resource_packs.json moet overeenkomen met de versie in manifest.json. Als het pack versie [1, 2, 0] heeft maar je hebt [1, 0, 0] ingevuld, wordt het pack mogelijk niet geladen.
Minecraft versie is te oud – veel packs hebben een min_engine_version in hun manifest. Als je server op een oudere Bedrock versie draait dan het pack vereist, zal het niet werken. Controleer of je server up-to-date is.

Om de versie van je server te controleren, kijk in de console bij het opstarten. Daar wordt de Bedrock versie weergegeven.

Ongeldige JSON syntax

De bestanden world_behavior_packs.json en world_resource_packs.json moeten geldige JSON zijn. Veelgemaakte fouten zijn:

Een komma vergeten tussen twee pack-entries
Een extra komma na het laatste pack (dit mag niet in JSON)
Ontbrekende accolades { } of vierkante haken [ ]
Aanhalingstekens vergeten rond de UUID

Een voorbeeld van foutieve JSON:

[
    {
        "pack_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "version": [1, 0, 0]
    },  ← deze komma mag niet als dit het laatste item is
]

En de correcte versie:

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

Tip: gebruik een online JSON validator zoals jsonlint.com om te controleren of je JSON geldig is.

Conflicten tussen packs

Soms werken twee add-ons niet goed samen. Dit kan gebeuren als:

Twee packs dezelfde mob, item of blok proberen aan te passen
Twee resource packs dezelfde textures overschrijven
Packs zijn gemaakt voor verschillende Bedrock versies

Om te testen of er een conflict is:

Verwijder alle packs uit world_behavior_packs.json en world_resource_packs.json (maak de arrays leeg: []).
Voeg de packs een voor een terug toe en herstart de server na elke toevoeging.
Als de server goed werkt met pack A maar niet meer met pack A en B samen, heb je het conflict gevonden.

Helaas is er niet altijd een eenvoudige oplossing voor conflicten. Je zult dan moeten kiezen welk pack je wilt behouden, of zoeken naar een alternatief pack dat wel compatibel is.

Logs controleren in de console

De server console is je beste vriend bij het oplossen van problemen. Hier zie je foutmeldingen die exact aangeven wat er mis gaat:

Ga naar mijn.hytalenode.nl en open je server.
Ga naar de Console tab.
Herstart de server en let op de berichten die verschijnen tijdens het opstarten.
Zoek naar regels die verwijzen naar je pack naam, UUID, of woorden als error, failed, warning of could not load.

Veelvoorkomende foutmeldingen en hun betekenis:

"Pack not found" of "Could not find pack" – de UUID in het world packs bestand verwijst naar een pack dat niet bestaat in de behavior_packs/ of resource_packs/ map. Controleer de mapstructuur en UUID.
"Pack version mismatch" – de versie in het world packs bestand komt niet overeen met de versie in manifest.json.
"Invalid manifest" – het manifest.json bestand van het pack is ongeldig of beschadigd. Download het pack opnieuw.

Een pack verwijderen

Als een pack problemen veroorzaakt en je wilt het volledig verwijderen, volg dan deze stappen:

Deactiveer het pack – open world_behavior_packs.json of world_resource_packs.json in de Bestanden tab en verwijder de entry van het pack uit de JSON-array.
Verwijder de pack-bestanden – ga naar behavior_packs/ of resource_packs/ en verwijder de map van het pack.
Herstart de server – herstart je server via de Console tab zodat de wijzigingen worden doorgevoerd.

Let op: als een Behavior Pack nieuwe items of mobs heeft toegevoegd aan je wereld, kunnen deze na het verwijderen verdwijnen of foutmeldingen veroorzaken. Het is daarom altijd verstandig om een backup van je wereld te maken voordat je packs installeert of verwijdert. Dit kun je doen door je wereldmap te downloaden via de Bestanden tab.

Nog steeds problemen?

Als je er met deze gids niet uitkomt, kun je altijd contact opnemen met ons ondersteuningsteam. Maak een ticket aan via het panel op mijn.hytalenode.nl en vermeld daarbij: