# Audit bloků a truhel s rollbackem

> Kdo co rozbil, položil, vyhodil do vzduchu, vzal a vložil, kde a kdy - zjistíš kliknutím nebo filtrem, vrátíš rollbackem po pár blocích v každém ticku, historii z CoreProtectu převezmeš. Nové v 0.4, zapnuté.

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

Někdo přes noc vybílí základnu, vybere truhlu, creeper vezme střechu: Keystone si pamatuje každou změnu bloků a truhel, řekne, kdo to byl, a vrátí to.

## Co se zaznamenává

| Co | Pod kým | Nastavení |
|---|---|---|
| Rozbité bloky i s tím, co měla truhla nebo cedulka | hráč, nebo stroj jako `#` a jeho jméno | `record.break` |
| Položené bloky (hráči, endermani, sněžní golemové) | hráč nebo mob | `record.place` |
| Bloky zničené výbuchem | hráč, který zapálil TNT, když to hra ví, jinak `#tnt`, `#creeper` … | `record.explode` |
| Itemy vzaté z bloku s inventářem a vložené do něj (truhly, sudy, shulkery, úložiště z modů) | hráč | `record.containers` |
| Co dělají stroje: falešní hráči modů jako Create deployer a vrták, quarry | `#` a jméno stroje | `record.machines` |
| Co mod nahlásí událostí `AuditNoted` | vlastní slova modu | `record.notes` |

Ve světech z `worlds.skip` se nezaznamenává nic (výchozí je testovací svět benchmarku Keystone).

**Schválně vynechané:** tekoucí voda a láva, oheň, opadávání listí a růst plodin patří světu a byly by to skoro všechny záznamy. Bloky, které **kontrapce Create a lodě Sable** vyzvednou ze světa, nejsou rozbité - pořád existují uvnitř kontrapce nebo lodi, a jejich vrácení by z nich udělalo dva. Zabité entity tahle verze nezaznamenává.

### Stroje to nezahltí

Vrták v generátoru kamene rozbíjí pořád stejný blok; řetěz TNT tisíce bloků za sekundu.

- `limits.repeat` (`10m`): když příčina, která není hráč, změní stejný blok stejně znovu v tomhle čase, zůstane jeden záznam.
- `limits.cause-per-second` (`5000`): nad tolik záznamů za sekundu od jedné takové příčiny se zbytek sekundy zapíše jako jeden souhrn.

Hráči omezení nemají nikdy.

## Jak to zjistit

**Inspekce:** `/keystone audit inspect`, pak levým kliknutím na blok uvidíš jeho historii, pravým na truhlu, kdo co vzal a vložil. Stejný příkaz ji vypne.

**Filtr** ve stejném tvaru jako u CoreProtectu: `u:` kdo, `t:` jak dávno (`30m`, `2h`, `3d`, `1w`), `r:` poloměr kolem tebe (`#world` celý svět, `#global` všechny), `a:` akce (`break`, `place`, `explode`, `take`, `put`, `note`), `b:` / `e:` jen tyhle bloky / všechno kromě nich, `w:` svět, `xyz:` střed z konzole, `#preview` jen spočítat, `#force` vrátit i tam, kde teď stojí něco jiného. Slovo, které nejde přečíst, se odmítne - nikdy se tiše nevynechá.

`/keystone audit lookup u:Ada t:6h r:30`, další strana `/keystone audit page 2`, `/keystone audit near` je `r:5 t:3d` kolem tebe.

## Rollback

`/keystone audit rollback u:Grief3r t:6h r:40` vrátí, co filtr najde; `/keystone audit restore` se stejným filtrem to provede znovu. Nejdřív si to spočítej s `#preview`.

- **Od nejnovější změny**, takže blok položený, rozbitý a znovu položený skončí, jak začal.
- **Nic se nepřepíše.** Blok se vrátí jen tam, kde teď stojí ten, který změna nechala; co kdo postavil potom, zůstane a započítá se. `#force` to přebije.
- **Bez lagu.** Běží po pár blocích v každém ticku: nejvýš `rollback.budget-ms` (5 ms) a `rollback.per-tick` (2000) změn. Nenačtené chunky si načte a na konci pustí. Bloky se vracejí bez aktualizací sousedů, takže písek nepadá a voda neteče.
- **Truhly:** vzaté itemy se vrátí, vložené zase vyndají - všechno, nebo nic, jen přesně stejné itemy.
- **Pojistky:** rollback potřebuje `t:` a `u:`, `r:` nebo `w:`; nejvýš `rollback.max` (250 000) změn; jeden naráz. Zastaví ho `/keystone audit cancel`.

## CoreProtect

`/keystone import coreprotect` přečte `database.db` z CoreProtectu a převezme jeho historii: rozbité a položené bloky a změny v truhlách. Bukkit názvy světů se převedou (`world_nether` je `minecraft:the_nether`). Další spuštění převezme jen to, co přibylo. Převzaté bloky jdou vrátit rollbackem; převzaté truhly jsou jen k vyhledání. CoreProtect na MySQL přečíst nejde.

## Proč to nic nestojí

Hra si změnu jen všimne a dá řádek do fronty; truhla se zkopíruje při otevření a porovná při zavření. Na disk zapisuje vlastní vlákno po dávkách. Plná fronta (`store.queue`) nové řádky zahodí a ohlásí to - server na disk nikdy nečeká.

Data jsou v `keystone/audit/audit.db`, ve vlastním souboru vedle `keystone.db`. Změna zabere asi **77 bajtů**, obsah truhel se komprimuje (`store.compress`). Starší záznamy mizí po `keep.for` (30 dní), nejstarší první, když soubor přeroste `keep.max-size` (4096 MB). `/keystone audit purge 60d` maže hned.

## Editor

*Block audit & rollback* (v People): filtr jako pole nebo napsaný, změny od nejnovější, **Preview**, **Roll back** a **Restore** s potvrzením, běžící rollback s tlačítkem **Stop** a co se zaznamenává, kolik místa to bere a kolik to stojí v ticku.

## Příkazy

| Příkaz | Co dělá | Oprávnění |
|---|---|---|
| `/keystone audit` | stav a nápověda | `keystone.audit` |
| `/keystone audit inspect` | klikáním na bloky ukáže jejich historii | `keystone.audit` |
| `/keystone audit lookup <filtr>` / `page <n>` / `near` | vyhledá změny | `keystone.audit` |
| `/keystone audit rollback <filtr>` / `restore <filtr>` | vrátí / provede znovu | `keystone.audit.rollback` |
| `/keystone audit cancel` | zastaví běžící rollback | `keystone.audit.rollback` |
| `/keystone audit purge <doba>` | smaže záznamy starší než doba | `keystone.audit.purge` |

## API a události

`GET /v1/block-audit`, `/v1/block-audit/lookup`, `/v1/block-audit/preview`, `POST /v1/block-audit/rollback` (`confirm=true`), `/v1/block-audit/cancel`, `/v1/block-audit/purge`. Scopy `block-audit.read`, `block-audit.write` a `block-audit.purge` mají jen klíče vlastníka. Mody přidají vlastní řádek událostí `AuditNoted` a o rollbacku se dozví z `AuditRolledBack`.

## Soukromí

Všechno zůstává v `audit.db` na serveru. Keystone o tom nikam nic neposílá. Vypni modul v *Settings* a nic se nezaznamenává.
