https://github.com/moonsharp-devs/moonsharp

An interpreter for the Lua language, written entirely in C# for the .NET, Mono, Xamarin and Unity3D platforms, including handy remote debugger facilities.
https://github.com/moonsharp-devs/moonsharp

c-sharp debugger interpreter lua mono moonsharp unity3d xamarin

Last synced: about 1 month ago
JSON representation

An interpreter for the Lua language, written entirely in C# for the .NET, Mono, Xamarin and Unity3D platforms, including handy remote debugger facilities.

• Host: GitHub
• URL: https://github.com/moonsharp-devs/moonsharp
• Owner: moonsharp-devs
• License: other
• Created: 2014-05-24T20:34:47.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-11-30T12:32:18.000Z (12 months ago)
• Last Synced: 2024-06-23T04:57:37.995Z (5 months ago)
• Topics: c-sharp, debugger, interpreter, lua, mono, moonsharp, unity3d, xamarin
• Language: C#
• Homepage: http://www.moonsharp.org
• Size: 69.6 MB
• Stars: 1,375
• Watchers: 90
• Forks: 210
• Open Issues: 116
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - xanathar/moonsharp - An interpreter for the Lua language, written entirely in C# for the .NET, Mono, Xamarin and Unity3D platforms, including handy remote debugger facilities. (C sharp / Miscs)

README

        
MoonSharp       [![Build Status](https://travis-ci.org/xanathar/moonsharp.svg?branch=master)](https://travis-ci.org/xanathar/moonsharp) [![Build Status](https://img.shields.io/nuget/v/MoonSharp.svg)](https://www.nuget.org/packages/MoonSharp/)

=========

http://www.moonsharp.org   

A complete Lua solution written entirely in C# for the .NET, Mono, Xamarin and Unity3D platforms.

Features:

* 99% compatible with Lua 5.2 (with the only unsupported feature being weak tables support) 

* Support for metalua style anonymous functions (lambda-style)

* Easy to use API

* **Debugger** support for Visual Studio Code (PCL targets not supported)

* Remote debugger accessible with a web browser and Flash (PCL targets not supported)

* Runs on .NET 3.5, .NET 4.x, .NET Core, Mono, Xamarin and Unity3D

* Runs on Ahead-of-time platforms like iOS

* Runs on IL2CPP converted code

* Runs on platforms requiring a .NET 4.x portable class library (e.g. Windows Phone)

* No external dependencies, implemented in as few targets as possible

* Easy and performant interop with CLR objects, with runtime code generation where supported

* Interop with methods, extension methods, overloads, fields, properties and indexers supported

* Support for the complete Lua standard library with very few exceptions (mostly located on the 'debug' module) and a few extensions (in the string library, mostly)

* Async methods for .NET 4.x targets

* Supports dumping/loading bytecode for obfuscation and quicker parsing at runtime

* An embedded JSON parser (with no dependencies) to convert between JSON and Lua tables

* Easy opt-out of Lua standard library modules to sandbox what scripts can access

* Easy to use error handling (script errors are exceptions)

* Support for coroutines, including invocation of coroutines as C# iterators 

* REPL interpreter, plus facilities to easily implement your own REPL in few lines of code

* Complete XML help, and walkthroughs on http://www.moonsharp.org

For highlights on differences between MoonSharp and standard Lua, see http://www.moonsharp.org/moonluadifferences.html

Please see http://www.moonsharp.org for downloads, infos, tutorials, etc.

**License**

The program and libraries are released under a 3-clause BSD license - see the license section.

Parts of the string library are based on the KopiLua project (https://github.com/NLua/KopiLua).

Debugger icons are from the Eclipse project (https://www.eclipse.org/).

**Usage**

Use of the library is easy as:

```C#

double MoonSharpFactorial()

{

	string script = @"    

		-- defines a factorial function

		function fact (n)

			if (n == 0) then

				return 1

			else

				return n*fact(n - 1)

			end

		end

	return fact(5)";

	DynValue res = Script.RunString(script);

	return res.Number;

}

```

For more in-depth tutorials, samples, etc. please refer to http://www.moonsharp.org/getting_started.html