GS2-Experience Buff Reference
Describes the fields within models/actions whose parameters can be adjusted when applying buffs with GS2-Buff, and how to configure the scope in which those buffs are applied.
Note
See BuffEntryModel for more information on the buff entry model.Model
Target model types available for buff application
Gs2Experience:Status
Status
Target fields for buff application
rankCapValue
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| rankCapValue | long | ✓ | 0 ~ 9223372036854775805 | Current Rank Cap |
Example Master Data
rate specifies the multiplier applied to the target field.
"targetModel": {
"targetModelName": "Gs2Experience:Status",
"targetFieldName": "rankCapValue",
"conditionGrns": [
],
"rate": 1.0
}Buff Application Condition Model
Gs2Experience:ExperienceModel
Experience Model
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:ExperienceModel",
"targetGrn": "grn:gs2:any:any:experience:{namespaceName}:model:{experienceName}"
}
]Gs2Experience:Status
Status
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:Status",
"targetGrn": "grn:gs2:any:any:experience:{namespaceName}:user:any:experienceModel:{experienceName}:property:{propertyId}"
}
]Action
Types of actions that can apply buffs
Gs2Experience:AddExperienceByUserId
Add experience by specifying a user ID
Target fields for buff application
experienceValue
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | Gained Experience |
Example Master Data
"targetAction": {
"targetActionName": "Gs2Experience:AddExperienceByUserId",
"targetFieldName": "experienceValue",
"conditionGrns": [
],
"rate": 1.0
}Buff Application Condition Model
Gs2Experience:ExperienceModel
Experience Model
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:ExperienceModel",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
}
]Gs2Experience:Status
Status
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:Status",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
}
]Gs2Experience:SubExperience
Subtract experience
Target fields for buff application
experienceValue
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | Lost Experience |
Example Master Data
"targetAction": {
"targetActionName": "Gs2Experience:SubExperience",
"targetFieldName": "experienceValue",
"conditionGrns": [
],
"rate": 1.0
}Buff Application Condition Model
Gs2Experience:ExperienceModel
Experience Model
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:ExperienceModel",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
}
]Gs2Experience:Status
Status
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:Status",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
}
]Gs2Experience:SubExperienceByUserId
Subtract experience by specifying a user ID
Target fields for buff application
experienceValue
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | Lost Experience |
Example Master Data
"targetAction": {
"targetActionName": "Gs2Experience:SubExperienceByUserId",
"targetFieldName": "experienceValue",
"conditionGrns": [
],
"rate": 1.0
}Buff Application Condition Model
Gs2Experience:ExperienceModel
Experience Model
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:ExperienceModel",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
}
]Gs2Experience:Status
Status
Example Master Data
"conditionGrns": [
{
"targetModelName": "Gs2Experience:Status",
"targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
}
]