# Export dat packu

> Itemy, tagy, všechny recepty, advancementy, loot tabulky a jména věcí z běžícího serveru do jednoho zipu - jen na vyžádání a nic neopustí stroj. Novinka 0.2.8.

Source: https://stygion.eu/cs/docs/keystone/export
Updated: 2026-11-12

Modul `export`, soubor `export.toml`. Zapíše, co modpack doopravdy obsahuje, tak jak to vidí běžící hra po načtení všech modů a datapacků: itemy, tagy, všechny recepty, advancementy, loot tabulky a jména věcí, v jednom zipu. Čtou ho nástroje pro autory packů (STYGION Workbench z něj staví pohledy na recepty a questy).

## Jen na vyžádání

Modul je zapnutý, ale server, kde se nikdo nezeptá, tu nedělá vůbec nic: žádný soubor, žádné vlákno, žádná práce v ticku. Zeptat se jde dvěma způsoby:

- **Při startu**: `-Dkeystone.export=<soubor.zip>` (nebo proměnná prostředí `KEYSTONE_EXPORT`) zapíše export, jakmile server naběhne. S `-Dkeystone.export.stop=true` se server potom zastaví — hodí se pro testovací server, který existuje jen kvůli přečtení packu.
- **Na běžícím serveru**, s klíčem se scope `pack.read` (vlastnický):
  - `POST /v1/export` spustí export do složky modulu a odpoví jeho id; vždy jen jeden naráz.
  - `GET /v1/export?id=…` řekne, jak to jde: běží, hotovo s velikostí a počty, nebo selhalo a proč.
  - `GET /v1/export/zip?id=…` vydá hotový zip.

Odkazy se vezmou na vlákně serveru (pár milisekund); čtení a zápis — ve velkém packu sekundy — běží na pracovním vlákně. Drží se poslední 4 exporty.

## Nic neopustí stroj

Export je soubor na disku serveru. API ho vydá jen tomu, kdo má klíč, na loopback portu jako zbytek [lokálního API](/docs/keystone/api).

## Nastavení

`max-mib` (512) — největší zapsaný export v MiB. Export, který by byl větší, se zahodí a jeho rozepsaný soubor smaže; velký modpack s desítkami tisíc receptů je hluboko pod tím.
