Oplossing voor laadfouten van add-ons in Minecraft Bedrock 1.21: een veilige stapsgewijze handleiding.

Als een Minecraft Bedrock-add-on niet laadt , maak dan eerst een kopie van de betreffende wereld en controleer vervolgens of het pakket is geïmporteerd, geactiveerd in die wereld en compatibel is met jouw exacte spelversie. Als het probleem zich blijft voordoen, schakel dan de pakketten in de kopie uit en schakel ze één voor één weer in. Een probleem met het laden van mods in Bedrock kan worden veroorzaakt door een beschadigde import, een manifest- of afhankelijkheidsfout, een versie-mismatch of twee pakketten die dezelfde inhoud overschrijven.

Bedrock noemt deze bestanden add-ons , meestal bestaande uit resource packs, behavior packs of beide. Mods voor de Java Edition zijn niet uitwisselbaar met Bedrock add-ons. De term "Minecraft mod loading error" beschrijft verschillende symptomen in plaats van één officiële foutcode, dus de juiste oplossing hangt af van wanneer het probleem zich voordoet.

Identificeer waar de add-on faalt.

• Importeren stopt of meldt een fout: mogelijk is de download onvolledig, is het bestandstype onjuist of is de pakketstructuur niet leesbaar voor Minecraft.
• Het pakket wordt wel geïmporteerd, maar ontbreekt in de wereldeditor: controleer het manifest, de bestandsextensie en of het een gedrags- of resourcepakket is.
• Het pakket geeft een waarschuwing weer of wordt niet geactiveerd: controleer de waarschuwing op een ontbrekende afhankelijkheid of een ander manifestprobleem.
• De wereld opent zich, maar de inhoud ontbreekt of lijkt ongewijzigd: controleer of het juiste pakket actief is en of een ander pakket voorrang heeft.

De handleiding voor Minecraft-ontwikkelaars noemt onjuist opgemaakte manifestbestanden, dubbele of niet-overeenkomende UUID's, ontbrekende afhankelijkheden, bestandsextensies en het stapelen van pakketten als veelvoorkomende probleemgebieden. Ook wordt uitgelegd dat gedrags- en resourcepakketten in de bijbehorende tabbladen worden geselecteerd bij het bewerken van een wereld. Zie de officiële handleiding voor het oplossen van problemen met gedragspakketten .

Bescherm de wereld voordat je problemen oplost.

Test oplossingen niet op de enige kopie van een wereld die voor jou belangrijk is. Gebruik de kopieer- of back-upoptie van Minecraft wanneer deze beschikbaar is en geef de testkopie een duidelijke naam. Noteer de Bedrock-versie, de bron van de add-on en welke uitbreidingspakketten actief zijn. Verwijder de wereld- of pakketmappen niet als eerste stap.

De instructies voor Windows-opslag kunnen verschillen tussen Minecraft-versies. Met name het oude pad naar de Microsoft Store/UWP-map, zoals vermeld in veel oudere handleidingen, is niet langer van toepassing op elke installatie: Microsoft documenteert een migratie van Windows-opslag vanaf Minecraft 1.21.120. Gebruik de padinstructies voor uw geïnstalleerde versie in plaats van een verouderd pad te plakken. Lees de actuele richtlijnen van Microsoft voor Windows-projectmappen .

Los laadfouten van Minecraft Bedrock-add-ons op.

1. Bevestig de editie en de spelversie

Controleer of de download bedoeld is voor Minecraft: Bedrock Edition , niet voor Java Edition, en of deze compatibel is met je platform en gameversie. "1.21" omvat meerdere releases, en preview-versies kunnen zich anders gedragen dan de reguliere release. Houd rekening met het door de maker van het pakket aangegeven compatibiliteitsbereik. Een manifest min_engine_versionis een minimale vereiste; het garandeert niet dat elke functie in het pakket werkt in elke nieuwere release. Microsoft legt dit veld uit in de manifestreferentie .

Update Minecraft via de officiële store of launcher voor je apparaat als de add-on een nieuwere, compatibele versie vereist. Als het probleem direct na een update is ontstaan, controleer dan de release-opmerkingen van de maker voor een compatibele versie van het pakket voordat je zelf bestanden bewerkt.

