Lua 配置文件

如何在 nanos world Forge 中创建 Lua 配置文件

info

Lua 配置文件目前仍处于实验性，在未来的更新中可能会发生变化。 此外，它们目前可能无法如预期般与占位符同时工作。

Lua 配置文件允许你定义由 nanos world Forge 转换的 Lua 代码的格式。 你可以自定义结构体和对象的导出方式（无论是作为表还是构造函数），并将属性映射到特定的函数。

创建 Lua 配置文件

要创建 Lua 配置文件，你需要从可用的配置文件类型中创建一个数据资产：

配置文件类型

Lua 结构体格式配置文件

Setting	Description
Target Struct	要格式化的 UE 结构体类型（例如 FVector、FRotator）
Format Mode	结构体在 Lua 中的格式化模式（Constructor 或 Table）
Constructor Name	用于创建该结构体所调用的 Lua 函数
Constructor Arguments	使用哪些属性作为构造函数参数
Table Fields	在 Lua 表格式中需要包含哪些属性

结构体配置文件示例（Vector 作为构造函数）

这将向量导出为：

Vector(100.0, 200.0, 50.0)

结构体配置示例（Transform 作为表）

这将变换导出为：

{
    Location = Vector(100.0, 200.0, 50.0),
    Rotation = Rotator(0.0, 90.0, 0.0),
    Scale = Vector(1.0, 1.0, 1.0)
}

Lua 对象格式配置文件

Setting	Description
Target Class	要格式化的虚幻引擎对象类类型
Constructor Name	用于创建该对象所调用的 Lua 函数
Constructor Arguments	使用哪些属性作为构造函数参数
Property to Function Map	将属性映射到特定的 Lua 函数以进行格式化

对象配置文件示例（道具占位符）

这会将道具占位符导出为：

Prop(Vector(340, 720, 0), Rotator(0, 0, 0), "my-asset-pack::Cube")

内置结构体配置文件

nanos world Forge 带有几个内置的结构体配置文件，可将常见的虚幻结构体格式化为 nanos world Lua 类型或易于使用的 Lua 表：

配置文件	Description
LinearColorProfile	将 FLinearColor 格式化为 Color(r, g, b, a)
RotatorProfile	将 FRotator 格式化为 Rotator(pitch, yaw, roll)
Vector2Profile	将 FVector2D 格式化为 Vector2D(x, y)
VectorProfile	将 FVector 格式化为 Vector(x, y, z)
TransformProfile	将 FTransform 格式化为包含 Location、Rotation、Scale 的表

Lua 全局配置文件

在创建完结构体和对象配置文件后，创建一个 Lua 全局配置文件数据资产来将它们组合在一起。

默认情况下，它将包含所有内置配置文件。 你可以将自定义的配置文件添加到 Struct Profiles 和 Object Profiles 数组中。

在工具中使用配置文件

你可以在 Object2Lua 工具和 Placeholder Exporter 等工具中使用你的自定义配置文件。

你只需在格式设置中选择你的 Lua 全局配置文件即可：