Master Data Reference of GS2-Buff
{
"version": "2024-04-15",
"buffEntryModels": [
{
"name": "[string]Buff entry name",
"metadata": "[string?]Metadata",
"expression": "[string]Application type of buff",
"targetType": "[string]Type of target to apply buff",
"targetModel": {
"targetModelName": "[string]Types of model to apply buffs",
"targetFieldName": "[string]Field name to which the buff is applied",
"conditionGrns": [
{
"targetModelName": "[string]Buff application condition model name",
"targetGrn": "[string]Buff application condition GRN"
}
],
"rate": "[float]Rate"
},
"targetAction": {
"targetActionName": "[string]Types of action to apply buffs",
"targetFieldName": "[string]Field name to which the buff is applied",
"conditionGrns": [
{
"targetModelName": "[string]Buff application condition model name",
"targetGrn": "[string]Buff application condition GRN"
}
],
"rate": "[float]Rate"
},
"priority": "[int]Priority of buff application",
"applyPeriodScheduleEventId": "[string?]Event holding period to apply buff"
}
]
}
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| version | ✓ | 2024-04-15 | Format version of master data | |||
| buffEntryModels | List<BuffEntryModel> | ~ 100 items | Buff Model The amount of buff is managed by BuffEntryModel, and it is possible to associate multiple BuffEntryModels with a specific entry. The application order of BuffEntryModel is managed by the priority of BuffEntryModel, and the smaller the value of priority, the higher the priority. There are two types of buff application methods, “Add” and “Mul”. Add is an instruction to add to the buff application rate, and Mul is an instruction to multiply the buff application rate. The default rate is 1.0, and setting Add 0.2 will make the buff application rate 1.2. Setting Mul 0.5 will make the buff application rate 0.5 times. BuffEntryModel can be associated with events of GS2-Schedule, and it is possible to set to apply buffs only during the event holding period. |
BuffTargetAction
Buff Target Action
BuffTargetGrn
Buff Target GRN pattern
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| targetModelName | string | ✓ | ~ 64 chars | Buff application condition model name | ||
| targetGrn | string | ✓ | ~ 1024 chars | Buff application condition GRN |
OverrideBuffRate
Buff application rate override model
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 128 chars | Buff entry name | ||
| rate | float | ✓ | 0 ~ 100 | Rate |
BuffTargetModel
Buff Target Model
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| targetModelName | String Enum enum { "Gs2Exchange:RateModel", "Gs2Exchange:IncrementalRateModel", "Gs2Experience:Status", "Gs2Formation:Mold", "Gs2Idle:Status", "Gs2Idle:CategoryModel", "Gs2Inventory:Inventory", "Gs2LoginReward:BonusModel", "Gs2Mission:MissionTaskModel", "Gs2Quest:QuestModel", "Gs2Showcase:DisplayItem", "Gs2Showcase:RandomDisplayItemModel", "Gs2SkillTree:NodeModel", "Gs2Stamina:Stamina", } | ✓ | ~ 128 chars | Types of model to apply buffs | ||
| targetFieldName | string | ✓ | ~ 64 chars | Field name to which the buff is applied | ||
| conditionGrns | List<BuffTargetGrn> | ✓ | 1 ~ 10 items | List of buff application condition GRNs | ||
| rate | float | ✓ | 0 ~ 1000000 | Rate |
BuffEntryModel
Buff Model
The amount of buff is managed by BuffEntryModel, and it is possible to associate multiple BuffEntryModels with a specific entry. The application order of BuffEntryModel is managed by the priority of BuffEntryModel, and the smaller the value of priority, the higher the priority.
There are two types of buff application methods, “Add” and “Mul”. Add is an instruction to add to the buff application rate, and Mul is an instruction to multiply the buff application rate. The default rate is 1.0, and setting Add 0.2 will make the buff application rate 1.2. Setting Mul 0.5 will make the buff application rate 0.5 times.
BuffEntryModel can be associated with events of GS2-Schedule, and it is possible to set to apply buffs only during the event holding period.
| Type | Condition | Required | Default | Value Limits | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| buffEntryModelId | string | ✓ | ~ 1024 chars | Buff entity model GRN | ||||||||||
| name | string | ✓ | ~ 128 chars | Buff entry name | ||||||||||
| metadata | string | ~ 2048 chars | Metadata | |||||||||||
| expression | String Enum enum { “rate_add”, “mul”, “value_add” } | ✓ | ~ 128 chars | Application type of buff
| ||||||||||
| targetType | String Enum enum { “model”, “action” } | ✓ | ~ 128 chars | Type of target to apply buff
| ||||||||||
| targetModel | BuffTargetModel | {targetType} == “model” | ✓* | Model to apply buff * Enabled if targetType is “model” | ||||||||||
| targetAction | BuffTargetAction | {targetType} == “action” | ✓* | Action to apply buff * Enabled if targetType is “action” | ||||||||||
| priority | int | ✓ | 0 ~ 2147483646 | Priority of buff application | ||||||||||
| applyPeriodScheduleEventId | string | ~ 1024 chars | Event holding period to apply buff |