> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Exchange Buff リファレンス

GS2-Buff でバフを適用する際に指定する、パラメータの補正が可能なモデル/アクション内のフィールドと、その適用範囲の設定について




{{% alert title="Note" color="info" %}}
バフエントリーモデルの詳細については [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel) をご参照ください。
{{% /alert %}}

## Models
バフを適用可能なモデルの種類

### Gs2Exchange:RateModel
交換レートモデル


#### バフの適用対象フィールド

##### lockTime


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| lockTime | int | {timingType} == "await" | ✓※|  | 0 ~ 538214400 | 交換実行から実際に報酬を受け取れるようになるまでの待ち時間（分）<br>timingType が `await` の場合にのみ適用されます。交換が開始されてからプレイヤーが報酬を受け取れるようになるまでに経過する必要がある実時間の分数を指定します。待ち時間はスキップ機能を使用して短縮できます。<br>※ timingType が "await" であれば必須 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:RateModel",
    "targetFieldName": "lockTime",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:RateModel


交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:RateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:model:{rateName}"
    }
]
```


---
##### acquireActions


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireActions | List&lt;AcquireAction&gt; |  | | [] | 0 ~ 100 items | 入手アクションリスト<br>交換完了時にプレイヤーが受け取るリソース（報酬）を定義します。複数の入手アクションを指定して、さまざまなリソースタイプを同時に付与できます。これらのアクションは分散トランザクション内の入手アクションとして実行されます。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:RateModel",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:RateModel


交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:RateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:model:{rateName}"
    }
]
```


---
##### verifyActions


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| verifyActions | List&lt;VerifyAction&gt; |  | | [] | 0 ~ 10 items | 検証アクションリスト<br>交換が実行される前にすべてパスする必要がある事前条件チェックです。いずれかの検証アクションが失敗すると、リソースを消費せずに交換が中止されます。レベル要件やインベントリ容量などの条件を強制するために使用されます。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:RateModel",
    "targetFieldName": "verifyActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:RateModel


交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:RateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:model:{rateName}"
    }
]
```


---
##### consumeActions


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeActions | List&lt;ConsumeAction&gt; |  | | [] | 0 ~ 10 items | 消費アクションリスト<br>この交換を実行するためにプレイヤーが支払う必要があるリソース（コスト）を定義します。複数の消費アクションを指定でき、ゴールドとアイテムの両方を必要とするような複雑な交換コストを実現できます。これらのアクションは分散トランザクション内の消費アクションとして実行されます。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:RateModel",
    "targetFieldName": "consumeActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:RateModel


交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:RateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:model:{rateName}"
    }
]
```


---

### Gs2Exchange:IncrementalRateModel
コスト上昇型交換レートモデル


#### バフの適用対象フィールド

##### acquireActions


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireActions | List&lt;AcquireAction&gt; |  | | [] | 0 ~ 100 items | 入手アクションリスト<br>コスト上昇型交換の完了時にプレイヤーが受け取るリソース（報酬）を定義します。報酬は交換回数に関わらず一定で、コストのみが交換ごとに増加します。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:IncrementalRateModel",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:IncrementalRateModel


コスト上昇型交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:IncrementalRateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:incremental:model:{rateName}"
    }
]
```


---
##### consumeAction


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeAction | ConsumeAction |  | ✓|  |  | 消費アクション（数量/値は自動的に上書きされます）<br>交換のコストとして消費されるリソースの種類を定義します。実際の数量は交換回数と計算方式（線形、べき乗、スクリプト）に基づいて動的に計算されます。アクションの種類と対象リソースのみ指定すればよく、数量フィールドは自動的に上書きされます。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:IncrementalRateModel",
    "targetFieldName": "consumeAction",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:IncrementalRateModel


コスト上昇型交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:IncrementalRateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:incremental:model:{rateName}"
    }
]
```


---
##### maximumExchangeCount


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| maximumExchangeCount | int |  | | 2147483646 | 0 ~ 2147483646 | 交換回数の上限<br>ユーザーがこのコスト上昇型交換を実行できる最大回数です。交換回数がこの上限に達すると、GS2-Limit によるカウントリセットまでそれ以降の交換が拒否されます。 |


##### マスターデータ記述例

`rate` には、対象フィールドに対する補正レートを指定します。


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Exchange:IncrementalRateModel",
    "targetFieldName": "maximumExchangeCount",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### バフの適用条件モデル

##### Gs2Exchange:Namespace


ネームスペース


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:Namespace",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}"
    }
]
```


##### Gs2Exchange:IncrementalRateModel


コスト上昇型交換レートモデル


##### マスターデータ記述例


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Exchange:IncrementalRateModel",
        "targetGrn": "grn:gs2:any:any:exchange:{namespaceName}:incremental:model:{rateName}"
    }
]
```


---