add block.compose_state(...), block.decompose_state(...)

doc/en/scripting/builtins/libblock.md

@@ -14,6 +14,7 @@ block.material(blockid: int) -> str
 block.caption(blockid: int) -> str
 
 -- Returns integer ID by block position
+-- If the chunk at the specified coordinates is not loaded, returns -1.
 block.get(x: int, y: int, z: int) -> int
 
 -- Returns block state (rotation + additional information) as an integer.
@@ -31,6 +32,12 @@ block.place(x: int, y: int, z: int, id: int, states: int, [optional] playerid: i
 -- Breaks a block at the given coordinates on behalf of the player, triggering the on_broken event.
 -- playerid is optional
 block.destruct(x: int, y: int, z: int, playerid: int)
+
+-- Compose the complete state as an integer
+block.compose_state(rotation: int, segment: int, userbits: int) -> int
+
+-- Decompose the complete state into: rotation, segment, user bits
+block.decompose_state(state: int) -> int, int, int
 ```
 
 > [!WARNING]

doc/ru/scripting/builtins/libblock.md

@@ -17,7 +17,7 @@ block.caption(blockid: int) -> str
 -- Если чанк на указанных координатах не загружен, возвращает -1.
 block.get(x: int, y: int, z: int) -> int
 
--- Возвращает состояние (поворот + доп. информация) в виде целого числа
+-- Возвращает полное состояние (поворот + сегмент + доп. информация) в виде целого числа
 block.get_states(x: int, y: int, z: int) -> int
 
 -- Устанавливает блок с заданным числовым id и состоянием (0 - по-умолчанию) на заданных координатах.
@@ -31,6 +31,12 @@ block.place(x: int, y: int, z: int, id: int, states: int, [optional] playerid: i
 -- Ломает блок на заданных координатах от лица игрока, вызывая событие on_broken.
 -- playerid не является обязательным
 block.destruct(x: int, y: int, z: int, playerid: int)
+
+-- Собирает полное состояние в виде целого числа
+block.compose_state(rotation: int, segment: int, userbits: int) -> int
+
+-- Разбирает полное состояние на: вращение, сегмент, пользовательские биты
+block.decompose_state(state: int) -> int, int, int
 ```
 
 > [!WARNING]