Výkon Minecraft servera: lagy, parametre, view distance, Chunky a spark

Server, ktorý „seká“, väčšinou netrpí nedostatkom hardvéru, ale jednou konkrétnou príčinou: príliš veľkou vzdialenosťou simulácie, generovaním nového terénu, preplnenou farmou alebo zle napísaným pluginom. Ukážeme, ako lag zmerať, nájsť jeho príčinu a opraviť ju – od rýchlych úprav po nastavenia Paperu a profilovanie.

Ako zistiť, čo laguje#

Minecraft server počíta hru v tickoch. Za sekundu ich má stihnúť 20, na jeden tick má teda 50 milisekúnd. Dve čísla, ktoré potrebujete poznať:

MSPT je presnejší ukazovateľ: server s MSPT 45 ms má stále TPS 20, ale nemá žiadnu rezervu. Keď MSPT prelezie 50 ms, TPS začne klesať.

Hodnoty zistíte v Konzole (príkazy píšete bez lomky):

tps
mspt
spark tps

• tps – priemerné TPS za posledných 1, 5 a 15 minút (Paper, Purpur).
• mspt – priemerný, najkratší a najdlhší čas ticku (Paper, Purpur).
• spark tps – TPS, MSPT (minimum, medián, 95. percentil, maximum) a vyťaženie procesora. Funguje všade, kde je spark (Paper ho má vstavaný).

Keď server dlhodobo nestíha, objaví sa v konzole:

Can't keep up! Is the server overloaded? Running 2500ms or 50 ticks behind

Server tým hovorí, že je 2,5 sekundy (50 tickov) pozadu a ticky preskočí. Jedna hláška pri štarte alebo pri generovaní terénu neprekáža. Ak sa opakuje každých pár minút, pokračujte týmto návodom.

Lag servera, alebo niečo iné?#

Rýchle výhry#

Zoradené od najväčšieho účinku k menšiemu. Väčšinu zvládnete do desiatich minút.

Spúšťacie parametre a pamäť#

Parametre (flagy) sú voľby, s ktorými sa spúšťa Java. Určujú veľkosť pamäte pre hru (halda, heap), stropy pamäte mimo haldy a správanie garbage collectora, ktorý z pamäte upratuje nepotrebné dáta. V zákazníckej zóne ich nájdete v záložke Spustenie, v časti Spúšťacie parametre.

Haldu a stropy počíta zákaznícka zóna sama podľa veľkosti balíka, typu servera, verzie Javy a počtu pluginov alebo modov. Prepočíta ich pri založení servera, po zmene balíka, po zmene typu alebo verzie a pred štartom z portálu, keď sa odvtedy niečo z toho zmenilo. Spúšťací príkaz, ktorý ste upravili ručne v paneli alebo nastavili ako vlastný, neprepisuje. Keď má taký príkaz haldu väčšiu, než menší balík unesie, server po zmene balíka nespustíme (hneď by spadol) a napíšeme vám e-mail.

Všetky presety majú rovnaké poistky: strop sieťových bufferov, skompilovaného kódu a načítaných tried, MALLOC_ARENA_MAX=2 (menej pamäťových arén alokátora) a od Javy 17 -XX:TrimNativeHeapInterval (vracia nevyužitú pamäť systému). Purpur navyše automaticky dostane --add-modules=jdk.incubator.vector (rýchlejšie výpočty, ktoré Purpur vie využiť).

Tlačidlá v tejto časti:

• Uložiť – nastavenie sa použije pri ďalšom štarte.
• Uložiť a reštartovať – server sa hneď reštartuje. Keď s novými parametrami nenaštartuje, zákaznícka zóna ich sama vráti a uvidíte hlášku Parametre nie sú kompatibilné, vrátené na predchádzajúce nastavenie.
• Vrátiť predchádzajúce – vráti posledné funkčné nastavenie.
• Použiť odporúčané – objaví sa, keď je halda na balík príliš veľká alebo spúšťací príkaz nemá stropy pamäte. Nastaví odporúčaný príkaz.
• Prepočítať teraz – prepočíta parametre hneď, nemusíte čakať na ďalší štart z portálu.

