Master Data Reference of GS2-Buff
{
"version": "2024-04-15",
"buffEntryModels": [
{
"name": "[string]Buff entity 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 ID to apply buff"
}
]
}
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
version | ✓ | 2024-04-15 | Format version of master data | |||
buffEntryModels | List<BuffEntryModel> | ~ 100 items | Buff Model |
BuffTargetModel
Buff Target Model
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
targetModelName | enum { "Gs2Exchange:RateModel", "Gs2Exchange:IncrementalRateModel", "Gs2Experience:Status", "Gs2Formation:Mold", "Gs2Idle:CategoryModel", "Gs2Idle:Status", "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 | ✓ | ~ 1000000 | Rate |
BuffTargetAction
Buff Target Action
BuffTargetGrn
Buff Target GRN pattern
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
targetModelName | string | ✓ | ~ 64 chars | Buff application condition model name | ||
targetGrn | string | ✓ | ~ 1024 chars | Buff application condition GRN |
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 | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
buffEntryModelId | string | ✓ | ~ 1024 chars | Buff entity model GRN | ||
name | string | ✓ | ~ 128 chars | Buff entity name | ||
metadata | string | ~ 2048 chars | metadata | |||
expression | enum { “rate_add”, “mul”, “value_add” } | ✓ | ~ 128 chars | Application type of buff | ||
targetType | enum { “model”, “action” } | ✓ | ~ 128 chars | Type of target to apply buff | ||
targetModel | BuffTargetModel | {targetType} == “model” | ✓ | Model to apply buff | ||
targetAction | BuffTargetAction | {targetType} == “action” | ✓ | Action to apply buff | ||
priority | int | ✓ | ~ 2147483646 | Priority of buff application | ||
applyPeriodScheduleEventId | string | ~ 1024 chars | Event ID to apply buff |
Enumeration type definition to specify as expression
Enumerator String Definition | Description |
---|---|
rate_add | Rate Add |
mul | Mul |
value_add | Value Add |
Enumeration type definition to specify as targetType
Enumerator String Definition | Description |
---|---|
model | Model |
action | Action |
OverrideBuffRate
Buff application rate override model
Type | Condition | Require | Default | Limitation | Description | |
---|---|---|---|---|---|---|
name | string | ✓ | ~ 128 chars | Buff entity name | ||
rate | float | ✓ | ~ 100 | Rate |