概念
- スナップショット (Snapshot): 記録された1つのワールド状態であり、作成順に番号付けされます(
listでは古い順に表示されます)。スナップショットは新しい行のみを保存します。読み取り時にはフォールバックを通じて実効状態を解決するため、メタデータはワールド全体のサイズではなく、変更内容に応じて増加します。 - Blob (CAS key): 解凍前の生チャンクペイロードであり、フレーミングを含めてハッシュ化されます。同一のペイロードはすべてのスナップショット間で1つの保存コピーを共有します。ロールバックはこのバイト列を忠実に復元し、
LastUpdateなどの揮発性タグを取得時刻に巻き戻します。 - Diff ハッシュ (Diff hash): 必須ではないタグを除外した、解凍済み NBT に対するオプトインの揮発性ビューです。変更検知を高速化するためだけに使用され、保存された Blob を変更することはありません。
- 墓標 (Tombstone): 明示的な「チャンク非存在」行です。バックアップ間で削除されたチャンクは、記録なし(サイレント)ではなく墓標として記録されます。これにより、ロールバック時に正しく再削除できます。
- 導出状態 (Derived state):
region_stateのフィンガープリントにより、次回のバックアップが高速化されます。これらを消去しても、高々1回のフルインジェストのコストがかかるのみで、間違ったデータが作成されることはありません。
正式な定義は ARCHITECTURE.md (“Data & Hashing Model” および “History, State, and GC Model”)を参照してください。