spark is dé profiler voor Minecraft-servers. Als je server hapert, vertelt spark je binnen enkele seconden of de tickrate eronder lijdt, welke plugins of farms de tijd opslokken en of de CPU of het geheugen aan de limiet zit. Deze guide laat de drie commando's zien die je echt nodig hebt en legt uit hoe je de cijfers leest. De screenshots komen van een testserver met Paper 1.21.4.

Installatie

spark draait als plugin op Paper en Spigot en als mod op Fabric, NeoForge en Forge. In het panel vind je het onder Plugins → Browser. Configuratie is niet nodig. De commando's horen thuis in de moderatiegroep; de bijbehorende node heet spark. Hoe je die toekent, lees je in LuckPerms: rechten instellen.

Eerste blik: TPS en tickduur

/spark tps toont drie regels:

Uitvoer van /spark tps: TPS, tickduur en CPU-belasting (Enlarge image)
  • TPS (ticks per seconde) over de afgelopen 5 seconden, 10 seconden en 1, 5 en 15 minuten. 20,0 is het maximum. Tot ongeveer 19 merken spelers nog niets, onder 15 bewegen dieren schokkerig en onder 10 wordt de server onspeelbaar.
  • Tickduur als minimum, mediaan, 95e percentiel en maximum in milliseconden. Een tick mag 50 ms duren om 20 TPS vast te houden. Op de afbeelding ligt de mediaan op 2,4 ms; de server heeft dus nog veel marge. Doorslaggevend is het 95e percentiel: ligt dat dicht bij 50 ms, dan krijg je haperingen, ook al ziet het gemiddelde er goed uit.
  • CPU-belasting, uitgesplitst naar systeem (de hele machine) en proces (alleen jouw server). Bij een gehuurde server is de proceswaarde de belangrijke.

/spark healthreport vat dezelfde waarden samen met geheugen en schijfruimte in één rapport.

De profiler: wie slokt de tijd op?

Als de TPS instort, start je de profiler:

/spark profiler start

spark bevestigt de start en blijft op de achtergrond draaien. Laat de profiler minstens een minuut lopen terwijl het probleem optreedt en voer dan dit uit:

/spark profiler stop
De profiler draait op de achtergrond; spark toont de commando's om te bekijken, te stoppen en te annuleren (Enlarge image)

Bij het stoppen uploadt spark het rapport naar spark.lucko.me en geeft het een link. Het rapport bevat geen spelersnamen, IP-adressen of chatberichten, maar aanroepbomen van het Java-proces. /spark profiler open opent het al tijdens het draaien, /spark profiler cancel gooit het weg zonder upload.

In het rapport klap je de boom van bovenaf open. Dit vind je meestal:

  • Entity-ticks van een bepaald type: een farm met honderden dieren of items. Verklein de farm of tem hem met entity-activation-range in paper-world-defaults.yml.
  • Een plugin in een event-listener: werk de plugin bij, controleer de configuratie of vervang hem.
  • Chunks laden door spelers die snel vliegen: verlaag de zichtafstand of genereer de wereld vooraf met Chunky.
  • Redstone-klokken: een schakeling die nooit stilstaat. Vraag de speler om die uit te zetten.

Garbage collection en geheugen

/spark gc laat zien hoe vaak en hoe lang de Java-geheugenopruiming pauzeert. Veel lange pauzes wijzen op te weinig RAM of een geheugenlek in een plugin. /spark heapsummary toont welke objecttypen het geheugen bezetten. Kijk hier eerst voordat je meer RAM bijboekt: vaak lost een plugin-update het probleem op.

Veelgemaakte fouten

  • TPS 20, toch lag. Het probleem ligt bij de client of het netwerk. /spark ping toont de latentie per speler.
  • Profiler-link vergeten. /spark profiler zonder argumenten toont de status; na het stoppen staat de link ook in de serverconsole.
  • Cijfers zonder vergelijking. Eén TPS-waarde zegt weinig. Meet een keer met een lege server als referentie.

Verdere guides

Als je een wereld vooraf genereert, hoeft de server tijdens het spelen minder chunks te laden: Chunky: wereld vooraf genereren. Hoe het panel aanhoudend lage TPS meldt, lees je in Minecraft-server-lag: TPS en Watchdog.

Bronnen