GS2-Mission 스크립트 트리거 레퍼런스

확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스

트리거

missionComplete

미션 달성

동기 실행 스크립트

미션 달성 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
missionGroupModel MissionGroupModel 미션 그룹
oldComplete Complete 달성 전 달성 상황
newComplete Complete 달성 후 달성 상황
completeTaskNames [] 달성한 태스크 이름 리스트
Result
타입 필수 기본값 값 제한 설명
permit bool
✓
미션 달성을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local missionGroupModel = args.missionGroupModel
local oldComplete = args.oldComplete
local newComplete = args.newComplete
local completeTaskNames = args.completeTaskNames

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

미션 달성 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
missionGroupModel MissionGroupModel 미션 그룹
complete Complete 달성 상황
completeTaskNames [] 달성한 태스크 이름 리스트
구현 예제
-- Request
local namespace = args.namespace
local missionGroupModel = args.missionGroupModel
local complete = args.complete
local completeTaskNames = args.completeTaskNames

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

counterIncrement

카운터 상승

동기 실행 스크립트

카운터 상승 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
counterModel CounterModel 카운터 모델
oldCounter Counter 갱신 전 카운터
newCounter Counter 갱신 후 카운터
Result
타입 필수 기본값 값 제한 설명
permit bool
✓
카운터 상승을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local counterModel = args.counterModel
local oldCounter = args.oldCounter
local newCounter = args.newCounter

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

카운터 상승 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
counterModel CounterModel 카운터 모델
counter Counter 카운터
구현 예제
-- Request
local namespace = args.namespace
local counterModel = args.counterModel
local counter = args.counter

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

receiveRewards

보상 수취

동기 실행 스크립트

보상 수취 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
missionGroupModel MissionGroupModel 미션 그룹
oldComplete Complete 갱신 전 달성 상황
newComplete Complete 갱신 후 달성 상황
receiveRewardTaskNames [] 보상을 수취할 태스크 이름 리스트
Result
타입 필수 기본값 값 제한 설명
permit bool
✓
보상 수취를 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local missionGroupModel = args.missionGroupModel
local oldComplete = args.oldComplete
local newComplete = args.newComplete
local receiveRewardTaskNames = args.receiveRewardTaskNames

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

보상 수취 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
missionGroupModel MissionGroupModel 미션 그룹
complete Complete 달성 상황
receiveRewardTaskNames [] 보상을 수취할 태스크 이름 리스트
구현 예제
-- Request
local namespace = args.namespace
local missionGroupModel = args.missionGroupModel
local complete = args.complete
local receiveRewardTaskNames = args.receiveRewardTaskNames

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}