脚本引擎

C++ 与脚本语言的桥梁——Lua C API, 反射/序列化, 热重载, embedding vs extending。

概念

脚本引擎是游戏开发中”核心 (C++) 与逻辑 (脚本)“的粘合剂。为什么需要脚本？1) 游戏逻辑迭代速度远快于引擎编译速度；2) 设计师和策划不写 C++；3) 热重载——修改脚本无需重启游戏。最常见的游戏脚本语言是 Lua (轻量, 嵌入式), 也有 C#, Python 等。

核心概念

概念	含义	关键技术
Embedding	将脚本语言嵌入 C++ 宿主程序	Lua C API, sol2
Extending	用 C/C++ 扩展脚本语言的功能	注册 C 函数到 Lua
绑定层	自动生成 C++ ↔ 脚本的互操作代码	SWIG, tolua++, sol2, pybind11
反射	运行时获取/修改程序结构的能力	类型擦除, 属性注册
序列化	C++ 对象 ↔ 脚本序列化格式	存档/读档
热重载	运行时重新加载脚本	文件监控, 状态迁移

Lua C API 基础

// Lua 虚拟栈: C ↔ Lua 数据交换的唯一通道
// 压入参数 → 调用 Lua 函数 → 获取返回值
 
lua_State *L = luaL_newstate();       // 创建 Lua 虚拟机
luaL_openlibs(L);                      // 加载标准库
 
// 在 Lua 中执行代码
luaL_dostring(L, "function add(x, y) return x + y end");
 
// 调用 Lua 函数
lua_getglobal(L, "add");              // 获取全局函数 "add"
lua_pushnumber(L, 3);                 // 压入参数 x
lua_pushnumber(L, 4);                 // 压入参数 y
lua_pcall(L, 2, 1, 0);               // 调用: 2 个参数, 1 个返回值
double result = lua_tonumber(L, -1);  // 获取返回值
lua_pop(L, 1);                        // 清理栈
 
lua_close(L);

C++ 绑定层

// 使用 sol2 (现代 C++ Lua 绑定库)
#include <sol/sol.hpp>
 
struct Player {
    std::string name;
    int health;
    float x, y;
 
    void take_damage(int amount) {
        health -= amount;
    }
};
 
sol::state lua;
lua.open_libraries();
 
// 将 C++ 类暴露给 Lua
lua.new_usertype<Player>("Player",
    sol::constructors<Player()>(),
    "name",     &Player::name,
    "health",   &Player::health,
    "x",        &Player::x,
    "y",        &Player::y,
    "damage",   &Player::take_damage
);
 
// 在 Lua 中:
//    player = Player:new()
//    player.health = 100
//    player:damage(20)
//    print(player.health)  → 80

反射与序列化

// 简化版属性反射系统
struct Property {
    std::string name;
    std::function<void*(void*)> getter;
    std::function<void(void*, void*)> setter;
};
 
template<typename T>
void register_class(Registry &reg) {
    T dummy;
    for (auto &prop : T::properties()) {
        reg.add(prop.name, prop.getter, prop.setter);
    }
}
 
// 使用
struct Enemy {
    float speed;
    int hp;
 
    static std::vector<Property> properties() {
        return {
            {"speed",  [](void *obj) -> void* { return &static_cast<Enemy*>(obj)->speed; }},
            {"hp",     [](void *obj) -> void* { return &static_cast<Enemy*>(obj)->hp; }}
        };
    }
};

热重载

热重载流程:
    1. 文件监控线程: inotify / FileSystemWatcher 检测脚本文件变化
    2. 检测到变化 → 向主线程 post 事件 "script_changed: path/to/script.lua"
    3. 主线程在安全时机 (帧末尾):
       a. 暂停执行该脚本关联的 System
       b. 保存脚本管理对象的状态 (序列化关键数据)
       c. 卸载旧脚本模块 (lua package.loaded[mod] = nil)
       d. 重新加载脚本文件
       e. 用保存的数据恢复状态 (反序列化)
       f. 恢复 System 执行
    4. 若加载失败 → 保留旧版本, 打印错误, 不崩溃

---