Trigger Reference of GS2-Idle Script

Reference of event triggers that call extended scripts

Trigger

receive

Receive Rewards

Synchronous Execution Script

Script and Receive Rewards are executed synchronously in that order.

Request

	Type	Description
namespace	Namespace	Namespace
category	CategoryModel	Category Model
userId	string	User ID executing reward receive
status	Status	Status
acquireActions	AcquireAction[]	Rewards
config	Config[]	Set values to be applied to transaction variables

Result

	Type	Required	Default	Value Limits	Description
permit	bool	✓			Whether to allow receive
rate	float		1.0	0 ~ 1000	Acquisition quantity rate

Implementation Example

namespace = args.namespace
category = args.category
userId = args.userId
status = args.status
acquireActions = args.acquireActions
config = args.config

result = {
  permit=permit,
  rate=rate
}

Asynchronous Execution Script

The script will run after the Receive Rewards is executed.

Request

	Type	Description
namespace	Namespace	Namespace
category	CategoryModel	Category Model
userId	string	User ID performing the idle
oldStatus	Status	Status
newStatus	Status	Status
acquireActions	AcquireAction[]	Rewards
config	Config[]	Set values to be applied to transaction variables

Result

	Type	Required	Default	Value Limits	Description

Implementation Example

namespace = args.namespace
category = args.category
userId = args.userId
oldStatus = args.oldStatus
newStatus = args.newStatus
acquireActions = args.acquireActions
config = args.config

result = {
}

overrideAcquireActions

Script for dynamically determining idle reward acquire actions

Synchronous Execution Script

Script and Script for dynamically determining idle reward acquire actions are executed synchronously in that order.

Request

	Type	Description
namespace	Namespace	Namespace
categoryModel	CategoryModel	Category Model
userId	string	User ID

Result

	Type	Required	Default	Value Limits	Description
acquireActions	AcquireActionList[]	✓		1 ~ 100 items	List of acquire actions for each waiting time Assuming that the waiting time is “X minutes”, “X / rewardIntervalMinutes” will be the number of rewards that can be received, but by looping the elements specified in this array, different rewards can be given for each waiting time.

Implementation Example

namespace = args.namespace
categoryModel = args.categoryModel
userId = args.userId

result = {
  acquireActions=acquireActions
}