Pod voľbou Rozdelenie pamäte uvidíte, koľko dostane halda a koľko zostáva pre ostatné časti. Po automatickom prepočte zákaznícka zóna ukáže napríklad Spúšťací príkaz sme upravili podľa novej veľkosti RAM: halda 8,2 → 9,6 GB.

Server mimo StormHostu? Štartovací skript s rovnakým výpočtom pre Docker, Linux aj Windows vytvorí Generátor štartovacieho skriptu.

Prečo halda nie je celá RAM#

Halda (-Xmx) sama seba neprerastie. Rastie pamäť mimo haldy: sieťové buffery, načítané triedy pluginov a modov, skompilovaný kód, vlákna a alokátor systému. Najviac sieťové buffery – bez stropu smú narásť až do veľkosti haldy, takže server s haldou 6 GB môže skončiť na 12 GB.

Kontajner servera má tvrdý limit o 5 % vyšší než balík (pri balíkoch do 4 GB o 10 %, do 2 GB o 15 %) a nemá swap. Keď proces limit prekročí, systém ho ukončí. V Konzole sa objaví Out of memory: true, v logu servera žiadna chyba nie je.

Preto má každá veľká časť mimo haldy strop, všetko sa sčíta s rezervou pod veľkosť balíka a halda dostane zvyšok. Keď niektorá časť narazí na strop, server namiesto tichého pádu zapíše do logu chybu (OutOfMemoryError: Direct buffer memory alebo Metaspace), podľa ktorej sa dá nájsť vinník.

Halda má minimálnu aj maximálnu veľkosť rovnakú (-Xms = -Xmx) a zaberie sa hneď pri štarte. Graf pamäte v paneli preto ukazuje vysoké číslo od začiatku. Panel navyše počíta aj vyrovnávaciu pamäť súborov sveta, ktorú systém v prípade potreby uvoľní. Číslo blízko limitu samo osebe pád neznamená.

Dokumentácia Paperu odporúča na serveri aspoň 6–⁠10 GB haldy bez ohľadu na počet hráčov a varuje, že viac pamäte nad určitú hranicu výkon nezvýši.

View a simulation distance#

Svet je rozdelený na chunky (stĺpce 16 × 16 blokov). Server okolo každého hráča drží načítané chunky v určitom okruhu:

• view-distance – koľko chunkov okolo hráča server posiela do hry (čo hráč vidí). Ovplyvňuje hlavne pamäť a sieť.
• simulation-distance – v akom okruhu chunky „žijú“: pohybujú sa moby, rastie obilie, funguje redstone a farmy. Ovplyvňuje hlavne procesor, teda TPS.

Počet chunkov rastie s druhou mocninou vzdialenosti. Pri view-distance=10 drží server okolo každého hráča 441 chunkov, pri 8 iba 289 (o tretinu menej). Pri simulácii je efekt rovnaký.

Nastavíte ich v záložke Nastavenia servera v skupine Svet (všetky nastavenia). Simuláciu pod 5 neodporúčame – väčšie farmy potom prestanú fungovať, pretože časť farmy je mimo simulovanej oblasti.

Nastavenia Paperu#

Paper a Purpur majú vlastnú konfiguráciu v priečinku config:

Upravujte vždy paper-world-defaults.yml. Súbor otvorte v záložke Súbory v editore, nájdite existujúcu sekciu (napríklad chunks:) a zmeňte hodnotu v nej. Nevkladajte rovnakú sekciu druhýkrát – duplicitný kľúč server buď odmietne načítať, alebo použije iba jeden z nich a vaša zmena sa neprejaví.

Vybrané nastavenia s najväčším vplyvom na výkon:

Ukážka, ako úpravy v súbore vyzerajú (iba zmenené časti, ostatné riadky súboru ponechajte):

