Lua Scripting

<profiles>/chimera/lua/
├── scripts/
│   ├── global/        # Loaded on startup, always active
│   └── map/           # Loaded per-map, unloaded on map change
├── data/
│   ├── global/        # Persistent data for global scripts
│   └── map/           # Persistent data for map scripts
└── modules/           # Shared Lua modules

// From scripting.cpp
static void setup_lua_folder() {
    auto lua_directory = get_chimera().get_path() / "lua";
    
    // Create directories
    fs::create_directories(lua_directory / "scripts" / "global");
    fs::create_directories(lua_directory / "scripts" / "map");
    fs::create_directories(lua_directory / "data" / "global");
    fs::create_directories(lua_directory / "data" / "map");
    fs::create_directories(lua_directory / "modules");
}

-- scripts/global/hello.lua

function on_load()
    console_out("Hello from Chimera Lua!")
end

function on_unload()
    console_out("Goodbye!")
end

-- Called when script loads
function on_load()
    console_out("Script loaded")
end

-- Called when script unloads
function on_unload()
    console_out("Script unloaded")
end

-- Called every tick (30 times per second)
function on_tick()
    -- Game logic here
end

-- Called every frame
function on_frame()
    -- Rendering logic here
end

-- Called before camera update
function on_camera()
    -- Camera manipulation here
end

-- Called on map load
function on_map_load()
    local map_name = get_map_name()
    console_out("Loaded map: " .. map_name)
end

-- Called when player spawns
function on_spawn(player_index)
    console_out("Player spawned: " .. player_index)
end

-- Called when player dies  
function on_death(victim, killer)
    console_out("Player died")
end

-- Called on chat message
function on_chat(player, message, channel)
    console_out(player .. ": " .. message)
    -- Return true to block the message
    return false
end

-- Called when object is created
function on_object_create(object_id)
    -- Handle object creation
end

-- Get current map name
local map = get_map_name()

-- Get game type
local gametype = get_gametype()

-- Check if in multiplayer
local is_mp = is_multiplayer()

-- Get tick count
local ticks = get_tick_count()

-- Get player count
local count = get_player_count()

-- Iterate players
for i = 0, 15 do
    local player = get_player(i)
    if player then
        local name = player.name
        local team = player.team
        local score = player.score
    end
end

-- Get local player
local local_player = get_local_player()

-- Get object by ID
local object = get_object(object_id)

if object then
    -- Read object data
    local x, y, z = object.x, object.y, object.z
    local health = object.health
    
    -- Modify object
    object.x = x + 1.0
    object.health = 1.0
end

-- Create object
local tag_id = get_tag_id("weapons\\pistol\\pistol", "weap")
if tag_id then
    local obj_id = create_object(tag_id, x, y, z)
end

-- Delete object
delete_object(object_id)

-- Print to console
console_out("Message")

-- Print colored text
console_out("|cFFFF00Yellow text|r")

-- Format output
console_out(string.format("Value: %d", value))

-- Read file
local content = read_file("data/global/config.txt")

-- Write file
write_file("data/global/config.txt", "data")

-- Check if file exists
if file_exists("data/global/config.txt") then
    -- File exists
end

-- Delete file
delete_file("data/global/config.txt")

-- Register custom command
register_command("my_command", "Does something cool", function(args)
    console_out("Command called with: " .. table.concat(args, " "))
end)

-- Usage in console:
-- my_command arg1 arg2 arg3

-- scripts/global/kill_counter.lua

local kills = 0

function on_load()
    console_out("Kill counter loaded")
    
    -- Load saved kills
    local saved = read_file("data/global/kills.txt")
    if saved then
        kills = tonumber(saved) or 0
    end
end

function on_death(victim, killer)
    local local_player = get_local_player()
    
    if killer == local_player then
        kills = kills + 1
        console_out("Total kills: " .. kills)
        
        -- Save kills
        write_file("data/global/kills.txt", tostring(kills))
    end
end

function on_unload()
    console_out("Final kill count: " .. kills)
end

-- scripts/map/welcome.lua

function on_map_load()
    local map = get_map_name()
    local messages = {
        bloodgulch = "Welcome to Blood Gulch!",
        sidewinder = "Welcome to Sidewinder!",
        dangercanyon = "Welcome to Danger Canyon!"
    }
    
    local msg = messages[map] or "Welcome to " .. map
    console_out(msg)
end

-- scripts/global/auto_reload.lua

function on_tick()
    local local_player = get_local_player()
    if not local_player then return end
    
    -- Get player's weapon
    local weapon = get_weapon(local_player)
    if not weapon then return end
    
    -- Auto reload when ammo is low
    if weapon.ammo < weapon.max_ammo * 0.2 then
        execute_command("reload")
    end
end

chimera_lua_reload  # Reload all Lua scripts

chimera_lua_list  # Show all active scripts

// From scripting.cpp
void destroy_lua_scripting() {
    unload_scripts();
}

-- BAD: Expensive operation every tick
function on_tick()
    for i = 1, 1000 do
        -- Heavy computation
    end
end

-- GOOD: Only when needed
local counter = 0
function on_tick()
    counter = counter + 1
    if counter >= 30 then  -- Once per second
        counter = 0
        -- Heavy computation
    end
end

src/chimera/lua/
├── scripting.cpp        # Core scripting system
├── lua_script.cpp       # Script loading/unloading
├── lua_callback.cpp     # Event callbacks
├── lua_game.cpp         # Game state API
├── lua_filesystem.cpp   # File I/O API
├── lua_io.cpp           # Console I/O
└── lua_variables.cpp    # Variable access

void setup_lua_scripting() {
    static bool already_setup = false;
    if(already_setup) {
        return;
    }
    
    setup_lua_folder();
    setup_callbacks();
    load_global_scripts();
    load_map_script();
    
    already_setup = true;
}