UnLua

自动关联目录:UnLua

UnLua 是腾讯开源的 UE Lua 脚本插件,定位是"零胶水代码"地把 Lua 绑到 UE 上:不需要为每个 API 手写绑定,靠反射就能在 Lua 里访问 UObject、调用 UFUNCTION、响应蓝图事件。

它的价值在于把可热更的逻辑从 C++ 里剥离:底层引擎与性能敏感的模块用 C++,玩法逻辑用 Lua。

本目录

笔记内容
UnLua 指南使用方式:绑定、调用、覆写
UnLua 源码解析实现机制:反射绑定、UE↔Lua 交互

为什么选 Lua(而不是蓝图或其它脚本)

维度Lua蓝图
热更新天然支持不可
文本化是(可 diff、可评审)二进制
性能好于蓝图(尤其逻辑复杂时)节点多时开销大
上手需要写码策划友好

常见分工:蓝图做原型与表现,Lua 做需要热更与复杂逻辑的部分。

基本用法

local BP_Player_C = Class()          -- 或用 UnLua.Class()

function BP_Player_C:ReceiveBeginPlay()
    self.Health = 100
end

function BP_Player_C:OnTakeDamage(Damage)
    self.Health = self.Health - Damage
end
能力说明
绑定蓝图/类Lua 文件与蓝图同名即自动绑定
覆写蓝图事件实现同名函数即可
调 UFUNCTION直接 self:FuncName()
访问 UPROPERTY直接 self.PropertyName
调用静态/全局 APIUE.UKismetSystemLibrary.PrintString(...)
构造/析构Initialize / Destruct

适用场景与边界

适合 Lua不适合 Lua
玩法逻辑、UI 逻辑、配置驱动的行为每帧大量计算(粒子、寻路)
需要热更的部分引擎层扩展
需要频繁调整的数值与流程与 C++ 高频交互的循环

性能第一原则:Lua 与 C++ 的调用边界有成本。热路径上要把数据批量传入,而不是在循环里逐次调用。

与引擎机制的配合

机制说明
GCLua 侧对象与 UObject 生命周期要对齐,避免持有已销毁对象
网络RPC 仍走 C++/蓝图,Lua 通常做上层逻辑
热更重载 Lua 模块即可,注意状态迁移
调试需要额外的 Lua 调试器(如 EmmyLua + 调试插件)

常见坑

坑说明
Lua 里持有已销毁的 UObject崩溃;需用 IsValid 判断
在每帧回调里做重逻辑Tick 成本高
Lua 与 C++ 循环互调边界开销累积
热更后旧状态没迁移数据结构变了但存档没变
把性能敏感逻辑全搬到 Lua应留在 C++