手册：数据库CSV数据指南

[GGG-Administrator]

注意： 数据库的 CSV 数据请始终放置在项目目录 之外。
Godot 系统会自动将项目内的 CSV 文件加载为翻译数据，这可能导致无法正常导入。

格式

建议先在 ACTION GAME MAKER 中创建数据库，然后使用导出的 CSV 文件。

1. 编码：UTF-8
2. BOM：无 BOM（不带 BOM 的 UTF-8） 是最安全的选项
3. 分隔符：逗号 ,
4. 换行符：支持 Windows 风格的 CRLF

目标数据库

• 用户数据库
• 类型预设数据库

用户数据库的 CSV 数据格式

表头	record_name	numeric//column_name	string//column_name	image//column_name	typepreset/attribute_type/column_name	vector2//column_name
数据	record1	123	hogehoge	res://xxxxx.png/	Fire Attribute	100_200

CSV 数据的第一行

CSV 文件的第一行必须包含表头信息。
每个表头应遵循以下格式：

• record_name
  • 这是用作记录名称表头的固定名称。
• numeric//column_name
  • 表示 数值 数据列。
  • column_name 应为仅使用字母数字字符的自定义列名。
• string//column_name
  • 表示 字符串 数据列。
  • column_name 应为仅使用字母数字字符的自定义列名。
• image//column_name
  • 表示 图像路径 数据列。
  • column_name 应为仅使用字母数字字符的自定义列名。
• typepreset/attribute_type/column_name
  • 表示对 类型预设 的引用。
  • attribute_type 可以是两个 固定名称 之一，也可以是 自定义用户定义名称：
    • 对于属性类型预设：attribute_type
    • 对于装备类型预设：equipment_type
    • 对于用户定义的类型：指定仅使用字母数字字符的名称
  • column_name 应为仅使用字母数字字符的自定义列名。
• vector2//column_name
  • 表示 Vector2 类型 数据列。
  • column_name 应为仅使用字母数字字符的自定义列名。

从第二行开始

从第二行开始，每一行代表实际数据。
请确保值与表头定义对齐。

表头	数据格式
record_name	仅使用字母数字字符的任何记录名称
numeric	仅限数值（-2147483648 至 2147483647）
string	任意字符串
image	以 res:// 开头的字符串
typepreset	在类型预设数据库中注册的字符串 ※1
vector2	用 _ 连接的数字（例如，对于 x=128, y=256，使用 128_256）

※1

如果该值在类型预设数据库中不存在，
将在相关的类型预设数据库中添加 新条目。

---

类型预设数据库的 CSV 数据格式

对于属性类型预设

表头	attribute
数据	从 1 开始的连续编号	type_name

对于装备类型预设

表头	equipment
数据	从 1 开始的连续编号	type_name

对于自定义类型预设

表头	任意自定义表头名称（仅限字母数字）
数据	从 1 开始的连续编号	type_name