Question 1

How does Lua-CSharp compare to MoonSharp or NLua for Unity projects?

Accepted Answer

Lua-CSharp offers better performance with lower allocations in C#/Lua interaction and works reliably with IL2CPP, but has key differences like UTF-16 string encoding and .NET GC. MoonSharp is more allocation-heavy, and NLua uses C bindings with interoperability overhead.

Question 2

How to bind C# classes to Lua in Lua-CSharp?

Accepted Answer

Use the [LuaObject] attribute on a partial class with [LuaMember] on properties and methods. The source generator automatically creates bindings, allowing seamless use of C# objects in Lua scripts, as demonstrated in the LuaObject section with Vector3 examples.

Question 3

Does Lua-CSharp support Lua 5.3 or 5.4?

Accepted Answer

No, Lua-CSharp is based on Lua 5.2, so features from newer Lua versions like integers or bitwise operators are not available. It's focused on a full 5.2 implementation in C#, with no plans mentioned for later versions.

Question 4

Can I use Lua-CSharp in a multithreaded application?

Accepted Answer

No, LuaState is not thread-safe, so you cannot access it from multiple threads simultaneously. For concurrent usage, you need to manage synchronization with locks or use separate LuaState instances per thread.

Question 5

How does async/await work with Lua coroutines?

Accepted Answer

Lua coroutines are represented by LuaState, and you can await them from C# using ResumeAsync. Async Lua functions can yield and resume, making it ideal for game scripts with timed events, as shown in the coroutine examples with await support.

Question 6

Is Lua-CSharp compatible with Unity's Addressables system?

Accepted Answer

Yes, through the AddressablesModuleLoader provided in Lua.Unity, which allows loading Lua modules from Addressables. This integrates well with Unity's asset management, but requires the Addressables package to be installed.

Question 7

What are the performance benchmarks for Lua-CSharp?

Accepted Answer

Benchmarks in the README show Lua-CSharp has lower allocations and faster interoperation than MoonSharp and NLua, especially in scenarios with frequent C#/Lua calls. However, performance can vary based on script complexity and the specific use case.

Lua-C#

What is Lua-C#?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions