Master Data Reference of GS2-Buff

{
  "version": "2024-04-15",
  "buffEntryModels": [
    {
      "name": "[string]Buff entity name",
      "metadata": "[string?]metadata",
      "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"
      },
      "expression": "[string]Application type of buff",
      "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>

BuffTargetModel

Buff Target Model

	Type	Require	Limitation	Description
targetModelName	enum [ ]	✓	~ 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	✓	~ 100	Rate

BuffTargetAction

Buff Target Action

	Type	Require	Limitation	Description
targetActionName	enum [ ]	✓	~ 128 chars	Types of action 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	✓	~ 100	Rate

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	Limitation	Description
buffEntryModelId	string		✓	~ 1024 chars	Buff entity model GRN
name	string		✓	~ 128 chars	Buff entity name
metadata	string			~ 2048 chars	metadata
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
expression	enum [ “add”, “mul” ]		✓	~ 128 chars	Application type of buff
priority	int		✓	~ 2147483646	Priority of buff application
applyPeriodScheduleEventId	string			~ 1024 chars	Event ID to apply buff