GS2-Formation マスターデータリファレンス
マスターデータのフォーマットと インポートする各種モデルのリファレンス
マスターデータのフォーマット
{
"version": "2019-09-09",
"moldModels": [
{
"name": "[string]フォームの保存領域モデルの名前",
"metadata": "[string?]メタデータ",
"initialMaxCapacity": "[int]フォームを保存できる初期キャパシティ",
"maxCapacity": "[int]フォームを保存できる最大キャパシティ",
"formModel": {
"formModelId": "[string]フォームモデルGRN",
"name": "[string]フォームモデル名",
"metadata": "[string?]メタデータ",
"slots": [
{
"name": "[string]スロットモデル名",
"propertyRegex": "[string]プロパティとして設定可能な値の正規表現",
"metadata": "[string?]メタデータ"
}
]
}
}
],
"propertyFormModels": [
{
"name": "[string]プロパティフォームモデル名",
"metadata": "[string?]メタデータ",
"slots": [
{
"name": "[string]スロットモデル名",
"propertyRegex": "[string]プロパティとして設定可能な値の正規表現",
"metadata": "[string?]メタデータ"
}
]
}
]
}| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| version | string | ✓ | 2019-09-09 | マスターデータのフォーマットバージョン | ||
| moldModels | List<MoldModel> | ~ 100 items | フォームの保存領域モデル フォームの保存領域モデルは、パーティ編成であれば「火属性パーティ」「水属性パーティ」のような形で保存することを想定しています。 保存できる領域の数は制限することができ、個別に拡張することもできます。 | |||
| propertyFormModels | List<PropertyFormModel> | ~ 100 items | プロパティフォームモデル プロパティフォームモデルは編成状況を表すエンティティです。 Mold / Form との違いは、スロット数を定義して、各スロットに編成を記録するのが Mold / Form で、 所有している装備に対してスキルを設定するような、数を事前に決めるのが難しい編成を表現するのに利用するのがプロパティフォームモデルです。 |
モデル
FormModel
フォームモデル
フォームモデルは編成状況を表すエンティティです。
編成できる領域として スロット を定義できます。
武器・防具 であれば 「右手」「左手」「胴」「腕」のような部位をスロットとし、
パーティであれば「前衛」「中衛」「後衛」のようなポジションをスロットとして表現できます。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| formModelId | string | ✓* | ~ 1024文字 | フォームモデル
GRN ※ サーバー側で自動的に設定 | ||
| name | string | ✓ | ~ 128文字 | フォームモデル名 フォームモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| metadata | string | ~ 2048文字 | メタデータ メタデータには任意の値を設定できます。 これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 | |||
| slots | List<SlotModel> | ✓ | 1 ~ 10 items | スロットモデルリスト |
SlotModel
スロットモデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 128文字 | スロットモデル名 | ||
| propertyRegex | string | ✓ | “.*” | ~ 512文字 | プロパティとして設定可能な値の正規表現 | |
| metadata | string | ~ 512文字 | メタデータ メタデータには任意の値を設定できます。 これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
MoldModel
フォームの保存領域モデル
フォームの保存領域モデルは、パーティ編成であれば「火属性パーティ」「水属性パーティ」のような形で保存することを想定しています。
保存できる領域の数は制限することができ、個別に拡張することもできます。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| moldModelId | string | ✓* | ~ 1024文字 | フォームの保存領域
GRN ※ サーバー側で自動的に設定 | ||
| name | string | ✓ | ~ 128文字 | フォームの保存領域モデルの名前 フォームの保存領域モデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| metadata | string | ~ 2048文字 | メタデータ メタデータには任意の値を設定できます。 これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 | |||
| initialMaxCapacity | int | ✓ | 1 ~ 2147483646 | フォームを保存できる初期キャパシティ | ||
| maxCapacity | int | ✓ | 1 ~ 2147483646 | フォームを保存できる最大キャパシティ | ||
| formModel | FormModel | ✓ | フォームモデル |
PropertyFormModel
プロパティフォームモデル
プロパティフォームモデルは編成状況を表すエンティティです。
Mold / Form との違いは、スロット数を定義して、各スロットに編成を記録するのが Mold / Form で、
所有している装備に対してスキルを設定するような、数を事前に決めるのが難しい編成を表現するのに利用するのがプロパティフォームモデルです。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| propertyFormModelId | string | ✓* | ~ 1024文字 | プロパティフォームモデル
GRN ※ サーバー側で自動的に設定 | ||
| name | string | ✓ | ~ 128文字 | プロパティフォームモデル名 プロパティフォームモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| metadata | string | ~ 2048文字 | メタデータ メタデータには任意の値を設定できます。 これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 | |||
| slots | List<SlotModel> | ✓ | 1 ~ 10 items | スロットモデルリスト |