chunks:
  entity-per-chunk-save-limit:
    arrow: 16
    experience_orb: 16
    snowball: 8
    ender_pearl: 8
  prevent-moving-into-unloaded-chunks: true
collisions:
  max-entity-collisions: 2
entities:
  spawning:
    despawn-ranges:
      monster:
        hard: 72
        soft: 30
environment:
  optimize-explosions: true
misc:
  redstone-implementation: ALTERNATE_CURRENT
tick-rates:
  grass-spread: 4
  mob-spawner: 2

spigot.yml a bukkit.yml#

Paper číta aj staršie konfiguračné súbory spigot.yml a bukkit.yml v hlavnom priečinku servera.

spigot.yml#

Všetky nastavenia sú v sekcii world-settings › default.

bukkit.yml#

Predgenerovanie sveta s Chunky#

Keď hráč príde na miesto, kde ešte nikto nebol, server musí terén vygenerovať. Je to najnáročnejšia operácia vôbec: jeden hráč na elytre dokáže zraziť TPS celého servera. Riešenie je terén vygenerovať vopred a okraj sveta nastaviť tak, aby hráči mimo pripravenú oblasť nemohli.

Plugin Chunky vygeneruje terén na pozadí, postupne a s možnosťou prerušenia. Existuje pre Paper, Purpur, Folia aj ako mod pre Fabric, Forge a NeoForge.

1. Nainštalujte Chunky v záložke Pluginy (pri modoch Mody) › Prechádzať, vyhľadajte Chunky a kliknite na Inštalovať. Potom server reštartujte (návod na pluginy).

2. V Konzole nastavte stred okraja sveta:

   worldborder center 0 0

   • worldborder center – nastaví stred okraja sveta.
   • 0 0 – súradnice X a Z stredu. Zvyčajne stred sveta, prípadne súradnice spawnu.

3. Nastavte veľkosť okraja:

   worldborder set 10000

   • worldborder set – nastaví veľkosť okraja.
   • 10000 – priemer v blokoch. Svet bude mať 10 000 × 10 000 blokov, teda 5 000 blokov od stredu na každú stranu.

4. Prevezmite okraj do Chunky:

   chunky worldborder

   Chunky si nastaví stred a polomer podľa okraja sveta.

5. Spustite generovanie:

   chunky start

   V konzole pravidelne uvidíte priebeh v percentách, počet vygenerovaných chunkov a odhad zostávajúceho času.

Ďalšie príkazy:

Nether a End#

Nether je osemkrát menší než Overworld (1 blok v Netheri = 8 blokov v Overworlde). Pre okraj s priemerom 10 000 blokov v Overworlde (polomer 5 000) stačí v Netheri polomer 625 blokov. Pripojte sa do hry, prejdite do Netheru a v chate zadajte:

/chunky world
/chunky center 0 0
/chunky radius 625
/chunky start

• /chunky world – bez názvu vyberie svet, v ktorom práve ste (Nether).
• /chunky center 0 0 – stred generovania.
• /chunky radius 625 – polomer v blokoch.
• /chunky start – spustí generovanie.

Okraj sveta v Netheri (/worldborder set 1250 zadaný v Netheri) nastavte iba na Paperi, Purpure a od verzie 1.21.9 aj inde – až od tejto verzie má každá dimenzia vlastný okraj. V starších verziách Vanilly, Fabricu a NeoForge by príkaz zmenil okraj aj v Overworlde.

End stačí generovať menší (napríklad polomer 2 000–⁠3 000 blokov), hráči sa v ňom pohybujú hlavne okolo ostrovov.

Po reštarte servera generovanie nepokračuje samo. Nadviažte príkazom chunky continue (alebo v plugins/Chunky/config.yml nastavte continue-on-restart: true).

Diagnostika so spark#

spark je profiler: počas prevádzky zaznamenáva, čo server robí, a výsledok ukáže ako prehľadný strom s percentami. Paper ho má od verzie 1.21 vstavaný (Purpur tiež), na Fabricu a NeoForge si nainštalujte mod spark z Modrinthu. Na proxy Velocity sa príkaz volá sparkv.

