Lua scripting

Lua script plugin provides an option to script using Lua. It provides a new type of component, which points to a lua script file. This file is executed when a game starts.

Update function

A global function function update(dt) is called each frame.

API

Engine

Global variables

• UniverseContext g_universe_context
• Universe g_universe
• Engine g_engine

Functions

• Scene API_getScene(UniverseContext ctx, string name)
• void API_setEntityPosition(Universe univ, Entity entity, number x, number y, number z)
• void API_setEntityRotation(Universe univ, Entity entity, number x, number y, number z, number angle)
• void API_setEntityLocalRotation(UniverseContext univ, Entity entity, number x, number y, number z, number angle)
• void API_setRenderablePath(Scene scene, Component cmp, string path)
• number API_getInputActionValue(Engine engine, number action)
• void API_addInputAction(Engine engine, number action, number type, number key)
• Component API_createComponent(Scene scene, string type, Entity entity)
• void API_logError(string text)
• void API_logInfo(string text)
• {x, y, z} API_multVecQuat(number x, number y, number z, number axis_x, number axis_y, number axis_z, number angle)

Physics

• void API_moveController(Scene scene, Component cmp, number x, number y, number z, number time_delta)

Studio scripts

The editor loads all scripts located in plugins/*.lua and executes them during startup.