add doc/*/scripting/builtins/libgfx-blockwraps.md

doc/ru/scripting.md

@@ -15,6 +15,7 @@
     - [cameras](scripting/builtins/libcameras.md)
     - [entities](scripting/builtins/libentities.md)
     - [file](scripting/builtins/libfile.md)
+    - [gfx.blockwraps](scripting/builtins/libgfx-blockwraps.md)
     - [gfx.particles](particles.md#библиотека-gfxparticles)
     - [gfx.text3d](3d-text.md#библиотека-gfxtext3d)
     - [gui](scripting/builtins/libgui.md)

doc/ru/scripting/builtins/libgfx-blockwraps.md

@@ -0,0 +1,23 @@
+# Библиотека *gfx.blockwraps*
+
+Библиотека для работы с *обертками блоков*.
+
+Обёртки блоков введены для реализации анимации разрушения блоков и могут
+использоваться для иных задач.
+
+```lua
+-- Создаёт обертку на указанной позиции, с указанной текстурой.
+-- Возвращает id обёртки.
+gfx.blockwraps.wrap(position: vec3, texture: str) --> int
+
+-- Удаляет обертку, если она существует.
+gfx.blockwraps.unwrap(id: int)
+
+-- Меняет позицию обёртки, если она существует.
+gfx.blockwraps.set_pos(id: int, position: vec3)
+
+-- Меняет текстуру обёртки, если она существует.
+gfx.blockwraps.set_texture(id: int, texture: str)
+```
+
+Обертки не удаляются автоматически без вызова `unwrap`.