# Snapshoty hráčů a obnova inventáře

> Co hráč nesl při smrti, odpojení, změně dimenze a průběžně - inventář, brnění, ender chest, Curios, zkušenosti - a jak to z editoru nebo příkazem vrátit, aniž by se cokoli zdvojilo. Novinka 0.4, zapnuté od začátku.

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

„Umřel jsem a přišel jsem o všechno“, mod, který sežral item, dupe, který musíš vrátit: Keystone si pamatuje, co každý hráč nese, a tým mu to vrátí.

## Co snapshot obsahuje

- celý inventář: hotbar, batoh, brnění a druhou ruku
- ender chest
- sloty **Curios**, normální i kosmetické, když je Curios nainstalovaný (Trinkets je mod pro Fabric; Keystone běží na NeoForge)
- zkušenosti: level, postup a celkový počet
- kde stál: dimenzi a pozici

Každý stack se ukládá tak, jak ho ukládá hra sama, se všemi komponentami - batoh z modu, očarovaný nástroj, přejmenovaný meč nebo shulker plný věcí se vrátí přesně takový, jaký byl. Keystone nemusí mod znát, aby jeho itemy uchoval.

## Kdy se pořizuje

| Okamžik | Nastavení | Výchozí |
|---|---|---|
| Hráč umře - **dřív**, než cokoli vypadne a než mod na hroby nebo mrtvoly něco přesune | `take.death` | zapnuto |
| Hráč se odpojí | `take.leave` | zapnuto |
| Hráč změní dimenzi | `take.dimension` | zapnuto |
| Průběžně, pro všechny online | `take.every` | `15m` (`off` vypne) |
| Hráč se připojí | `take.join` | vypnuto |
| Ručně | `/keystone snapshots take <hráč>` nebo **Take now** v editoru | - |

Průběžný snapshot a snapshot při odpojení, připojení nebo změně dimenze se přeskočí, když by byl stejný jako hráčův nejnovější, takže hráč, který jen stojí, databázi nezaplní. Smrt se uloží vždycky. Průběžné snapshoty se berou po jednom hráči za tick, takže ani čtyřicet hráčů neudělá lag.

## Jak dlouho se drží

- `keep.for` (`14d`): starší snapshoty se mažou, kontrola každou hodinu
- `keep.routine` (`30`): kolik běžných snapshotů (odpojení, připojení, dimenze, průběžné) se drží na hráče
- `keep.important` (`20`): kolik smrtí, ručních snapshotů a snapshotů před obnovou se drží na hráče, počítá se zvlášť - den hraní nevytlačí včerejší smrt

Snapshot, na který čeká obnova, zůstane, dokud obnova neproběhne.

## Jak ho vrátit

**V editoru:** *Snapshots & restore* (ve skupině People). Najdi hráče, otevři snapshot, uvidíš každý stack podle slotu, vyber, co obnovit, a dej **Preview**: řekne, co by se vrátilo, co by se vynechalo a proč - proti tomu, co hráč nese právě teď. Pak **Restore**.

**Ve hře:** `/keystone snapshots list <hráč>`, klikni na snapshot a pak **Doplnit prázdné sloty** nebo **Nahradit**.

Obnovit jde dvěma způsoby:

- **Fill (doplnit)** vrátí stack jen do jeho vlastního slotu, jen když je ten slot prázdný, a vynechá, co už hráč zase nese (stejný item se stejnými komponentami kdekoli u sebe) - takže meč, který si sebral tam, kde umřel, nedostane podruhé. Na nic, co nese, se nesahá.
- **Replace (nahradit)** vyprázdní obnovované části a zapíše do nich snapshot. Nejdřív se zeptá a to, co nahradil, uloží jako snapshot *before a restore* - nahrazení se tím snapshotem dá vrátit.

Části si vybíráš: inventář, ender chest, Curios, zkušenosti a případně **přesun** na místo, kde stál. Fill nikdy zkušenosti nebere.

> [!IMPORTANT]
> **Nic se nevydá dvakrát.** Snapshot, který už jednou obnovený byl, nebo snapshot pořízený před hráčovou poslední obnovou, potřebuje `again`. Hráč má vždy jen jednu obnovu naráz. Všechno se do hráče zapíše v jednom ticku, takže mezi tím nemůže nic udělat.

