Minecraft-foutmelding 'Payload mag niet groter zijn': Hoe los je te grote modpakketten op?
De Minecraft-foutmelding "Payload mag niet groter zijn" betekent dat een client, server, mod of plugin heeft geprobeerd een aangepast netwerkpakket te verzenden dat groter is dan de limiet die door die Minecraft-versie of netwerkimplementatie wordt opgelegd. Als de melding bijvoorbeeld 1048576 bytes1 MiB aangeeft, dan is dat 1 MiB. De oplossing is om de mod of plugin te identificeren die de te grote payload genereert en deze vervolgens bij te werken, een mismatch tussen client en server te corrigeren of deze te verwijderen uit een back-up van een testprofiel.
Dit is doorgaans geen probleem met de grootte van de wereldopslag, een tekort aan Java-heapgeheugen of iets dat kan worden opgelost door monsters te doden. Het wijzigen van geheugenvlaggen verhoogt de maximale pakketgrootte niet. Het verlagen van de zichtafstand kan het normale chunkverkeer verminderen, maar maakt een te grote aangepaste payload niet geldig.
Wat de payloadfout betekent
Minecraft Java gebruikt aangepaste payloadpakketten om extra gegevens tussen een client en een server te verzenden. Mods en serverplugins kunnen deze gebruiken voor synchronisatie, configuratie, aangepaste menu's of andere functies. De pakketcode van Minecraft bevat controles op de payloadgrootte; zo bevat de pakketreferentie van versie 1.21 bijvoorbeeld een MAX_PAYLOAD_SIZEveld voor een clientgebonden aangepast payloadpakket. Het getal dat in uw foutmelding wordt weergegeven, is de bruikbare limiet voor die fout. Deze limiet kan verschillen per versie, pakketrichting of loader, dus ga er niet vanuit dat elke melding "payload te groot" dezelfde drempelwaarde heeft.
De uitzondering kan verschijnen als IllegalArgumentExceptionof binnen een Netty-wrapper DecoderException. Die wrapper alleen geeft de oorzaak niet aan. De regels eronder in het client- of serverlogboek wijzen vaak naar de betreffende mod, plugin of pakketverwerker.
Snelle diagnose: waar te beginnen?
| Wanneer het gebeurt | Wat moet je als eerste controleren? |
| Slechts één speler heeft de verbinding verbroken. | De clientmods, afhankelijkheden en exacte game- en loaderversies van die speler. |
| Alle spelers falen bij dezelfde deelname of interactie. | Server-side mods of plugins, proxy-doorsturing en serverlogs |
| Het gebeurt na het openen van een aangepast menu, opslagruimte of apparaat. | De mod die eigenaar is van dat scherm of blok en de bijbehorende data-synchronisatiecode. |
| Het begon na een update of een wijziging in een pakket. | Gewijzigde modversies, verwijderde afhankelijkheden of een onvolledig serverpakket. |
Dit zijn aanwijzingen, geen bewijs. Vergelijk dezelfde tijdstempel in zowel de client- als de serverlogboeken voordat u bestanden wijzigt.
Stapsgewijze oplossingen voor de Minecraft payload size-fout
1. Noteer de versies en reproduceer de fout.
Noteer de Minecraft-versie, de loader en de loaderversie, de modpack-versie, de serversoftware en de exacte foutmelding. Noteer wat je deed vlak voordat de verbinding werd verbroken: deelnemen aan een server, een wereld laden, een specifiek menu openen of een bepaald blok of voorwerp gebruiken. Test indien mogelijk eerst in een aparte kopie van de server, zodat je dezelfde actie kunt herhalen zonder je hoofdwereld in gevaar te brengen.
2. Controleer de client- en serverlogboeken.
logs/latest.logOpen de meest recente logbestanden of de uitvoer van de hostingconsole van de client en de server. Zoek naar de Payload may not be largerfoutmelding en bekijk vervolgens de omringende uitzondering en stacktrace. Zoek naar een mod-ID, pluginnaam, kanaalnaam of pakketnaam in de buurt van de eerste relevante regels. Als het spel een crashrapport heeft gegenereerd, controleer dan ook de hoofdfout en de stacktrace daarvan. De handleidingen van Fabric leggen uit waar latest.logcrashrapporten worden opgeslagen en hoe je het rapport kunt lezen; de handleiding voor probleemoplossing van Paper raadt aan te beginnen met de stacktrace van de server.
Voor een gehoste server kunt u het serverlogboek downloaden via het controlepaneel. Deel geen authenticatietokens, privé-IP-adressen of andere gevoelige gegevens wanneer u een logboek openbaar maakt.
3. Zorg ervoor dat de aangepaste configuratie aan beide zijden overeenkomt.
Controleer of de client en server een compatibele Minecraft-versie gebruiken en dezelfde vereiste loader- en modversies hebben. Controleer de afhankelijkheden en de naam van de mod. Sommige mods zijn alleen voor de client, terwijl andere aan beide kanten geïnstalleerd moeten worden; kopieer niet zomaar alle clientbestanden naar de servermap mods. Gebruik de serverpack- of installatie-instructies van de pack-auteur indien beschikbaar. De mod-installatiehandleiding van Fabric adviseert om te controleren of een mod de exacte Minecraft-versie en loader ondersteunt, aangezien een mod voor de ene point release mogelijk niet werkt op een andere.
Als de server recent is bijgewerkt, controleer dan of de mods of plugins ook zijn bijgewerkt voor die serverversie. Als slechts één speler problemen ondervindt, vergelijk dan de installatie van die speler met een werkend, werkend modpack in plaats van meteen de hele server aan te passen.
4. Isoleer de verantwoordelijke mod of plugin.
Maak een back-up van de wereld- en serverbestanden voordat je gaat testen. Schakel in een gekopieerde instantie of testserver de mod of plugin uit die in het logbestand wordt genoemd en herstart beide kanten indien nodig. Als er geen duidelijke naam is, verwijder dan ongeveer de helft van de niet-essentiële mods uit het testprofiel, herstart en herhaal dit met de helft die de fout nog steeds reproduceert. Deze methode om de lijst te splitsen verkleint de mogelijke boosdoeners sneller dan het tegelijkertijd wijzigen van veel bestanden.
Test dezelfde actie na elke wijziging. Als je een contentmod verwijdert, laat de originele wereld dan ongewijzigd: blokken, items of entiteiten van die mod kunnen ontbreken in de testkopie. Herstel de originele bestanden als de fout blijft bestaan of als de test nieuwe problemen veroorzaakt. Test op een Paper-server pluginwijzigingen op een kopie en gebruik het serverlogboek om plugin-gerelateerde fouten te identificeren.
5. De specifieke oorzaak bijwerken, configureren of verwijderen
Zodra je een mogelijke boosdoener hebt gevonden, controleer dan de officiële projectpagina op een release die compatibel is met jouw specifieke Minecraft-versie en loader. Update de mod en de benodigde afhankelijkheden aan de juiste kanten en test het opnieuw. Als de fout na een update is ontstaan, test dan de vorige, naar behoren werkende, compatibele release in de kopie. Raadpleeg voor een plugin de actuele documentatie en controleer of er bijbehorende plugins of protocolbibliotheken nodig zijn.
Als de ontwikkelaar bevestigt dat een bepaalde functie te veel data verzendt, schakel die functie dan uit of beperk de hoeveelheid data via de gedocumenteerde instelling, of rapporteer het logbestand en de stappen om het probleem te reproduceren aan de auteur. Vermijd willekeurige aanpassingen om datapakketten te corrigeren, ongedocumenteerde overschrijvingen van pakketlimieten en het kopiëren van JVM-vlaggen uit irrelevante handleidingen: deze kunnen een mismatch verbergen of nieuwe compatibiliteitsproblemen veroorzaken zonder de verzender te corrigeren.
Wanneer de kijkafstand of geheugeninstellingen van belang zijn
De server view-distancebepaalt hoeveel werelddata naar spelers wordt verzonden, gemeten als een chunkradius in de Paper- server.propertiesreferentie. Het verkleinen hiervan kan de algemene chunk-activiteit of prestaties verbeteren, vooral als de verbinding wordt verbroken tijdens het laden van grote hoeveelheden data. Het verhoogt niet de maximale grootte van een aangepast payloadpakket. Evenzo simulation-distancebepaalt het hoe ver entiteiten worden getikt; dit is geen instelling voor de pakketgrootte. Verhoog het Java-geheugen alleen wanneer de logboeken een daadwerkelijk geheugenprobleem aangeven, zoals een out-of-memory-fout.
Als de fout zich nog steeds voordoet
- Probeer eerst een schone, aparte instantie zonder extra clientmods en maak vervolgens verbinding met dezelfde server als de regels dat toestaan.
- Vraag de serverbeheerder of andere spelers de fout ook kunnen reproduceren en deel het bijbehorende tijdstempel uit het serverlogboek.
- Stuur de maker van de mod of plugin het volledige relevante logfragment, de exacte versies en de stappen die de fout veroorzaken.
- Bewaar de originele wereld- en modpackback-up totdat de gecorrigeerde configuratie succesvol is geladen en opgeslagen.
De betrouwbare oplossing voor de Minecraft payload size-fout is het identificeren van de pakketverzender en het corrigeren van de versie, configuratie of gegevensverwerking ervan. Beschouw zichtafstand en geheugen als afzonderlijke prestatie-instellingen, maak een back-up voordat u contentmods verwijdert en wijzig slechts één variabele tegelijk, zodat het resultaat duidelijk is.
Documentatie