add block.raycast(...)

doc/en/scripting.md

@@ -482,6 +482,20 @@ block.set_user_bits(x: int, y: int, z: int, offset: int, bits: int, value: int)
 ```
 Set specified bits.
 
+```lua
+block.raycast(start: vec3, dir: vec3, max_distance: number) -> {
+    block: int, -- block id
+    endpoint: vec3, -- point of the ray hit point
+    iendpoint: vec3, -- position of the block hit by the ray
+    length: number, -- ray length
+    normal: vec3, -- normal vector of the surface hit by the ray
+} or nil
+```
+
+Casts a ray from the start point in the direction of dir. Max_distance specifies the maximum ray length.
+
+The function returns a table with the results or nil if the ray does not hit any block.
+
 ## *item* library
 
 ```python

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, если луч не касается блока.
+
 ### Вращение
 
 Следующие функции используется для учёта вращения блока при обращении к соседним блокам или других целей, где направление блока имеет решающее значение.

src/logic/scripting/lua/libblock.cpp

@@ -307,6 +307,39 @@ static int l_get_picking_item(lua::State* L) {
     return 0;
 }
 
+static int l_raycast(lua::State* L) {
+    auto start = lua::tovec<3>(L, 1);
+    auto dir = lua::tovec<3>(L, 2);
+    auto maxDistance = lua::tonumber(L, 3);
+    glm::vec3 end;
+    glm::ivec3 normal;
+    glm::ivec3 iend;
+    if (auto voxel = level->chunks->rayCast(start, dir, maxDistance, end, normal, iend)) {
+        if (lua::gettop(L) >= 4) {
+            lua::pushvalue(L, 4);
+        } else {
+            lua::createtable(L, 0, 5);
+        }
+        
+        lua::pushvec3_arr(L, end);
+        lua::setfield(L, "endpoint");
+
+        lua::pushvec3_arr(L, normal);
+        lua::setfield(L, "normal");
+
+        lua::pushnumber(L, glm::distance(start, end));
+        lua::setfield(L, "length");
+
+        lua::pushvec3_arr(L, iend);
+        lua::setfield(L, "iendpoint");
+
+        lua::pushinteger(L, voxel->id);
+        lua::setfield(L, "block");
+        return 1;
+    }
+    return 0;
+}
+
 const luaL_Reg blocklib [] = {
     {"index", lua::wrap<l_index>},
     {"name", lua::wrap<l_name>},
@@ -335,5 +368,6 @@ const luaL_Reg blocklib [] = {
     {"get_hitbox", lua::wrap<l_get_hitbox>},
     {"get_rotation_profile", lua::wrap<l_get_rotation_profile>},
     {"get_picking_item", lua::wrap<l_get_picking_item>},
+    {"raycast", lua::wrap<l_raycast>},
     {NULL, NULL}
 };