Table of contents:
This is a Godot engine module that adds lua support via GDScript. Importantly this is NOT meant to be a replacement for GDScript. The main purpose of this module is to add runtime execution of code for tasks such as modding or in game scripting.
While the original purpose of this module was for my own use I understand more may find it useful. If a feature is missing that you would like to see feel free to create a Feature Request or submit a PR
By default, threaded is disabled, however please keep in mind if you plan on using threading the Lua object should be a global to prevent it from being destroyed before a thread finishes executing.
To use you can either Compile from source or if you are on windows or linux you can download one of the pre built binarays from the releas page.
Default lua libs loaded
- base
- math
- string
- table
- Run lua directly from a string or a text file.
- Push any Variant as a global.
- Expose GDScript functions to lua with a return value and up to 5 arguments.
- Call lua functions from GDScript.
- By default the lua print function is set to print to the GDEditor console. This can be changed by exposing your own print function as it will overwrite the existing one.
- Basic types are passed as userdata (currently: Vector2, Vector3 and Color) with a useful metatable. This means you can do things like:
local v1 = Vector2(1,2)
local v2 = Vector2(100,100)
print( v2.x ) -- "100"
print( v1+v2 ) -- "(101,102)"
change_my_sprite_color( Color(1,0,0,1) ) -- if "change_my_sprite_color" was exposed, in GDScript it will receive a Color variant.- Add support to kill individual lua threads.
- Add option to load specific lua librarys.
- Methods for userdata types, i.e.
.length()for Vector2 - Object type passed as userdata? This probably should be optional. User should be careful with reference being freed
Godot version 3.4.4-stable is confirmed to be working.
-
Start by cloning the Godot 3.4.4-stable source with this command
git clone https://github.com/godotengine/godot -b 3.4.4-stable -
Next change directories into the modules folder and clone this repo with this command
git clone https://github.com/Trey2k/lua -b v1.1-stable -
Now you can follow the Godot build instructions on their site.
Running lua from a string:
extends Node2D
onready var lua = Lua.new()
func _ready():
lua.do_string("for i=1,10,1 do print('Hello lua!') end")Running lua from a file:
extends Node2D
onready var lua = Lua.new()
func _ready():
lua.do_file("user://luaFile.lua")Pushing a Variant as a global:
extends Node2D
onready var lua = Lua.new()
var test = "Hello lua!"
func _ready():
lua.push_variant(test, "str")
lua.do_string("print(str)")Exposing a GDScript function to lua:
extends Node2D
onready var lua = Lua.new()
func luaAdd(a, b):
return a + b
func _ready():
lua.expose_function(self, "luaAdd", "add")
lua.do_string("print(add(2, 4))")Calling a lua function from GDScript:
extends Node2D
onready var lua = Lua.new()
func _ready():
lua.do_file("user://luaFile.lua")
if( lua.lua_function_exists("set_colours") ):
# call_function will return a Variant if lua returns nothing the value will be null
var value = lua.call_function( "set_colours", ["red", "blue"])
if value != null:
print(value)
else:
print("no value returned") Capturing lua errors:
extends Node2D
onready var lua = Lua.new()
func luaCallBack(err):
print(err)
func _ready():
lua.do_string("print(This wont work)", true , self, "luaCallBack")Enable threading:
extends Node2D
onready var lua = Lua.new()
func _ready():
lua.set_threaded(true)
lua.do_string("while true do print("The game will not freeze") end" )Kill all lua threads:
extends Node2D
onready var lua = Lua.new()
func _ready():
lua.do_string("while true do pass end")
lua.kill_all()All contributions are welcome, if you would like to contribute submit a PR.
Additionally if you do not have the time and or the knowledge you can create a Feature Request