Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

概念

  • スナップショット (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”)を参照してください。