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 |
| 调用静态/全局 API | UE.UKismetSystemLibrary.PrintString(...) |
| 构造/析构 | Initialize / Destruct |
适用场景与边界
| 适合 Lua | 不适合 Lua |
|---|---|
| 玩法逻辑、UI 逻辑、配置驱动的行为 | 每帧大量计算(粒子、寻路) |
| 需要热更的部分 | 引擎层扩展 |
| 需要频繁调整的数值与流程 | 与 C++ 高频交互的循环 |
性能第一原则:Lua 与 C++ 的调用边界有成本。热路径上要把数据批量传入,而不是在循环里逐次调用。
与引擎机制的配合
| 机制 | 说明 |
|---|---|
| GC | Lua 侧对象与 UObject 生命周期要对齐,避免持有已销毁对象 |
| 网络 | RPC 仍走 C++/蓝图,Lua 通常做上层逻辑 |
| 热更 | 重载 Lua 模块即可,注意状态迁移 |
| 调试 | 需要额外的 Lua 调试器(如 EmmyLua + 调试插件) |
常见坑
| 坑 | 说明 |
|---|---|
| Lua 里持有已销毁的 UObject | 崩溃;需用 IsValid 判断 |
| 在每帧回调里做重逻辑 | Tick 成本高 |
| Lua 与 C++ 循环互调 | 边界开销累积 |
| 热更后旧状态没迁移 | 数据结构变了但存档没变 |
| 把性能敏感逻辑全搬到 Lua | 应留在 C++ |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/fc559f4f.html
更新于:2026年11月16日