add fragment_file_spec.md
This commit is contained in:
parent
8187568e69
commit
b4e0933563
27
doc/specs/fragment_file_spec.md
Normal file
27
doc/specs/fragment_file_spec.md
Normal file
@ -0,0 +1,27 @@
|
|||||||
|
# Fragment file (.vox)
|
||||||
|
|
||||||
|
Current version is 1.
|
||||||
|
|
||||||
|
Fragment file is [vcbjson file](binary_json_spec.md).
|
||||||
|
|
||||||
|
JSON schema representation format in [Orderly](https://orderly-json.org/docs/) language:
|
||||||
|
|
||||||
|
```
|
||||||
|
object {
|
||||||
|
integer version {1,};
|
||||||
|
array {integer;} {1,} size;
|
||||||
|
array {string;} block-names;
|
||||||
|
array {integer;} {0,65535} voxels;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Where:
|
||||||
|
- **version** is fragment file format version.
|
||||||
|
- **size** is fragment size (three positive integers).
|
||||||
|
- **block-names** is array of full block names: `pack_id:block_name`.
|
||||||
|
- **voxels**: voxels data array: *index, state, index, state...*
|
||||||
|
where:
|
||||||
|
- index is based on block-names array.
|
||||||
|
- state - see [block state](region_voxels_chunk_spec.md#block-state).
|
||||||
|
|
||||||
|
**block-names** must have `core:air` as the first element.
|
||||||
Loading…
x
Reference in New Issue
Block a user