Merge branch 'main' into debugging-client

doc/ru/scripting/events.md

@@ -4,6 +4,10 @@
 
 Функции для обработки событий, прописываемые в скрипте блока.
 
+> [!WARNING]
+> Mass events such as on_block_tick, on_block_present, and on_block_removed, 
+> if used carelessly or excessively, can lead to performance issues.
+
 ```lua
 function on_placed(x, y, z, playerid)
 ```
@@ -53,6 +57,21 @@ function on_block_tick(x, y, z, tps: number)
 Вызывается tps (20 / tick-interval) раз в секунду для конкретного блока.
 Используйте 1/tps вместо `time.delta()`.
 
+```lua
+function on_block_present(x, y, z)
+```
+
+Вызывается для конкретного блока при появлении (генерации/загрузке/размещении).
+Вызов происходит в течение времени, которое может зависеть от нагрузки очереди событий.
+При малой нагрузке происходит в течение первого такта блока (tick-interval).
+До вызова события on_block_tick не вызывается.
+
+```lua
+function on_block_removed(x, y, z)
+```
+
+Вызывается при выгрузке чанка, в котором находится блок.
+
 ```lua
 function on_player_tick(playerid: int, tps: int)
 ```

doc/ru/scripting/ui.md

@@ -186,21 +186,29 @@ document["worlds-panel"]:clear()
 - r: int, g: int, b: int
 - r: int, g: int, b: int, a: int
 
-| Метод                                                    | Описание                                             |
-|----------------------------------------------------------|------------------------------------------------------|
-| data:at(x: int, y: int)                                  | возвращает RGBA пиксель по указанным координатам     |
-| data:set(x: int, y: int, *цвет*)                         | изменяет RGBA пиксель по указанным координатам       |
-| data:line(x1: int, y1: int, x2: int, y2: int, *цвет*)    | рисует линию с указанным RGBA цветом                 |
-| data:blit(src: Canvas, dst_x: int, dst_y: int)           | рисует src-холст на указанных координатах            |
-| data:clear()                                             | очищает холст                                        |
-| data:clear(*цвет*)                                       | заполняет холст указанным RGBA цветом                |
-| data:update()                                            | применяет изменения и загружает холст в видеопамять  |
-| data:set_data(data: table<int>)                          | заменяет данные пикселей (ширина * высота * 4 чисел) |
-| data:create_texture(name: str)                           | создаёт и делится текстурой с рендерером             |
-| data:unbind_texture()                                    | отвязывает текстуру от холста                        |
-| data:mul(*цвет* или Canvas)                              | умножает увет на указанный цвет или холст            |
-| data:add(*цвет* или Canvas)                              | прибавляет цвет или другой холст к цвету             |
-| data:sub(*цвет* или Canvas)                              | вычитает цвет или другой холст к цвету               |
+| Метод                                                    | Описание                                                        |
+|----------------------------------------------------------|-----------------------------------------------------------------|
+| data:at(x: int, y: int)                                  | возвращает RGBA пиксель по указанным координатам                |
+| data:set(x: int, y: int, *цвет*)                         | изменяет RGBA пиксель по указанным координатам                  |
+| data:line(x1: int, y1: int, x2: int, y2: int, *цвет*)    | рисует линию с указанным RGBA цветом                            |
+| data:blit(src: Canvas, dst_x: int, dst_y: int)           | рисует src-холст на указанных координатах                       |
+| data:clear()                                             | очищает холст                                                   |
+| data:clear(*цвет*)                                       | заполняет холст указанным RGBA цветом                           |
+| data:update()                                            | применяет изменения и загружает холст в видеопамять             |
+| data:set_data(data: table<int>)                          | заменяет данные пикселей (ширина * высота * 4 чисел)            |
+| data:create_texture(name: str)                           | создаёт и делится текстурой с рендерером                        |
+| data:unbind_texture()                                    | отвязывает текстуру от холста                                   |
+| data:mul(*цвет* или Canvas)                              | умножает увет на указанный цвет или холст                       |
+| data:add(*цвет* или Canvas)                              | прибавляет цвет или другой холст к цвету                        |
+| data:sub(*цвет* или Canvas)                              | вычитает цвет или другой холст к цвету                          |
+| data:encode(format: str)                                 | кодирует изображение в указанный формат и возращает массив байт |
+
+Для декодирования массива байт в Canvas используйте статический метод:
+```lua
+Canvas.decode(data: Bytearray, format: str) -> Canvas
+```
+
+На данный момент, из форматов поддерживается только png.
 
 ## Рамка встраивания (iframe)