Documentation
¶
Index ¶
- Constants
- Variables
- func DecodeBiomes(buf *bytes.Buffer, c *Chunk, e Encoding) error
- func EncodeBiomes(c *Chunk, e Encoding) []byte
- func EncodeSubChunk(c *SubChunk, r define.Range, ind int, e Encoding) []byte
- type Chunk
- func (chunk *Chunk) Biome(x uint8, y int16, z uint8) uint32
- func (chunk *Chunk) Biomes() [][]uint32
- func (chunk *Chunk) Block(x uint8, y int16, z uint8, layer uint8) uint32
- func (chunk *Chunk) Blocks(layer uint8) [][]uint32
- func (chunk *Chunk) Compact()
- func (chunk *Chunk) Equals(c *Chunk) bool
- func (chunk *Chunk) HighestBlock(x, z uint8) int16
- func (chunk *Chunk) HighestFilledSubChunk() uint16
- func (chunk *Chunk) Range() define.Range
- func (chunk *Chunk) SetBiome(x uint8, y int16, z uint8, biome uint32)
- func (chunk *Chunk) SetBiomes(biomes [][]uint32)
- func (chunk *Chunk) SetBlock(x uint8, y int16, z uint8, layer uint8, block uint32)
- func (chunk *Chunk) SetBlocks(layer uint8, blocks [][]uint32)
- func (chunk *Chunk) SetSub(subChunks []*SubChunk)
- func (chunk *Chunk) SetSubChunk(subChunk *SubChunk, index int16)
- func (chunk *Chunk) Sub() []*SubChunk
- func (chunk *Chunk) SubChunk(y int16) *SubChunk
- func (chunk *Chunk) SubIndex(y int16) int16
- func (chunk *Chunk) SubY(index int16) int16
- type Encoding
- type Palette
- type PalettedStorage
- type SerialisedData
- type SubChunk
- func (sub *SubChunk) Block(x, y, z byte, layer uint8) uint32
- func (sub *SubChunk) Blocks(layer uint8) []uint32
- func (sub *SubChunk) Empty() bool
- func (sub *SubChunk) Equals(s *SubChunk) bool
- func (sub *SubChunk) Layer(layer uint8) *PalettedStorage
- func (sub *SubChunk) Layers() []*PalettedStorage
- func (sub *SubChunk) SetBlock(x, y, z byte, layer uint8, block uint32)
- func (sub *SubChunk) SetBlocks(layer uint8, blocks []uint32)
Constants ¶
const ( // SubChunkVersion is the current version of the written sub chunks, specifying the format they are // written on disk and over network. SubChunkVersion = 9 // CurrentBlockVersion is the current version of blocks (states) of the game. This version is composed // of 4 bytes indicating a version, interpreted as a big endian int. The current version represents // 1.21.60.33 {1, 21, 60, 33}. CurrentBlockVersion int32 = 18168865 )
Variables ¶
var ( // DiskEncoding is the Encoding for writing a Chunk to disk. It writes block palettes using NBT and does not use // varints. DiskEncoding diskEncoding // NetworkEncoding is the Encoding used for sending a Chunk over network. It does not use NBT and writes varints. NetworkEncoding networkEncoding // BiomePaletteEncoding is the paletteEncoding used for encoding a palette of biomes. BiomePaletteEncoding biomePaletteEncoding // BlockPaletteEncoding is the paletteEncoding used for encoding a palette of block states encoded as NBT. BlockPaletteEncoding blockPaletteEncoding )
Functions ¶
func DecodeBiomes ¶
DecodeBiomes reads the paletted storages holding biomes from buf and stores it into the Chunk passed.
func EncodeBiomes ¶
EncodeBiomes encodes the biomes of a chunk into bytes. An Encoding may be passed to encode either for network or disk purposed, the most notable difference being that the network encoding generally uses varints and no NBT.
func EncodeSubChunk ¶
EncodeSubChunk encodes a sub-chunk from a chunk into bytes. An Encoding may be passed to encode either for network or disk purposed, the most notable difference being that the network encoding generally uses varints and no NBT.
Types ¶
type Chunk ¶
type Chunk struct {
// contains filtered or unexported fields
}
Chunk is a segment in the world with a size of 16x16x256 blocks. A chunk contains multiple sub chunks and stores other information such as biomes. It is not safe to call methods on Chunk simultaneously from multiple goroutines.
func DiskDecode ¶
func DiskDecode(data SerialisedData, r define.Range) (*Chunk, error)
DiskDecode decodes the data from a SerialisedData object into a chunk and returns it. If the data was invalid, an error is returned.
func NetworkDecode ¶
NetworkDecode decodes the network serialised data passed into a Chunk if successful. If not, the chunk returned is nil and the error non-nil. The sub chunk count passed must be that found in the LevelChunk packet. noinspection GoUnusedExportedFunction
func (*Chunk) Biomes ¶
Blocks returns all biome IDs for each blocks in this chunk. The length of returned slice is the sub chunk counts of this chunk. For example, for a completely overworld chunk, the length is 24. Note that for each slice in this big slice, the length of it is 4096 (16*16*16).
func (*Chunk) Block ¶
Block returns the runtime ID of the block at a given x, y and z in a chunk at the given layer. If no sub chunk exists at the given y, the block is assumed to be air.
func (*Chunk) Blocks ¶
Blocks returns all blocks (block runtime ids) whose in the target layer of this chunk. The length of returned slice is the sub chunk counts of this chunk. For example, for a completely overworld chunk, the length is 24. Note that for each slice in this big slice, the length of it is 4096 (16*16*16).
func (*Chunk) Compact ¶
func (chunk *Chunk) Compact()
Compact compacts the chunk as much as possible, getting rid of any sub chunks that are empty, and compacts all storages in the sub chunks to occupy as little space as possible. Compact should be called right before the chunk is saved in order to optimise the storage space.
func (*Chunk) HighestBlock ¶ added in v1.5.0
TODO: Expose this function to C API.
HighestBlock iterates from the highest non-empty sub chunk downwards to find the Y value of the highest non-air block at an x and z. If no blocks are present in the column, the minimum height is returned.
func (*Chunk) HighestFilledSubChunk ¶
HighestFilledSubChunk returns the index of the highest sub chunk in the chunk that has any blocks in it. 0 is returned if no subchunks have any blocks.
func (*Chunk) SetBiomes ¶
SetBiomes sets the biome IDs for each blocks in this chunk. The length of biomes could less or bigger than the sub chunk counts of this whole chunk.
If less, then only the given part will be modified, if bigger, then the bigger part will be not used.
The length of each slice in this big slice must be 4096 (16*16*16).
func (*Chunk) SetBlock ¶
SetBlock sets the runtime ID of a block at a given x, y and z in a chunk at the given layer. If no SubChunk exists at the given y, a new SubChunk is created and the block is set.
func (*Chunk) SetBlocks ¶
SetBlocks sets the whole chunk blocks in layer by given block runtime ids. The length of blocks could less or bigger than the sub chunk counts of this whole chunk.
If less, then only the given part will be modified, if bigger, then the bigger part will be not used.
The length of each slice in this big slice must be 4096 (16*16*16).
func (*Chunk) SetSub ¶
SetSub overwrite the sub chunks of this chunk.
The length of subChunks could less or bigger than the sub chunk counts of this whole chunk.
If less, then only the given part will be modified, if bigger, then the bigger part will be not used.
func (*Chunk) SetSubChunk ¶
SetSubChunk set the a sub chunk of this chunk. index is refer to the sub chunk Y index of this sub chunk.
type Encoding ¶
type Encoding interface {
// contains filtered or unexported methods
}
Encoding is an encoding type used for Chunk encoding. Implementations of this interface are DiskEncoding and NetworkEncoding, which can be used to encode a Chunk to an intermediate disk or network representation respectively.
type Palette ¶
type Palette struct {
// contains filtered or unexported fields
}
Palette is a palette of values that every PalettedStorage has. Storages hold 'pointers' to indices in this palette.
func NewPalette ¶
NewPalette returns a new Palette with size and a slice of added values.
func (*Palette) Add ¶
Add adds a values to the Palette. It does not first check if the value was already set in the Palette. The index at which the value was added is returned. Another bool is returned indicating if the Palette was resized as a result of adding the value.
func (*Palette) Index ¶
Index loops through the values of the Palette and looks for the index of the given value. If the value could not be found, -1 is returned.
type PalettedStorage ¶
type PalettedStorage struct {
// contains filtered or unexported fields
}
PalettedStorage is a storage of 4096 blocks encoded in a variable amount of uint32s, storages may have values with a bit size per block of 0, 1, 2, 3, 4, 5, 6, 8 or 16 bits. 3 of these formats have additional padding in every uint32 and an additional uint32 at the end, to cater for the blocks that don't fit. This padding is present when the storage has a block size of 3, 5 or 6 bytes. Methods on PalettedStorage must not be called simultaneously from multiple goroutines.
func (*PalettedStorage) At ¶
func (storage *PalettedStorage) At(x, y, z byte) uint32
At returns the value of the PalettedStorage at a given x, y and z.
func (*PalettedStorage) Equal ¶
func (storage *PalettedStorage) Equal(other *PalettedStorage) bool
Equal checks if two PalettedStorages are equal value wise. False is returned if either of the storages are nil.
func (*PalettedStorage) Palette ¶
func (storage *PalettedStorage) Palette() *Palette
Palette returns the Palette of the PalettedStorage.
func (*PalettedStorage) Set ¶
func (storage *PalettedStorage) Set(x, y, z byte, v uint32)
Set sets a value at a specific x, y and z. The Palette and PalettedStorage are expanded automatically to make space for the value, should that be needed.
type SerialisedData ¶
type SerialisedData struct {
// sub holds the data of the serialised sub chunks in a chunk. Sub chunks that are empty or that otherwise
// don't exist are represented as an empty slice (or technically, nil).
SubChunks [][]byte
// Biomes is the biome data of the chunk, which is composed of a biome storage for each sub-chunk.
Biomes []byte
}
SerialisedData holds the serialised data of a chunk. It consists of the chunk's block data itself, a height map, the biomes and entities and block entities.
func Encode ¶
func Encode(c *Chunk, e Encoding) SerialisedData
Encode encodes Chunk to an intermediate representation SerialisedData. An Encoding may be passed to encode either for network or disk purposed, the most notable difference being that the network encoding generally uses varints and no NBT.
type SubChunk ¶
type SubChunk struct {
// contains filtered or unexported fields
}
SubChunk is a cube of blocks located in a chunk. It has a size of 16x16x16 blocks and forms part of a stack that forms a Chunk.
func DecodeSubChunk ¶
func DecodeSubChunk(buf *bytes.Buffer, r define.Range, e Encoding) (subChunk *SubChunk, index int, err error)
DecodeSubChunk decodes a SubChunk from a bytes.Buffer. The Encoding passed defines how the block storages of the SubChunk are decoded.
func NewSubChunk ¶
NewSubChunk creates a new sub chunk. All sub chunks should be created through this function
func (*SubChunk) Block ¶
Block returns the runtime ID of the block located at the given X, Y and Z. X, Y and Z must be in a range of 0-15.
func (*SubChunk) Blocks ¶
Blocks returns all blocks (block runtime ids) whose in layer. If layer is not exist, then return blocks with all air. Note that the length of returned slice is 4096 (16*16*16).
func (*SubChunk) Empty ¶
Empty checks if the SubChunk is considered empty. This is the case if the SubChunk has 0 block storages or if it has a single one that is completely filled with air.
func (*SubChunk) Layer ¶
func (sub *SubChunk) Layer(layer uint8) *PalettedStorage
Layer returns a certain block storage/layer from a sub chunk. If no storage at the layer exists, the layer is created, as well as all layers between the current highest layer and the new highest layer.
func (*SubChunk) Layers ¶
func (sub *SubChunk) Layers() []*PalettedStorage
Layers returns all layers in the sub chunk. This method may also return an empty slice.
Source Files