add block.raycast(...)

doc/ru/scripting.md

@@ -402,6 +402,20 @@ block.get_picking_item(id: int) -> int
 
 Возвращает числовой id предмета, указанного в свойстве *picking-item*.
 
+```lua
+block.raycast(start: vec3, dir: vec3, max_distance: number) -> {
+    block: int, -- id блока
+    endpoint: vec3, -- точка касания луча
+    iendpoint: vec3, -- позиция блока, которого касается луч
+    length: number, -- длина луча
+    normal: vec3, -- вектор нормали поверхности, которой касается луч
+} или nil
+```
+
+Бросает луч из точки start в направлении dir. Max_distance указывает максимальную длину луча.
+
+Функция возвращает таблицу с результатами или nil, если луч не касается блока.
+
 ### Вращение
 
 Следующие функции используется для учёта вращения блока при обращении к соседним блокам или других целей, где направление блока имеет решающее значение.