手册:数据库 CSV 数据指南

注意: 始终将数据库的 CSV 数据放在项目目录之外
Godot 的系统会自动将项目内的 CSV 文件作为翻译数据加载,这可能会阻碍正确的导入。

目标数据库

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

用户数据库的 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 仅数值(-21474836482147483647
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