2. Importeer een schone kopie van het pakket opnieuw.

Als het importeren zelf mislukt, download het pakket dan opnieuw van de maker of gebruik de officiële Marketplace-versie die je bezit. Een .mcpackpakket is een resource- of gedragspakket; een .mcaddonpakket kan meerdere add-on-bestanden bevatten. Wanneer je een pakket opent .mcpackmet Minecraft, zou het spel moeten aangeven of het importeren is gelukt. Als je een ZIP-archief hebt ontvangen, hernoem het dan niet zomaar en ga er niet vanuit dat het geldig is: volg de installatie-instructies van de maker en controleer of het archief de verwachte pakketstructuur bevat.

Voor content uit de Marketplace start je Bedrock op terwijl je bent ingelogd op het account dat eigenaar is van het item. Controleer vervolgens de Marketplace of je eigen content in de game. Het officiële installatieoverzicht voor add-ons beschrijft de importmelding en waar de pakketten beschikbaar komen na import.

3. Activeer het pakket in de betreffende wereld.

Het installeren van een uitbreidingspakket activeert niet automatisch elk pakket in elke wereld. Open vanuit het spelmenu het bewerkings-/instellingenscherm van de wereld en zoek naar 'Add-ons' . Activeer de juiste optie onder 'Gedragspakketten' , 'Bronpakketten ' of beide, afhankelijk van de inhoud van de add-on. Test vervolgens de gekopieerde wereld. De instructies voor het activeren van add-ons in Minecraft beschrijven het proces in het spel zelf.

Als je niet zeker weet of het probleem in de bestaande wereld of in een andere add-on zit, maak dan tijdelijk een nieuwe wereld aan en activeer alleen het verdachte pakket daarin. Als het in de nieuwe wereld wel werkt, concentreer je dan op de actieve pakketten of instellingen van de oorspronkelijke wereld in plaats van het spel opnieuw te installeren.

4. Isoleer conflicterende add-ons

Schakel in de gekopieerde wereld de betreffende add-ons uit en test het opnieuw. Schakel één add-onpakket tegelijk weer in en heropen de wereld na elke wijziging, totdat het probleem terugkeert. Op deze manier wordt het add-onpakket of de combinatie ervan geïdentificeerd die de fout veroorzaakt. Minecraft Support raadt aan om een ​​back-up van een wereld te maken en add-ons individueel uit te schakelen bij het diagnosticeren van spelproblemen; raadpleeg hiervoor de stappen voor het oplossen van add-onproblemen .

Als elk pakket afzonderlijk werkt, maar niet in combinatie met andere pakketten, controleer dan op overlappende inhoud en afhankelijkheden. Twee pakketten die dezelfde entiteit, item, textuur of ander element wijzigen, kunnen elkaar overschrijven. Minecraft gebruikt pack stacking, dus de volgorde kan bepalen welke wijziging zichtbaar is. Herschik in de testversie de betreffende pakketten als het spel die optie biedt en test het opnieuw. Verwijder geen afhankelijkheid die het pakket nodig heeft.

5. Controleer de afhankelijkheden van het behavior-pack en het resource-pack.

Sommige add-ons bevatten een gedragspakket en een apart resourcepakket. Een gedragspakket kan een afhankelijkheid van een resourcepakket declareren door in het manifest te verwijzen naar de UUID en versie van de header van het resourcepakket. Als deze waarden niet overeenkomen, kan het gedrag zonder texturen worden geladen, of kan het pakket een waarschuwing weergeven. De officiële handleiding voor gedragspakketten laat zien hoe de afhankelijkheidslink werkt.

Lees het gedetailleerde bericht dat voor het pakket wordt weergegeven in de Add-ons-instellingen van de wereld. Een waarschuwing voor een ontbrekende afhankelijkheid is nuttiger dan steeds dezelfde bestanden te importeren. Als dit een pakket van iemand anders is, download dan een gecorrigeerde versie of neem contact op met de maker in plaats van willekeurig de UUID's te wijzigen.

6. Als u het pakket hebt gemaakt, valideer dan het manifest ervan.