Rýchly prehľad#

Profilovanie krok za krokom#

1. Počkajte, kým server laguje (alebo kým je na ňom bežný počet hráčov). Profil prázdneho servera nič neukáže.

2. V Konzole spustite profiler na 10 minút:

   spark profiler start --timeout 600

   • spark profiler start – spustí profiler.
   • --timeout 600 – po 600 sekundách (10 minútach) ho sám zastaví a nahrá výsledok.

3. Počkajte 10 minút. V konzole sa objaví odkaz na profil (spark.lucko.me/…).

4. Odkaz vložte do Analýzy Spark profilu. Ukáže, čo server spomaľuje a čo zmeniť.

Profil nemusíte nahrávať: s voľbou --save-to-file (napríklad spark profiler start --timeout 600 --save-to-file) ho spark uloží ako súbor .sparkprofile do priečinka plugins/spark (na Fabricu a NeoForge config/spark). Stiahnite ho v záložke Súbory a nahrajte do analýzy.

Keď chcete profiler ukončiť skôr, zadajte spark profiler stop. Na krátke výkyvy (server občas na sekundu „zamrzne“) použite:

spark profiler start --only-ticks-over 100

• --only-ticks-over 100 – zaznamená iba ticky dlhšie než 100 ms. Vyfiltruje bežnú prevádzku a zostanú iba „laggy“ ticky. Hodnotu voľte medzi 50 a 100.

Ako čítať výsledok#

Keď chcete strom prejsť sami, otvorte odkaz na profil v prehliadači:

1. V zozname vlákien rozbaľte Server thread – hlavné vlákno hry. Problémy iných vlákien (načítavanie chunkov, sieť) sú menej časté.
2. Klikaním rozbaľujte uzly a sledujte percentá. Choďte vždy cestou s najvyšším podielom.
3. Čas strávený v Thread.sleep() alebo „parked“ je v poriadku – server čaká na ďalší tick, pretože má rezervu.
4. Typické nálezy:

5. V hornej lište prepnite zobrazenie na Sources – ukáže samostatný strom pre každý plugin alebo mod a hneď je vidieť, ktorý zaťažuje najviac.

Odkaz na profil môžete poslať autorovi pluginu alebo našej podpore. Neobsahuje heslá ani súbory servera.

Koľko entít je na serveri#

Na Paperi vypíše počty entít podľa typu príkaz paper entity list. V konzole treba uviesť aj svet:

paper entity list * minecraft:overworld
paper entity list minecraft:villager minecraft:overworld

• paper entity list – výpis entít.
• * – bez filtra, vypíše všetky typy entít s počtami (prvé číslo sú tikajúce entity, druhé netikajúce).
• minecraft:villager – filter na jeden typ. Výpis potom ukáže súradnice chunkov, kde je týchto entít najviac.
• minecraft:overworld – svet (minecraft:the_nether, minecraft:the_end pre ďalšie dimenzie). V hre svet uvádzať nemusíte, použije sa ten, v ktorom stojíte.

Na nájdené miesto sa potom pozrite v hre a farmu alebo ohradu zmenšite.

Mody pre výkon (Fabric a NeoForge)#

Fabric a NeoForge nemajú optimalizácie Paperu, ale existujú serverové mody s rovnakým cieľom. Všetky nájdete na Modrinthe (v záložke Mody › Prechádzať):

Mod vždy vyberajte pre presnú verziu Minecraftu a loadera. Podrobne v návode Mody a modpacky.

Kedy je čas na upgrade#

Upgrade balíka má zmysel, keď:

• spark ukazuje, že server je vyťažený rovnomerne (žiadny jeden plugin alebo farma nedominuje) a MSPT je trvalo nad 40 ms pri bežnom počte hráčov,
• spark health ukazuje pamäť trvalo pri strope a garbage collector nestíha upratovať,
• pridávate veľký modpack alebo plánujete výrazne viac hráčov.

