GS2-Exchange Buff リファレンス

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

Note

バフエントリーモデルの詳細については BuffEntryModel をご参照ください。

Model

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

Gs2Exchange:RateModel

交換レートモデル

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

lockTime

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:RateModel

交換レートモデル

マスターデータ記述例

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

acquireActions

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:RateModel

交換レートモデル

マスターデータ記述例

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

verifyActions

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:RateModel

交換レートモデル

マスターデータ記述例

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

consumeActions

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:RateModel

交換レートモデル

マスターデータ記述例

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

Gs2Exchange:IncrementalRateModel

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

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

acquireActions

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:IncrementalRateModel

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

マスターデータ記述例

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

consumeAction

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:IncrementalRateModel

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

マスターデータ記述例

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

maximumExchangeCount

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

マスターデータ記述例

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

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

バフの適用条件モデル

Gs2Exchange:Namespace

ネームスペース

マスターデータ記述例

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

Gs2Exchange:IncrementalRateModel

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

マスターデータ記述例

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