Bewerk een manifest alleen als u de eigenaar bent van het pakket of precies weet wat elk veld doet. Voor de huidige stabiele gedrags- en resourcepakketten specificeert Microsoft in haar platformrichtlijnen het volgende format_version 2: . Dit is de manifestindeling, niet de Minecraft-spelversie: vervang deze niet door een waarde zoals 1.21.70. De spelvereiste hoort in header.min_engine_version, meestal weergegeven als een driedelige versie zoals [1, 21, 0]. Gebruik een minimaal ondersteunde versie die geschikt is voor de bestanden in uw pakket, in plaats van blindelings een nummer te kopiëren. Zie de platformversierichtlijnen van Microsoft .

• Controleer of het bestand exact dezelfde naam heeft manifest.json, geldige JSON bevat en zich op het hoogste niveau van het pakket bevindt.
• Geef de pakketheader en elke module een geldige UUID. De UUID van de module moet verschillen van de UUID van de pakketheader.
• Voor een opgegeven afhankelijkheid moeten de referenced UUID en versie exact overeenkomen met het manifest van het vereiste pakket.
• Houd het moduletype en de bestanden consistent: gedragspakketten gebruiken datamodules; resourcepakketten gebruiken resourcemodules.

De manifestreferentiedocumenten van Microsoft beschrijven deze velden. Een JSON-validator kan ontbrekende komma's, accolades of aanhalingstekens detecteren, maar kan niet bevestigen dat de inhoud van een pakket compatibel is of dat de afhankelijkheden correct zijn.

Platformnotities

• Windows: vermijd het gebruik van oude mappaden die zijn gekopieerd uit handleidingen van vóór de migratie. Gebruik de huidige locatie van uw geïnstalleerde versie en maak een back-up voordat u bestanden handmatig verplaatst.
• Android en iOS: toegang tot bestanden is afhankelijk van het apparaat en de app-versie. Wis niet eerst de app-gegevens van Minecraft en verwijder het spel niet; deze acties kunnen lokale werelden in gevaar brengen als er geen back-up van is gemaakt.
• Console: gebruik de in-game Marketplace en de wereldinstellingen voor ondersteunde content. Instructies voor bestandsbeheer op de desktop zijn niet van toepassing op opslag op de console.

Wanneer moet je opnieuw installeren en hoe voorkom je dat het weer gebeurt?

Het opnieuw installeren van Minecraft is een laatste redmiddel, niet de eerste oplossing voor add-onproblemen. Controleer voordat je de software verwijdert of alle belangrijke werelden een back-up hebben met een methode die door je apparaat wordt ondersteund. Als slechts één uitbreidingspakket defect is, verwijder of vervang dat pakket dan in plaats van alle spelgegevens te wissen. Voor items uit de Marketplace moet je het account van de eigenaar verifiëren en de content opnieuw downloaden via Minecraft.

Voor toekomstige installaties is het raadzaam een ​​schone back-up te maken voordat je uitbreidingspakketten toevoegt aan een bestaande wereld, onbekende add-ons te testen in een kopie of een nieuwe wereld, één pakket tegelijk te installeren en de compatibiliteitsnotities van de maker te bewaren. Dit maakt het gemakkelijker om een ​​laadfout van een Minecraft Bedrock-add-on op te sporen zonder dat je een langlopende savegame riskeert.

Veelgestelde vragen

Kan ik Java Edition-mods gebruiken in Bedrock?

Nee. Java-mods zijn gemaakt voor een andere editie. Bedrock gebruikt add-ons die zijn gemaakt van resource packs en/of behavior packs, dus download een Bedrock-compatibele versie van de content.

Zal het wijzigen min_engine_versionvan de add-on een incompatibel probleem oplossen?

Niet op zichzelf. Dat veld geeft de minimale spelversie aan die het pakket vereist; het wijzigen ervan converteert geen niet-ondersteunde bestanden, werkt scripts niet bij en herstelt geen afhankelijkheden. Gebruik een release die geschikt is voor jouw spelversie, of werk je eigen pakket bij en valideer het aan de hand van de documentatie voor pakketmakers van Microsoft.