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
| Version | Mono (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.
| Version | Status |
|---|---|
| Unity 6.0 LTS 6000.0.x | Supported |
| Unity 6.3 LTS 6000.3.x | Supported |
| Unity 2022.3 LTS | Supported |
| Tuanjie LTS based on 2022.3.x | Supported |
libil2cpp patch resolution prefers patches/libil2cpp/6000.{minor}/, then falls back to 6000/. See Multi-version.
Scripting Backend
| Backend | Environment | Feature status |
|---|---|---|
| Il2Cpp | Player shipping | Done (authoritative implementation) |
| Mono | Unity Editor | Done (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)
| Engine | Il2Cpp 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.) |
| LuaJIT | Android and iOS only; Win / macOS / Linux / WebGL etc. unsupported. Build static .a into Plugins yourself — see LuaJIT build |
| Luau | On 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#
| Feature | Mono | Il2Cpp | Notes |
|---|---|---|---|
| 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
| Feature | Mono | Il2Cpp |
|---|---|---|
GetFunction<T> | ✅ | ✅ |
| Multi-arg / multi-return | ✅ | ✅ |
[LuaMarshalAs] | ✅ | ✅ |
Marshal
| Type | Mono | Il2Cpp |
|---|---|---|
| Primitives / string | ✅ | ✅ |
| enum (default integer) | ✅ | ✅ |
| class / struct (ByVal / ByObj / Opaque) | ✅ | ✅ |
| array | ✅ | ✅ |
| OpaqueValue / byref | ✅ | ✅ |
Standard library zlua
| API | Mono | Il2Cpp |
|---|---|---|
typeof / get_type_from_name / make_generic_* / inflate | ✅ | ✅ |
| szarray / mdarray factories | ✅ | ✅ |
opaque get/set, box/unbox | ✅ | ✅ |
Recommended environments
| Goal | Recommended |
|---|---|
| Feature work, script iteration | Editor (Mono) |
| Shipping & performance | Il2Cpp Player + Generate |
| Semantic disputes | Follow the spec |