マニュアル:データベース用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 は以下の 2 つの固定名のいずれか、またはカスタムユーザー定義名であることができます:
      • 属性タイププリセットの場合:attribute_type
      • 装備タイププリセットの場合:equipment_type
      • ユーザー定義タイプの場合:英数字のみを使用した名前を指定
    • column_name は英数字のみを使用したカスタム列名である必要があります。
  • vector2//column_name
    • Vector2 型データ列を示します。
    • column_name は英数字のみを使用したカスタム列名である必要があります。

2 行目以降

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