(feat/sol): Switch Lua C API to SOL

CMakeLists.txt

@@ -19,3 +19,17 @@ if (LUA_VERSION MATCHES "luajit")
 else()
   add_subdirectory(src/lualib/lua)
 endif()
+
+# sol (C++ <-> Lua binding library, header-only) is bundled in src/lualib/sol.
+# Attaching it to lualib as INTERFACE propagates <sol/sol.hpp> and its compile
+# definitions to every consumer of lualib, whichever Lua backend is selected.
+# SYSTEM keeps the vendored header out of our warning surface: sol carries
+# GCC-only pragmas that clang would otherwise reject under -Werror.
+target_include_directories(lualib SYSTEM INTERFACE "${CMAKE_CURRENT_SOURCE_DIR}/src/lualib")
+
+# Keep sol runtime safety checks enabled in every build type: script errors must
+# surface as catchable Lua errors, never as undefined behaviour in the server.
+# SOL_EXCEPTIONS_SAFE_PROPAGATION=0 makes sol catch C++ exceptions at the
+# binding boundary and convert them into regular Lua errors carrying their
+# message; without it LuaJIT swallows them into a generic "C++ exception".
+target_compile_definitions(lualib INTERFACE SOL_ALL_SAFETIES_ON=1 SOL_EXCEPTIONS_SAFE_PROPAGATION=0)

src/LuaEngine/ALEBind.cpp

@@ -0,0 +1,61 @@
+/*
+* Copyright (C) 2010 - 2025 Eluna Lua Engine <https://elunaluaengine.github.io/>
+* This program is free software licensed under GPL version 3
+* Please see the included DOCS/LICENSE.md for more information
+*/
+
+#include "ALEBind.h"
+
+#include "Corpse.h"
+#include "GameObject.h"
+#include "Item.h"
+#include "Object.h"
+#include "Pet.h"
+#include "Player.h"
+#include "Transport.h"
+
+namespace ALEBind
+{
+    sol::object ToLuaDynamic(sol::state_view lua, Object const* obj)
+    {
+        if (!obj)
+            return sol::make_object(lua, sol::nil);
+
+        if (Player const* player = obj->ToPlayer())
+            return sol::make_object(lua, PlayerRef(player));
+
+        if (Creature* creature = const_cast<Object*>(obj)->ToCreature())
+        {
+            if (Pet const* pet = creature->ToPet())
+                return sol::make_object(lua, PetRef(pet));
+
+            return sol::make_object(lua, CreatureRef(creature));
+        }
+
+        if (GameObject* go = const_cast<Object*>(obj)->ToGameObject())
+        {
+            if (Transport const* transport = go->ToTransport())
+                return sol::make_object(lua, TransportRef(transport));
+
+            return sol::make_object(lua, GameObjectRef(go));
+        }
+
+        if (Corpse const* corpse = obj->ToCorpse())
+            return sol::make_object(lua, CorpseRef(corpse));
+
+        if (obj->IsItem())
+            return sol::make_object(lua, ItemRef(static_cast<Item const*>(obj)));
+
+        return sol::make_object(lua, sol::nil);
+    }
+
+    sol::object ToLuaDynamic(sol::state_view lua, WorldObject const* obj)
+    {
+        return ToLuaDynamic(lua, static_cast<Object const*>(obj));
+    }
+
+    sol::object ToLuaDynamic(sol::state_view lua, Unit const* unit)
+    {
+        return ToLuaDynamic(lua, static_cast<Object const*>(unit));
+    }
+}