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

**URL:** https://guild.rpgmakerofficial.com/t/topic/38
**Category:** チュートリアル
**Tags:** manual, english
**Created:** [2025 年 5 月 26 日午前 6:34 UTC](https://guild.rpgmakerofficial.com/t/topic/38 "2025-05-26T06:34:43Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![GGG-Administrator](https://sea2.discourse-cdn.com/flex002/user_avatar/guild.rpgmakerofficial.com/ggg-administrator/32/6_2.png) [@GGG-Administrator](https://guild.rpgmakerofficial.com/u/GGG-Administrator)
#### Post date: [2025 年 5 月 26 日午前 6:34 UTC](https://guild.rpgmakerofficial.com/t/topic/38/1 "2025-05-26T06:34:43Z")

</div>

**注意:** データベース用の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 |
