World Storage

world.cgb

formatVersion :UVarInt
engineVersion :UVarInt
name :string
lastModified :UVarInt //UNIX timestamp
thumbnail :Array(Raw) //Raw bytes of a PNG image

RocksDB

Column Family Name	Usage	Key Schema
worldMeta	Global intrinsic world properties	<property_name>
worldProperties	Global custom world properties	<namespace:property_name>
chunkl0	L0 chunk data	<dimensionID:64><worldCoordsMortonXYZ:192>
chunkl1	L1 chunk data	<dimensionID:64><l1CoordsMortonXYZ:192>
chunkl2	L2 chunk data	<dimensionID:64><l2CoordsMortonXYZ:192>
entity	Entity data	<entityUUID:128>
opacityMap	Cached 2D opacity map data	<dimensionID:64><l2CoordsMortonXZ:128>

worldMeta

Key	Type	Description
seed	u64	World seed.
key	boost::uuids::uuid	World randomizer / hash salt.
time	u64	World time. See Simulation.
packs	array<boost::uuids::uuid>	Pack UUID list.
blocks	varcharArray	Block numerical id mapping.
components	varcharArray	Component numerical id mapping.
entities	varcharArray	Entity numerical id mapping.
structures	varcharArray	Structure numerical id mapping.

---

---

---

---

---

---

enum struct GlobalTypes : u8 {
    WorldProperty = 0, Locality, LocalityRanged, Entity, OpacityMap
};

World

<globalTypeEnum:0x00><propertyHash:64> :unknown

Intrinsic Properties

Locality

localityDataTypeEnum

enum struct LocalityDataTypes : u8 {
    Locality = 0, Block, EntityReference, Light
};

Locality.Locality

<globalTypeEnum:0x01><chunkX:64><chunkY:64><chunkZ:64><localityDataTypeEnum:0x01><localX:8><localY:8><localZ:8><layer:16><componentHash:64> :unknown

Locality.Block

<globalTypeEnum:0x01><chunkX:64><chunkY:64><chunkZ:64><localityDataTypeEnum:0x01><localX:8><localY:8><localZ:8><layer:16><componentHash:64> :unknown

Locality.EntityReference

Single key.

<globalTypeEnum:0x01><chunkX:64><chunkY:64><chunkZ:64><localityDataTypeEnum:0x02> :array<boost::uuids::uuid>

Locality.Light

Light level cache.

<globalTypeEnum:0x01><chunkX:64><chunkY:64><chunkZ:64><localityDataTypeEnum:0x03><localX:8><localY:8><localZ:8> :array<u8, 3>

LocalityRanged

Arbitrary ranged locality data. All coordinates are world coordinates.

<globalTypeEnum:0x02><startX:64><startY:64><startZ:64><endX:64><endY:64><endZ:64><componentHash:64> :unknown

Entity

Entity components.

<globalTypeEnum:0x03><entityID:128><componentHash:64> :unknown

OpacityMap

2D opacity map cache.

<globalTypeEnum:0x04><chunkX:64><chunkZ:64><localX:8><localZ:8> :array<i64>