STYGION Dokumentace Hledat v dokumentaci

Kdo drží svět načtený

/keystone loaded vypíše všechno, co drží chunky v paměti - hráče, /forceload, force-loady FTB Chunks, chunk loadery modů, spawny, pohyblivé stavby - s majitelem, kdy byl naposledy online, počtem chunků a podílem na ticku, a nakreslí to jako mapu. Novinka 0.4; jen čte.

Keystone 0.5.0 Aktualizováno 4 min čtení
Na téhle stránce 7 částí
  1. Proč
  2. Co ukáže
  3. Příkazy
  4. Editor
  5. Pravidlo neaktivity (výchozí vypnuté)
  6. API
  7. Co čte a co ne

Proč

#

Modovaný server, který drží 20 000 chunků při osmi lidech online, není pomalý kvůli těm osmi. Zbytek drží něco jiného: zapomenutý /forceload, force-loady FTB Chunks u základny, kam měsíc nikdo nebyl, blok chunk loaderu, spawn každé další dimenze, letící loď. Hra přesně ví, proč který chunk drží - má na něj ticket - ale neřekne to. Tenhle modul tickety přečte a u každého zdroje řekne, čí je a co stojí.

Co ukáže

#

Každý zdroj, který drží chunky načtené, nejtěžší první:

Druh Co to je Majitel
Hráč chunky kolem někoho online hráč
/forceload vanilla /forceload claim, ve kterém chunk leží (pokud je)
FTB force-load force-loadované claimy FTB Chunks tým, jeho členové, kdy byl někdo z nich naposledy online a jestli force-loady drží i offline
Chunk loader jakýkoli mod, který načítá chunky přes ticket controllery NeoForge (Create: Power Loader, anchor upgrade Mekanismu, spatial anchor AE2...) mod, pozice bloku a claim, ve kterém stojí
Spawn spawn chunky dimenze -
Ticket ticket jiného modu (třeba sub-level Sable, když loď letí) jeho id, pokud ho má
Krátký ticket portály, teleporty, ender perly: zmizí za sekundy až minuty -
Uvolňuje se chunky, které už žádný ticket nedrží a čekají na zápis -

U každého: kolik chunků drží, kolik z nich tickuje (běží tam block entity a náhodné ticky), block entity v tickujících chuncích, kdy byl majitel naposledy online a teleport k němu.

Každý držený chunk se počítá jednou. Ticket drží svůj chunk a čím dál slaběji i okolí - jeden force-loadovaný chunk drží v paměti čtverec 27 x 27, z toho 3 x 3 tickuje. Keystone dá každý chunk ticketu, který o něm opravdu rozhoduje (nejsilnějšímu, který na něj dosáhne), takže čísla sedí se stavem serveru. Když na chunk dosáhne hráč i chunk loader stejně, patří chunk loaderu: ten zůstane, až všichni odejdou.

Příkazy

#

Prohlížení potřebuje keystone.loaded; uvolnění navíc keystone.loaded.release.

Příkaz Co dělá
/keystone loaded počty a nejtěžší zdroje (list v loaded.toml, 10)
/keystone loaded measure [sekundy] změří tick (výchozí measure.seconds, 30) a přidá ms za tick u každého zdroje
/keystone loaded worlds držené a tickující chunky po světech
/keystone loaded idle které majitele najde pravidlo neaktivity
/keystone loaded release <řádek> uvolní jeden zdroj z vypsaného seznamu: jen chunky z vanilla /forceload a force-loady FTB Chunks (claimy zůstanou); potřebuje keystone.loaded.release

ms za tick se rozpočítává: tick se měří po oblastech 16 x 16 chunků (mřížka profileru) a čas oblasti se rozdělí mezi zdroje podle toho, kolik jejích tickujících chunků který drží. Dvě základny v jedné oblasti se o něj dělí. Je to odhad s přesností té mřížky; čí kód to byl, řekne profiler. Měření nezačne, když tick zrovna měří profil nebo benchmark.

Editor

#

Obrazovka Loaded chunks (v části Running) má stejnou tabulku, tlačítko Measure a mapu nákladů: každý držený chunk jednoho světa jako čtvereček v barvě svého zdroje, jasný tam, kde tickuje, a oblasti s největším podílem na ticku orámované oranžově. Klik na chunk nebo řádek ukáže jen ten zdroj.

Pravidlo neaktivity (výchozí vypnuté)

#

Nic se nezmění, dokud to admin nezapne.

Nastavení (loaded.toml) Výchozí Co dělá
idle.days 0 (vypnuto) majitel, který nebyl online tolik dní, je neaktivní
idle.action report report: neaktivní zdroje se jen označí. release: Keystone jejich force-loady uvolní, nejvýš jednou za hodinu, každé uvolnění v logu
idle.kinds forceload, claims které druhy smí release uvolnit
idle.keep-permission keystone.loaded.keep kdo má tohle oprávnění, není nikdy neaktivní
idle.discord-channel prázdné kanál na Discordu, kam jde zpráva o každém uvolnění

Vlastní chunk loadery modů se nikdy neuvolňují, jen hlásí: mod si myslí, že chunk drží, a vzít mu ho pod rukama je cesta k rozbitým strojům. Zeptej se majitele, nebo blok odstraň. FTB Chunks má vlastní pravidla pro offline (force_load_mode a maximum dní neaktivity v jeho world configu); pravidlo Keystone funguje vedle nich a i na vanilla force-loady.

API

#
Cesta Scope
GET /v1/loaded status.read jen počty: držené a tickující chunky po světech a druzích zdrojů (?fresh=true nové sčítání) - bez majitelů a míst
GET /v1/loaded/sources loaded.read každý zdroj s majitelem, kdy byl naposledy online, místem a teleportem (?fresh=true, ?limit=) a neaktivní
GET /v1/loaded/map?world= loaded.read jeden svět: x, z, zdroj a level každého drženého chunku, legenda, změřené oblasti
POST /v1/loaded/measure loaded.read spustí měření (seconds)
POST /v1/loaded/release operations.run uvolní jeden zdroj (id z GET /v1/loaded/sources), se stejnými limity jako příkaz

loaded.read je scope vlastníka, stejně jako homes.read: kdo drží chunky načtené a kde, to je, kde má základnu. Odkaz do panelu pro moderátora a úzký klíč vidí počty; majitele a místa vidí jen klíče vydané vlastníkovi. Ve hře prohlížení potřebuje keystone.loaded a uvolnění zvlášť keystone.loaded.release.

Pro addony dává Game.chunkLoads() v API Keystone chunky a tickety hry, jak právě jsou.

Co čte a co ne

#

Čte vlastní chunk holdery a tickety hry v paměti, na serverovém vlákně, jen když se někdo zeptá (příkaz, editor, API nebo hodinová kontrola neaktivity, když je idle.days nastavené). Lidi za zdroji - jména a kdy byli naposledy online - dočte z databáze Keystone až potom, mimo serverové vlákno, takže sčítání nikdy nenechá tick čekat na disk. Nic neodchází ze serveru. Kde nějaká část nejde přečíst, řekne to jednou v logu a ukáže, co jde.

Pomohla vám tahle stránka?

Otevře panel zpětné vazby s touhle stránkou v příloze. Přistane do jedné fronty se vším ostatním.