手册:数据库的CSV导入/导出

数据库导入用 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 数据第 1 行

CSV 数据的第 1 行为表头数据。
各表头请遵循以下格式:

  • 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 请指定任意列名(仅限半角英数字)

CSV 数据第 2 行及以后

CSV 数据从第 2 行开始为实际数据行。
请指定与表头相符的数据。

表头 数据格式
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