# 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.

Source: https://stygion.eu/cs/docs/keystone/loaded
Updated: 2026-11-16

## 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](/docs/keystone/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.
