xLua (Tencent/xLua)
Searching Database…
Что это такое?
xLua добавляет поддержку скриптов на Lua в среды на C# — Unity, .Net и Mono — благодаря чему код на Lua и C# могут легко вызывать друг друга. Обычно это используют для написания игровой логики Unity-игр на Lua.
А где именно выполняется Lua — xLua несёт свой собственный интерпретатор?
Да. Каждый созданный вами экземпляр LuaEnv соответствует отдельной виртуальной машине Lua, а в README советуют держать ровно один такой экземпляр — глобально единственный, чтобы не тратить лишние ресурсы.
Как добавить его в свой Unity-проект?
Скачайте сборку со страницы GitHub Releases (или заберите код репозитория), затем перенесите содержимое его каталога Assets в папку Assets вашего проекта, сохранив структуру. Перед выпуском в продакшн удалите Assets/Examples.
Нужно ли ставить что-то ещё вместе с ним?
Нет — он устанавливается как обычный исходный код прямо в ваш Unity-проект, без каких-либо внешних шагов. Если позже захотите сторонние Lua-библиотеки, для их добавления и удаления есть отдельное руководство.
Функция хотфикса работает сразу из коробки?
Нет — её сначала нужно включить; в примере 08Hotfix указано, что следует воспользоваться руководством по хотфиксам в документации, чтобы её активировать.
Он будет работать в мобильных сборках или только на десктопе?
Мобильные платформы поддерживаются на равных: проект работает на android и ios наряду с windows, linux и osx.
Что вообще можно делать со стороны Lua?
В комплекте есть примеры, которые показывают, как писать MonoBehaviour и логику интерфейса на Lua, сочетать ООП на Lua с C#, запускать корутины Lua рядом с корутинами Unity (даже превращая асинхронный код в синхронный), вызывать обобщённые (generic) методы, загружать скрипты с цифровой подписью и заново реализовывать value-типы C# на Lua.
Сколько нужно кода для hello world?
Три строки: создаёте LuaEnv и вызываете DoString с любым валидным кодом на Lua — в примере из quickstart лог ведётся через UnityEngine.Debug.Log из C#, причём прямо из кода на Lua. C# тоже может вызывать Lua, например доставая функцию Lua из глобальной таблицы.
Зачем нужна функция хотфикса?
Она подменяет методы, операторы, свойства и события C# их реализациями на Lua прямо во время выполнения. В старые проекты не нужно вносить изменений в код, а пока патч не сработал, программа ведёт себя как раньше — так можно чинить проблемы уже вышедшей сборки средствами Lua.
Есть ли какие-то особенности по производительности?
Да — xLua выделяет оптимизации, связанные со сборщиком мусора (GC): собственные структуры и перечисления передаются между Lua и C# без выделений памяти в C# GC. Кроме того, при работе в редакторе генерация кода пропускается, что облегчает цикл разработки.
What are similar projects?
nakama, UniTask, AssetStudio, unity-mcp, UnityCsReference, osu, MonoGame, Cpp2IL
