跳到主要内容
Data 与 Schema

本页尚未翻译,当前显示英文版本。

管理游戏数据

Data 是 schema 中 Record 所在的地方。 每个 Entity 在这里都有一张 Record 表,你可以浏览、筛选、创建、编辑、导入和导出其中的 Record。在侧边栏 Engineering 下的 Data 中打开它;它显示顶栏所选 Environment 的数据。Record 的结构来自你的 schema。


Data 视图

侧边栏列出各个 Entities 及其 Record 数量,以及你保存过的 Views;Search tables… 可以缩小列表范围。选择一个 Entity 即可查看其 Record。

控件作用
Search在所选 Entity 中查找 Record。
Filter按字段值缩小列表范围。
Columns选择显示哪些字段。
Save view把当前的 Entity、筛选条件和列保存为侧边栏中的一个视图,方便反复执行同一查询。
Import · Export从文件加载 Record,或把 Record 保存到文件。见下文。
New record创建一条 Record。

勾选 Record 后,可以一起导出或删除。


创建 Record

点击 New record;如果 Entity 为空,则点击 Create first record。表单与 Entity 的字段一一对应:

字段类别在表单中的形式
Primitive对应类型的输入框,已填入默认值。
Enum referenceEnum 取值的列表。
Relationship要链接的 Record 的 ID。
Inclusion不在表单中:在 Record 创建后,从其面板中填写。

标为必填的字段必须填写。点击 Create 保存 Record。


编辑 Record

点击某条 Record 即可打开其面板。

标签页显示内容
ValuesRecord 的字段,以及它包含的每个 Part 各自对应的一张卡片。卡片上的 Edit 用于编辑该卡片的字段。
Referenced by其他 Entity 中链接到这条 Record 的 Record。
History尚未实现:显示的行只是占位内容。
JSON以 JSON 形式显示的整条 Record。

面板底部的 Delete 会删除这条 Record。列表中 Record 的 ⋯ 菜单还提供 Edit record、Duplicate 和 Delete。

单例 Entity 只有一条 Record,因此打开后显示为单个表单,而不是列表。

Edit all 让所有字段同时可编辑,每个被包含的 Part 各有一张卡片;点击 Save all 或 Cancel all 结束编辑。


导入 Record

选择文件

选择 Entity,点击 Import,选择 CSV 或 JSONL,然后把文件拖进来。CSV 文件需要有表头行。文件会立即被读取,对话框随即进入映射步骤。

映射列

列会按名称与字段匹配。检查匹配结果,修正错误的匹配,并查看前几行的预览。底部会统计有效行数、跳过的行数以及已映射的列数。

导入

点击显示行数的 Import 按钮。完成后,对话框会报告导入了多少行,以及在映射检查中跳过了多少行。行会逐条发送到 PlayServ:如果平台拒绝了其中一行,对话框会停在 Importing…。此时关闭对话框,在列表中检查哪些行已经导入。

有些字段无法导入

导入时不包含 Record ID 和被包含的 Part。导入之后,在每条 Record 的面板中补填这些 Part。


导出 Record

Export 把所选 Entity 的 Record 保存为 JSON 文件;如果勾选了 Record,则只保存勾选的那些。

导出只包含已加载的 Record

文件中是列表已加载的 Record,不一定是整个 Entity 的数据;通知会说明保存了总数中的多少条。如果需要更多 Record,先在列表中翻页加载。


后续步骤

更新于 2026年10月16日