GD Lua

GD Lua is a Geometry Dash mod that adds Lua scripting, allowing you to manipulate gameplay, objects, and more through scripts.

This project is currently in early development.

Documentation

Examples

Speedhacking:

-- gd-lua/scripts/CCScheduler/script.lua

---@param self CCScheduler
---@param delta_time number
function update(self, delta_time)
    return {param_1 = delta_time / 2} -- slows the game down to half speed
end

Tampering with values:

-- gd-lua/scripts/PlayerObject/script.lua

local new_pos = CCPoint.new()

---@param self PlayerObject
---@param delta_time number
function update(self, delta_time)
    new_pos.x = self.pos.x
    new_pos.y = 400
    self.pos = new_pos -- sets the player up high in the air
end

More examples

Features and Specifications

This mod uses Lua v5.4.8 and sol2 v3.3.0, both included in the project.

Available Lua Libraries

GD Lua runs in a sandboxed Lua 5.4.8 environment with the following standard libraries available:

• base - basic Lua functions (print, assert, etc.)

• math - math functions (sin, cos, floor, etc.)

• string - string manipulation functions

• table - table operations

• io – limited I/O operations

• package – limited module loading

NOTE: io and package are restricted for security reasons. File and module operations are sandboxed to prevent scripts from accessing arbitrary system files.

Build instructions

# If you have Geode SDK set up
geode build

To set up Geode SDK, read this guide.