Skip to main content

Supported versions & platforms

Reading this matrix​

Support policy is not a claim that every engine / Unity / OS combination has been tested. Luau is branch-specific; PUC-Rio's platform list describes design coverage. The published performance report verifies Win64 Il2Cpp / Unity 2022.3.62f3 only. Before shipping, run the project's correctness tests and a build smoke test on each target. Additional platform results should include the package revision, Unity / Lua versions, device, and test report.

Lua engines​

VersionMono (Editor)Il2Cpp (Player)Notes
Lua 5.1.x✅✅Optional in Settings (e.g. lua-5.1.5); no VM FastMT patch
Lua 5.2.x✅✅Optional in Settings (e.g. lua-5.2.4); no VM FastMT patch
Lua 5.3.x✅✅Optional in Settings; default is lua-5.5.0
Lua 5.4.x✅✅Optional in Settings
Lua 5.5.x✅✅Optional in Settings
LuaJIT✅⚠️Available in Editor (Mono); Il2Cpp Player only Android / iOS (bring your own static libs — see LuaJIT build)
Luau✅✅Official repo luau branch. Editor is Windows only; Il2Cpp is Windows x64 for now. See below

PUC-Rio patch versions use Settings luaVersionId (lua-X.Y.Z); LuaJIT uses luajit-M.N; Luau uses luau-M.N (for example luau-0.743). Install loads them into the local tree. See Installation, Multi-version.

Luau​

The implementation lives on the official luau branch (not merged to main). Point the UPM dependency at https://github.com/focus-creative-games/zlua.git#luau, and set Settings luaVersionId to luau-M.N (for example luau-0.743, the matching tag on luau-lang/luau).

Install shallow-clones that tag into Library/ZLua/LuaSrcCache/luau-M.N/, copies only the public headers (lua.h, luaconf.h, lualib.h, luacode.h) into libil2cpp/lua, and builds Win64 static libraries with CMake + Visual Studio 2022 (x64), linked through generated/LuauLink.inc. The machine needs git, CMake, and Visual Studio 2022. patches/lua is not applied, and ZLUA_FAST_METATABLE is 0.

Luau's luaL_openlibs does not provide package / require / loadstring. ZLua adds package, require, load, and loadstring after opening the standard libraries.

Editor (Mono) works, and only on Windows. The Editor on other desktops is outside the current support surface. Il2Cpp currently links Win64 static libraries only, so other Player targets are outside this build as well.

Unity​

Minimum supported version: Unity 2022.3 LTS. Only LTS series and Tuanjie based on Unity 2022.3.x are supported. Unity 2021 and earlier, and non-LTS Update / Tech Stream releases are outside the support policy.

VersionStatus
Unity 6.0 LTS 6000.0.xSupported
Unity 6.3 LTS 6000.3.xSupported
Unity 2022.3 LTSSupported
Tuanjie LTS based on 2022.3.xSupported

libil2cpp patch resolution prefers patches/libil2cpp/6000.{minor}/, then falls back to 6000/. See Multi-version.

Scripting Backend​

BackendEnvironmentFeature status
Il2CppPlayer shippingDone (authoritative implementation)
MonoUnity EditorDone (Lua-visible semantics match Il2Cpp)

Lua-visible semantics match on both ends; Indexer / bridge implementations differ. See Project status, Spec.

Il2Cpp builds: before shipping, run ZLua/Generate/All (C++ stubs, not C# Wrap).

Target platforms (Il2Cpp)​

EngineIl2Cpp Player platforms
PUC-Rio (Lua 5.1–5.5)Designed for common Il2Cpp targets (Windows, macOS, iOS, Android, WebGL, WeChat mini games, HarmonyOS / vehicle, etc.)
LuaJITAndroid and iOS only; Win / macOS / Linux / WebGL etc. unsupported. Build static .a into Plugins yourself — see LuaJIT build
LuauOn the luau branch: Editor is Windows only; Il2Cpp is Windows x64 for now (Install builds and links the static libraries)

For other platform issues, please file an Issue.


Feature × runtime matrix​

✅ Available · ⚠️ Limited (see notes) · ❌ Unsupported (intentional). Details follow the Spec.

Lua calling C#​

FeatureMonoIl2CppNotes
class / struct access✅✅Lazy bind; no C# Wrap whitelist
Instance / static fields✅✅
Instance / static methods✅✅
Property (no args)✅✅
Property (indexer)✅✅Via method forms get_Item / set_Item; see Fields & properties
Method overload dispatch✅✅
[LuaAlias] / full-signature keys✅✅Short names only via Bind-time aliases; no runtime register_method
Generic class / method✅✅Open generics must be closed first; static generic methods have limits
Array (szarray / mdarray)✅✅mdarray cannot be table-serialized
Event-specific metatable❌❌Use ordinary add_ / remove_ methods
Delegate / Lua callbacks✅✅Lua→C# byref params have limits

C# calling Lua​

FeatureMonoIl2Cpp
GetFunction<T>✅✅
Multi-arg / multi-return✅✅
[LuaMarshalAs]✅✅

Marshal​

TypeMonoIl2Cpp
Primitives / string✅✅
enum (default integer)✅✅
class / struct (ByVal / ByObj / Opaque)✅✅
array✅✅
OpaqueValue / byref✅✅

Standard library zlua​

APIMonoIl2Cpp
typeof / get_type_from_name / make_generic_* / inflate✅✅
szarray / mdarray factories✅✅
opaque get/set, box/unbox✅✅
GoalRecommended
Feature work, script iterationEditor (Mono)
Shipping & performanceIl2Cpp Player + Generate
Semantic disputesFollow the spec

Next steps​