GS2-Buff マスターデータリファレンス
{
"version": "2024-04-15",
"buffEntryModels": [
{
"name": "[string]バフエンティティ名",
"metadata": "[string?]メタデータ",
"targetType": "[string]バフをかける対象の種類",
"targetModel": {
"targetModelName": "[string]バフを適用するモデルの種類",
"targetFieldName": "[string]バフの適用対象フィールド名",
"conditionGrns": [
{
"targetModelName": "[string]バフの適用条件のモデル名",
"targetGrn": "[string]バフの適用条件GRN"
}
],
"rate": "[float]レート"
},
"targetAction": {
"targetActionName": "[string]バフを適用するアクションの種類",
"targetFieldName": "[string]バフの適用対象フィールド名",
"conditionGrns": [
{
"targetModelName": "[string]バフの適用条件のモデル名",
"targetGrn": "[string]バフの適用条件GRN"
}
],
"rate": "[float]レート"
},
"expression": "[string]バフの適用タイプ",
"priority": "[int]バフの適用優先度",
"applyPeriodScheduleEventId": "[string?]バフを適用するイベントの開催期間"
}
]
}
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
version | ✓ | 2024-04-15 | マスターデータのフォーマットバージョン | |||
buffEntryModels | List<BuffEntryModel> |
BuffTargetModel
モデルに適用するバフ
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
targetModelName | enum [ ] | ✓ | ~ 128文字 | バフを適用するモデルの種類 | ||
targetFieldName | string | ✓ | ~ 64文字 | バフの適用対象フィールド名 | ||
conditionGrns | List<BuffTargetGrn> | ✓ | 1 ~ 10 items | バフの適用条件GRNのリスト | ||
rate | float | ✓ | ~ 100 | レート |
BuffTargetAction
アクションに適用するバフ
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
targetActionName | enum [ ] | ✓ | ~ 128文字 | バフを適用するアクションの種類 | ||
targetFieldName | string | ✓ | ~ 64文字 | バフの適用対象フィールド名 | ||
conditionGrns | List<BuffTargetGrn> | ✓ | 1 ~ 10 items | バフの適用条件GRNのリスト | ||
rate | float | ✓ | ~ 100 | レート |
BuffTargetGrn
バフを適用するリソースのGRNパターン
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
targetModelName | string | ✓ | ~ 64文字 | バフの適用条件のモデル名 | ||
targetGrn | string | ✓ | ~ 1024文字 | バフの適用条件GRN |
BuffEntryModel
バフモデル
バフの適用量は BuffEntryModel で管理し、特定のエントリーに対して複数の BuffEntryModel を関連づけることが可能です。 BuffEntryModel の適用順番は BuffEntryModel の priority で管理し、priority の値が小さいほど優先度が高くなります。
バフの適用方式は2種類存在し「Add」と「Mul」があります。 Add はバフの適用レートに加算する命令で、Mul はバフの適用レートに乗算する命令です。 デフォルトのレートは 1.0 で、Add 0.2 と設定するとバフの適用レートが 1.2 になります。 Mul 0.5 と設定するとバフの適用レートが 0.5 倍になります。
BuffEntryModel には GS2-Schedule のイベントを関連づけることができ、イベントの開催期間中のみバフを適用するような設定も可能です。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
buffEntryModelId | string | ✓ | ~ 1024文字 | バフモデルGRN | ||
name | string | ✓ | ~ 128文字 | バフエンティティ名 | ||
metadata | string | ~ 2048文字 | メタデータ | |||
targetType | enum [ “model”, “action” ] | ✓ | ~ 128文字 | バフをかける対象の種類 | ||
targetModel | BuffTargetModel | {targetType} == “model” | ✓ | バフをかける対象のモデル | ||
targetAction | BuffTargetAction | {targetType} == “action” | ✓ | バフをかける対象のアクション | ||
expression | enum [ “add”, “mul” ] | ✓ | ~ 128文字 | バフの適用タイプ | ||
priority | int | ✓ | ~ 2147483646 | バフの適用優先度 | ||
applyPeriodScheduleEventId | string | ~ 1024文字 | バフを適用するイベントの開催期間 |