Ak jeden plugin alebo farma berie väčšinu času, viac výkonu problém nevyrieši – príčinu treba odstrániť.

Overenie#

1. Po zmenách reštartujte server a nechajte ho bežať s hráčmi aspoň 15 minút.
2. Zadajte spark tps. MSPT (medián) by mal byť pod 50 ms, ideálne pod 35 ms, a TPS 20.
3. Hláška Can't keep up! by sa už nemala opakovať.
4. Pri neistote spustite znova profil na 10 minút a porovnajte ho s predchádzajúcim.

Keď niečo nefunguje#

Server po úprave konfigurácie nenaštartuje#

Najčastejšie je chyba v YAML (tabulátor, zlé odsadenie, duplicitná sekcia). V konzole hľadajte riadok s názvom súboru a číslom riadka. Opravte ho, alebo súbor zmažte – Paper ho pri štarte vytvorí znova s predvolenými hodnotami (vaše úpravy sa tým stratia). Prípadne obnovte zálohu.

Parametre nie sú kompatibilné, vrátené na predchádzajúce nastavenie.#

Server s novými parametrami nenaštartoval a zákaznícka zóna ich vrátila. Skontrolujte vlastné parametre (preklep, parameter pre inú verziu Javy) a skúste preset bez vlastných parametrov.

Server sa náhle vypne bez chyby v logu#

Typický príznak prekročenia pamäte. V Konzole sú riadky Exit code: 137 a Out of memory: true a zákaznícka zóna nad konzolou ukáže Serveru došla pamäť a systém ho ukončil. Panel server raz spustí znova; keď spadne druhýkrát do minúty, nechá ho vypnutý.

1. V záložke Spustenie skontrolujte upozornenia pri spúšťacích parametroch. Keď je halda na balík príliš veľká alebo príkaz nemá stropy pamäte, kliknite na Použiť odporúčané.
2. Ručne upravený alebo vlastný spúšťací príkaz zákaznícka zóna neprepisuje. Použite odporúčaný preset, alebo nastavte haldu podľa tabuľky v časti Prečo halda nie je celá RAM.
3. V logu hľadajte OutOfMemoryError: Direct buffer memory alebo OutOfMemoryError: Metaspace. Ukazujú na plugin alebo mod, ktorý plní sieťové buffery alebo stále dookola načítava triedy.
4. Keď pády pokračujú aj s odporúčaným nastavením, hľadajte únik pamäte: spark heapsummary ukáže, čo zaberá haldu, spark profiler start --alloc --timeout 300 čo najviac pamäte prideľuje. Odkaz vložte do Analýzy Spark profilu, alebo ho pošlite našej podpore.

java.lang.OutOfMemoryError: Java heap space#

Halda je plná. Buď je na serveri viac, než sa do pamäte zmestí (modpack, veľký počet hráčov), alebo plugin či mod pamäť „stráca“ (únik pamäte). Pomôže upgrade, alebo nájdenie úniku cez spark heapsummary. Ďalšie chyby nájdete v článku Časté chyby Minecraft servera.

Chunky hlási neplatný svet#

Názov sveta neexistuje. V hre použite /chunky world bez názvu (vyberie svet, v ktorom stojíte), alebo v konzole zadajte názov hlavného sveta podľa level-name (predvolene world).

Po zapnutí ALTERNATE_CURRENT nefunguje redstonová stavba#

Niektoré obvody sa spoliehajú na poradie aktualizácií Vanilly. Vráťte misc.redstone-implementation na VANILLA a server reštartujte.

Ďalšie zdroje#

• Profilovanie v dokumentácii Paperu (otvorí sa v novom okne)
• Konfigurácia svetov Paperu (otvorí sa v novom okne)
• Konfigurácia spigot.yml (otvorí sa v novom okne)
• Konfigurácia bukkit.yml (otvorí sa v novom okne)
• Aikarove flagy v dokumentácii Paperu (otvorí sa v novom okne)
• Príkazy spark (otvorí sa v novom okne)
• Príkazy Chunky (otvorí sa v novom okne)