> For the complete documentation index, see [llms.txt](/llms.txt)
# GS2-Enchant マスターデータリファレンス
マスターデータのフォーマットと インポートする各種モデルのリファレンス
## マスターデータのフォーマット
**JSON**
```json
{
"version": "2023-07-18",
"balanceParameterModels": [
{
"name": "[string]バランスパラメータモデル名",
"metadata": "[string?]メタデータ",
"totalValue": "[long]合計値",
"initialValueStrategy": "[string (enum)]初期値の設定方針",
"parameters": [
{
"name": "[string]名前",
"metadata": "[string?]メタデータ"
}
]
}
],
"rarityParameterModels": [
{
"name": "[string]レアリティパラメータモデル名",
"metadata": "[string?]メタデータ",
"maximumParameterCount": "[int]付与するパラメータの最大数",
"parameterCounts": [
{
"count": "[int]付与数",
"weight": "[int]排出重み"
}
],
"parameters": [
{
"name": "[string]名前",
"metadata": "[string?]メタデータ",
"resourceName": "[string]ゲーム内で使用するパラメータリソースの種類を表す名前（GS2の動作のためには使用しません）",
"resourceValue": "[long]ゲーム内で使用するパラメータリソースの値（GS2の動作のためには使用しません）",
"weight": "[int]排出重み"
}
]
}
]
}
```
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| version | string | | ✓ | 2023-07-18 | | マスターデータのフォーマットバージョン |
| balanceParameterModels | [List<BalanceParameterModel>](#balanceparametermodel) | | | | ~ 10000 items | バランスパラメータモデル
バランスパラメータの抽選条件を定義します。
バランスパラメータは固定の合計値を複数のパラメータスロットに分配します。例えば、合計パワーが100の武器に対して ATK=60、DEF=30、SPD=10 のように配分されます。初期値の設定方針により値の割り当て方法が決まります：`average` は均等に分配し、`lottery` は合計値をランダムに配分します。 |
| rarityParameterModels | [List<RarityParameterModel>](#rarityparametermodel) | | | | ~ 10000 items | レアリティパラメータモデル
レアリティパラメータの抽選条件を定義します。レアリティパラメータは重み付き抽選システムを使用して、付与されるパラメータの数と割り当てられる具体的な値の両方を決定します。まず、付与数モデルのリストから重み付き抽選により埋めるパラメータスロット数が決定されます。次に、各スロットの値がパラメータ値モデルのリストから重み付き抽選で選択され、制御された確率分布によるランダムな装備属性を提供します。 |
## モデル
### BalanceParameterModel
バランスパラメータモデル
バランスパラメータの抽選条件を定義します。
バランスパラメータは固定の合計値を複数のパラメータスロットに分配します。例えば、合計パワーが100の武器に対して ATK=60、DEF=30、SPD=10 のように配分されます。初期値の設定方針により値の割り当て方法が決まります：`average` は均等に分配し、`lottery` は合計値をランダムに配分します。
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| balanceParameterModelId | string | | ※ | | ~ 1024文字 | バランスパラメータモデルGRN
※ サーバーが自動で設定 |
| name | string | | ✓ | | ~ 128文字 | バランスパラメータモデル名
バランスパラメータモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| metadata | string | | | | ~ 2048文字 | メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
| totalValue | long | | ✓ | | 0 ~ 9223372036854775805 | 合計値
すべてのパラメータスロットに分配される固定の合計値です。パラメータが抽選される際、使用される配分方針に関わらず、個々の値の合計は常にこの合計値になります。 |
| initialValueStrategy | 文字列列挙型
enum {
"average",
"lottery"
}
| | | "average" | | 初期値の設定方針
初回割り当て時に合計値をパラメータスロットにどのように分配するかを決定します。`average` は合計値をすべてのパラメータに均等に分配し、`lottery` は合計値をランダムに分配してバラエティに富んだパラメータの組み合わせを作成します。"average": 平均値 / "lottery": 抽選 / |
| parameters | [List<BalanceParameterValueModel>](#balanceparametervaluemodel) | | ✓ | | 1 ~ 10 items | バランスパラメータ値モデルのリスト
このバランスパラメータで利用可能なパラメータスロットを定義します。各エントリは名前付きパラメータスロット（例: ATK、DEF、SPD）をオプションのメタデータとともに指定します。合計値はこれらのスロットに分配されます。 |
---
### BalanceParameterValueModel
バランスパラメータ値モデル
バランスパラメータ内で利用可能な単一のパラメータスロットを定義します。各エントリは、抽選処理中に合計値の一部を受け取る名前付きスロット（例: ATK、DEF、SPD）を指定します。
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| name | string | | ✓ | | ~ 64文字 | 名前
このパラメータスロットの識別子（例: ATK、DEF、SPD）です。バランスパラメータモデル内で一意である必要があります。抽選されたパラメータ値の保存・取得時にキーとして使用されます。 |
| metadata | string | | | | ~ 512文字 | メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
---
### RarityParameterModel
レアリティパラメータモデル
レアリティパラメータの抽選条件を定義します。レアリティパラメータは重み付き抽選システムを使用して、付与されるパラメータの数と割り当てられる具体的な値の両方を決定します。まず、付与数モデルのリストから重み付き抽選により埋めるパラメータスロット数が決定されます。次に、各スロットの値がパラメータ値モデルのリストから重み付き抽選で選択され、制御された確率分布によるランダムな装備属性を提供します。
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| rarityParameterModelId | string | | ※ | | ~ 1024文字 | レアリティパラメータモデルGRN
※ サーバーが自動で設定 |
| name | string | | ✓ | | ~ 128文字 | レアリティパラメータモデル名
レアリティパラメータモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| metadata | string | | | | ~ 2048文字 | メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
| maximumParameterCount | int | | ✓ | | 1 ~ 10 | 付与するパラメータの最大数
リソースに付与できるパラメータスロット数の上限です。実際に付与される数は付与数モデルのリストからの重み付き抽選で決定されますが、この値を超えることはありません。 |
| parameterCounts | [List<RarityParameterCountModel>](#rarityparametercountmodel) | | ✓ | | 1 ~ 10 items | レアリティパラメータの付与数モデルのリスト
付与されるパラメータスロット数を決定するための重み付き抽選エントリを定義します。各エントリは付与数と排出重みを指定します。重みが大きいほど、その付与数が選択される確率が高くなります。 |
| parameters | [List<RarityParameterValueModel>](#rarityparametervaluemodel) | | ✓ | | 1 ~ 1000 items | レアリティパラメータ値モデルのリスト
抽選可能なパラメータ値のプールを定義します。各エントリはパラメータ名、リソース詳細、排出重みを指定します。パラメータスロットを埋める際、このプールから重複なしの重み付き抽選で値が選択されます。 |
---
### RarityParameterCountModel
レアリティパラメータの付与数モデル
リソースに付与されるパラメータスロット数を決定するための重み付き抽選の単一エントリを定義します。各エントリはパラメータ数と排出重みをペアにし、パラメータ数量の確率分布を細かく制御できます。
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| count | int | | ✓ | | 0 ~ 10 | 付与数
このエントリが抽選された際に付与するパラメータスロット数です。例えば、付与数が 3 の場合、リソースは値モデルプールから選択された 3 つのパラメータ値を受け取ります。 |
| weight | int | | ✓ | | 1 ~ 2147483646 | 排出重み
パラメータ付与数を決定する重み付き抽選で使用される相対的な重みです。値が大きいほど、この付与数が選択される確率が高くなります。実際の確率は、この重みを付与数モデルリスト内のすべての重みの合計で割った値になります。 |
---
### RarityParameterValueModel
レアリティパラメータ値モデル
レアリティパラメータ値の重み付き抽選プール内の単一エントリを定義します。各エントリはパラメータ名、ゲーム定義のリソース詳細、およびプール内の他のエントリに対する選択確率を決定する排出重みを指定します。
| | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| name | string | | ✓ | | ~ 64文字 | 名前
この抽選エントリの識別子です。レアリティパラメータモデルの値プール内で一意である必要があります。抽選された際、この名前が結果のレアリティパラメータ値に保存されます。 |
| metadata | string | | | | ~ 512文字 | メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
| resourceName | string | | ✓ | | ~ 64文字 | ゲーム内で使用するパラメータリソースの種類を表す名前（GS2の動作のためには使用しません）
このパラメータ値に関連付けられたゲーム定義のリソース種別名（例: "fire_attack"、"ice_resist"）です。GS2 はこの値を自身の動作には使用せず、抽選結果にそのまま渡されゲームロジックで使用されます。 |
| resourceValue | long | | ✓ | | 0 ~ 9223372036854775805 | ゲーム内で使用するパラメータリソースの値（GS2の動作のためには使用しません）
このパラメータのゲーム定義の数値（例: 攻撃力+50 の場合は 50）です。GS2 はこの値を自身の動作には使用せず、抽選結果にそのまま渡されゲームロジックで使用されます。 |
| weight | int | | ✓ | | 1 ~ 2147483646 | 排出重み
パラメータ値を選択する重み付き抽選で使用される相対的な重みです。値が大きいほど、このエントリが選択される確率が高くなります。実際の確率は、この重みをプール内のすべての重みの合計で割った値になります。 |
---