**Hráč offline** dostane obnovu při příštím připojení, právě jednou - i když se připojí dvakrát, nebo když se server uprostřed zastaví (pak je obnova vidět jako *interrupted* a sama už se nikdy nespustí; podívej se mu do inventáře a zruš ji). Čekající obnovy jsou v *Waiting for a join* a v `/keystone snapshots pending` a dají se zrušit.

Item, jehož mod už na serveru není, vrátit nejde: nahlásí se jako nečitelný, zůstane ve snapshotu a všechno ostatní se vrátí.

> [!WARNING]
> Po smrti může ve světě pořád ležet, co vypadlo - nebo hrob či mrtvola. Obnovit a k tomu to sebrat znamená mít všechno dvakrát. Fill vynechá, co hráč zase nese; replace se nedívá.

## Kdo co obnovil

Každá obnova se zapíše: kdo, který snapshot komu, fill nebo replace, kdy a s jakým výsledkem (kolik stacků se vrátilo, které ne a proč). V editoru jsou pod *Restores*, ve hře `/keystone snapshots history [hráč]`.

## Tickety

Když má hráč otevřený ticket, obnova to do něj napíše jménem toho, kdo obnovoval: *„Your inventory from 30 Oct 2026 21:14 (death) is restored: 31 stacks are back.“* Řádek jde všude, kam jdou řádky ticketu - hráči do chatu, do Discord kanálu ticketu, do tvého vlastního přeposílání.

- `tickets.reply`: `newest` napíše do hráčova nejnovějšího otevřeného ticketu sám; `off` jen do toho, který uvedeš
- v editoru vybereš *newest*, číslo, nebo žádný; ve hře přidáš `ticket=12` nebo `no-ticket`
- `tickets.text` a `tickets.text-partly` jsou slova té odpovědi, s `{when}`, `{reason}`, `{placed}`, `{not-done}` a `{by}`

## Příkazy

| Příkaz | Co dělá | Oprávnění |
|---|---|---|
| `/keystone snapshots` | nejnovější snapshoty | `keystone.snapshots` |
| `/keystone snapshots list <hráč>` | snapshoty jednoho hráče | `keystone.snapshots` |
| `/keystone snapshots view <id>` | co snapshot obsahuje, s tlačítky obnovy | `keystone.snapshots` |
| `/keystone snapshots items <id>` | každý stack, slot po slotu | `keystone.snapshots` |
| `/keystone snapshots take <hráč>` | pořídí snapshot hned, online i z uloženého souboru | `keystone.snapshots.take` |
| `/keystone snapshots restore <id> fill\|replace [možnosti]` | vrátí ho | `keystone.snapshots.restore` |
| `/keystone snapshots pending` | obnovy, které čekají na připojení | `keystone.snapshots` |
| `/keystone snapshots cancel <obnova>` | zruší čekající nebo přerušenou obnovu | `keystone.snapshots.restore` |
| `/keystone snapshots history [hráč]` | kdo co obnovil | `keystone.snapshots` |

Možnosti za `fill` nebo `replace`: `confirm` (u replace), `again`, `position` (přesunout ho tam), `ignore-carried` (fill vrátí i to, co nese - může zdvojit), `only=inventory,ender,curios,xp`, `ticket=<číslo>`, `no-ticket`.

`restore.self` (vypnuto): do vlastního inventáře obnovuje jen majitel serveru - obnova vytváří itemy a obnova sobě je jediná, kterou nikdo jiný nezkontroluje.

## API

`GET /v1/snapshots`, `/v1/snapshots/one`, `/v1/snapshots/preview`, `/v1/snapshots/restores`, `POST /v1/snapshots/take`, `/v1/snapshots/restore`, `/v1/snapshots/cancel`. Potřebují scopy `snapshots.read` a `snapshots.write`, které mají jen klíče majitele: snapshoty říkají, kde každý hráč stál, a obnova vytváří itemy. Moderátor obnovuje ve hře s oprávněním. Podrobnosti v [Rozhraní - všechny cesty](/docs/keystone/api-reference).

## Soukromí

Snapshoty jsou jen v `keystone.db` tvého serveru a nikde jinde. Keystone o nich nikam nic neposílá; jediný řádek, který může odejít, je odpověď „restored“ v ticketu, a to jen tam, kam už řádky toho ticketu chodí. Vypni modul v *Settings* a nic se pořizovat nebude.
