マニュアル:データベース用CSVデータガイド

注意: データベース用のCSVデータは、プロジェクトディレクトリに配置してください。
Godotのシステムは、プロジェクト内のCSVファイルを自動的に翻訳データとして読み込むため、インポートが正常に行われない可能性があります。

フォーマット

ACTION GAME MAKERでデータベースを最初に作成し、その後エクスポートされたCSVファイルを使用することをお勧めします。

  1. エンコーディング: UTF-8
  2. BOM: BOMなし (UTF-8 without BOM) が最も安全なオプションです
  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データの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