Kraak de code: Los de Minecraft-pantser- en uitrustingsfouten op in versie 1.21
Problemen met Minecraft-pantser in Java 1.21 wijzen niet op één universele bug of één magische reparatieopdracht. Verlies van duurzaamheid, ontbrekende betoveringen, beschadigde pantsertexturen en zwakke bescherming kunnen verschillende oorzaken hebben: normale spelmechanismen, een verouderd itemformaat, een resourcepack, een mod of een serverplugin. Begin met een back-up van een testkopie, controleer of het probleem zich voordoet in de standaardversie van Minecraft en repareer vervolgens de component of add-on die hiervoor verantwoordelijk is.
Deze handleiding is voor Minecraft: Java Edition 1.21 . Bedrock Edition gebruikt een ander add-on- en itemsysteem, dus de Java-commando's en mod-stappen in deze handleiding zijn daar niet van toepassing.
Bescherm je wereld voordat je de versnellingsgegevens wijzigt.
- Sluit Minecraft af. Voor een server moet je het programma volledig afsluiten voordat je bestanden of plugins bewerkt.
- Kopieer de betreffende wereld en alle relevante mod-, datapack-, resourcepack- en serverconfiguratiemappen. Los het probleem op met de kopie, niet met je enige savegame.
- Noteer de exacte spelversie, modloader en -versie, modlijst, serversoftware en of het probleem zich voordoet in de singleplayer-, multiplayer- of beide modi.
Open je enige gemodificeerde wereld niet in een profiel zonder mods om deze te testen. Als de wereld gemodificeerde blokken of objecten bevat, kan het laden en opslaan ervan zonder die mods ervoor zorgen dat er content verloren gaat. Een nieuwe, tijdelijke wereld is veiliger voor een schone vergelijking.
Identificeer eerst het pantsersymptoom.
| Wat je ziet | Waarschijnlijk gebied om te controleren | Veilige eerste test |
| Het pantser slijt sneller dan verwacht. | Opgelopen schade, een mod die items verandert, een datapack of een serverplugin | Vergelijk hetzelfde pantser in een nieuwe, onbewerkte testwereld. |
| Betoveringen verdwijnen na het herladen of overzetten van het spel. | Artikelgegevensconversie of code die artikelgegevens onjuist schrijft. | Controleer een nieuw aangemaakt item en bekijk het logboek rondom het opslaan of overzetten. |
| Het pantser ziet er gebarsten uit, flikkert of gebruikt de verkeerde textuur. | Assets uit resourcepakketten, aangepaste modelregels, shaders of client-side mods | Schakel pakketten en visuele mods één voor één uit. |
| Beveiliging lijkt alleen op een server anders te werken. | Serverplugins, aangepaste attributen, een schaderegel of een mismatch tussen client en server. | Vergelijk met een lokale back-up en controleer het serverlogboek. |
| Curse of Vanishing gedraagt zich onvoorspelbaar. | Het voorwerp heeft mogelijk niet de betovering, of de afhandeling van de dood door de server kan de drops beïnvloeden. | Controleer het exacte item en test het sterftegedrag in een wegwerp-vanillawereld. |
Het gedrag van bepantsering kan variëren afhankelijk van de bron van de schade en de spelregels, dus één gevechtsontmoeting bewijst niet dat een voorwerp beschadigd is. Reproduceer dezelfde situatie met een onbeschadigd voorwerp voordat je gegevens wijzigt.
Los Minecraft-pantserfouten op in vier stappen.
1. Reproduceer het probleem en sla de logbestanden op.
Gebruik de gekopieerde wereld of een nieuwe testwereld en herhaal de kleinste reeks acties die het probleem veroorzaken. Noteer of het elk pantseronderdeel of slechts één aangepast item betreft, en of het begint na het uitrusten, sterven, opnieuw inloggen, van dimensie veranderen of het betreden van een server.
Voor de Java-editie, controleer logs/latest.logalle relevante bestanden in crash-reportsde speldirectory. Serverbeheerders moeten de logbestanden logs/latest.logen crashrapporten van de server controleren. Zoek naar de eerste foutmelding rond het tijdstip waarop het probleem zich voordoet, inclusief de naam van een mod of plugin. Als u een logbestand openbaar deelt, verwijder dan eerst accounttokens, privéserveradressen en andere persoonlijke gegevens.
2. Sluit resource packs en rendering add-ons uit.
Schakel actieve resource packs en shaders uit en herstart de testwereld. Als de bepantsering er normaal uitziet, schakel dan één pack tegelijk weer in totdat het visuele probleem terugkeert. Controleer of de bestanden van het pack zich in de verwachte naamruimte en item- of pantsertextuurpaden bevinden en gebruik een pack dat is gemaakt voor de exacte Minecraft-patch die je gebruikt.
De oorspronkelijke Java 1.21-release van Mojang vermeldt datapackversie 48 en resourcepackversie 34. Deze waarden duiden de basisversie 1.21 aan; latere 1.21.x-updates kunnen de vereisten voor datapacks en het gedrag van het itemmodel wijzigen. Met name Java 1.21.4 heeft minecraft:custom_model_datade regels voor het itemmodel uitgebreid en bijgewerkt. Vermijd het kopiëren van een oude model-override naar een andere patch zonder de release-opmerkingen van die patch te raadplegen. Zie de release-opmerkingen van Java 1.21 en Java 1.21.4 .
3. Isoleer mods, datapacks en serverplugins.
Controleer of elke mod compatibel is met jouw specifieke Minecraft-patch en -loader. Een mod die is gemaakt voor een 1.21.x-versie werkt mogelijk niet correct met een andere versie, zelfs als de versienummers op elkaar lijken. Update de loader, de vereiste API's en de betreffende mod als een compatibele set; installeer geen willekeurige vervangende versie van een onofficiële downloadpagina.
Voor een client-side modpack, gebruik een gekopieerd profiel of een tijdelijke wereld en schakel de helft van de verdachte add-ons tegelijk uit. Herhaal dit met de helft waarbij het probleem zich nog steeds voordoet. Deze binaire zoekmethode lokaliseert de oorzaak sneller dan het afzonderlijk verwijderen van elke mod. Verwijder geen wereldcontent-mods uit je primaire savegame.
Voor Paper of een andere server die op plug-ins draait, stop de server en maak een back-up voordat u gaat testen. Reproduceer het probleem op een testomgeving, schakel vervolgens plug-ins in groepen uit en achterhaal de verantwoordelijke plug-in. Controleer de officiële documentatie en compatibiliteitsinformatie voordat u een update uitvoert. De handleiding voor probleemoplossing van Paper raadt aan om logbestanden, back-ups, plug-inupdates en binaire zoekopdrachten te gebruiken bij het diagnosticeren van plug-inproblemen.
4. Controleer de itemcomponenten in plaats van de oude NBT-aannames voor items.
Een belangrijke bron van kwetsbaarheden in de uitrustingscode van Minecraft 1.21 is oude code die nog steeds verwacht dat itemgegevens het formaat van vóór versie 1.20.5 gebruiken. Java 1.20.5 heeft de manier waarop itemstacks worden opgeslagen aangepast, zodat ze nu gebruikmaken van data-componenten voor eigenschappen zoals schade, betoveringen en attribuutmodificaties. Zo wordt bijvoorbeeld de minecraft:damageschade van een item bijgehouden, minecraft:enchantmentsworden de betoveringen opgeslagen en minecraft:attribute_modifiersworden de itemmodificaties opgeslagen.
De oude commandovorm waarbij willekeurige NBT-waarden van items tussen accolades werden geplaatst, is verwijderd voor itemcommando's. Een eenvoudig Java 1.21-testitem met Unbreaking kan worden aangemaakt in een wegwerpomgeving waar je toestemming hebt om commando's te gebruiken:
/give @s minecraft:netherite_chestplate[minecraft:enchantments={levels:{'minecraft:unbreaking':3}}]
Als een schoon testitem werkt, maar een aangepast item na een herlaadbeurt of serveroverdracht niet meer werkt, controleer dan de mod, datapack of plugin die dat item aanmaakt of herschrijft. Werk de serializer of itemgeneratiegegevens bij voor het componentformaat dat door jouw specifieke versie wordt gebruikt. Plak geen willekeurig Java-fragment in een mod: item-API's en -mappings verschillen per loader en release. De officiële release-opmerkingen van Java 1.20.5 beschrijven de nieuwe itemsyntaxis en -componenten, inclusief de vervangingen voor oude enchantment- en attribute-tags.
Gebruik evenmin een oud modelpredicaat of een verzonnen pantserattribuutcommando als universele oplossing. Vergelijk een schoon item met het aangetaste item, controleer welk onderdeel of welke toevoeging verschilt en wijzig alleen de bevestigde bron. Het oude NBT-codevoorbeeld en het attribuutfragment in veel tutorials van vóór versie 1.20.5 komen mogelijk niet meer overeen met Java 1.21.
Als de snelle controles het probleem niet oplossen
Laat de originele wereld ongewijzigd en verzamel een klein, nuttig rapport: de exacte Minecraft-versie, Java- of Bedrock-editie, loader- en add-on-versies, de stappen om het probleem te reproduceren, of het zich voordoet in een schoon, standaard Minecraft-profiel, en het relevante log- of crashrapportgedeelte. Voor multiplayer, voeg de serversoftware toe en of hetzelfde item zich normaal gedraagt in de singleplayer-modus. Deze informatie helpt een mod-auteur of serverbeheerder bij het identificeren van een incompatibiliteit in plaats van te moeten gissen.
Kortom, isoleer het symptoom voordat je uitrusting bewerkt: test een schoon item, verwijder visuele pakketten ter vergelijking, beperk de toevoegingen op een kopie en inspecteer vervolgens de moderne itemonderdelen. Dit is de betrouwbare manier om Minecraft-pantserfouten in Java 1.21 te verhelpen zonder je hoofdsave te riskeren.