TPStashEvent.GetBonus

TPStashEvent.GetBonus(
    userId,
    character_uuid,
    bonus_slug,
    is_automated,
    bonus_category_slug --[[Optional--]]
)

설명

캐릭터가 게임 내에서 보너스를 획득한 이벤트 데이터를 수집합니다.

보너스란 게임 내의 컨텐츠 플레이와 상관없이 노력없이 얻게되는 보상을 총칭합니다.

  • 예: 특정 시간 접속하면 보상을 받거나 보상을 받을 기회가 생기는 모든 시스템

  • 예: '접속시간 n분마다' 또는 '일일 n회 한정' 등 특정 조건을 충족하면 얻을 수 있는 추가 보상 시스템

  • 예: 쿠폰 사용

파라미터

이름 설명 필수 여부

UserId

Roblox에서 제공하는 플레이어의 고유 사용자 ID(캐릭터 ID가 아님): Player.UserId

필수

character_uuid

플레이어 캐릭터의 고유 ID

게임에 캐릭터가 없거나, 캐릭터가 아닌 플레이어를 가리킬 경우 character_uuid를 TentuPlayKeyword._DUMMY_CHARACTER_ID_로 설정합니다.

필수

bonus_slug

보너스의 고유 구분자

필수

bonus_category_slug

보너스의 카테고리명

선택

is_automated

자동 획득형 보너스 여부

  • True: 사용자가 가만히 있어도 자동으로 보너스가 획득됨

  • False: 사용자가 보너스 획득을 위해 특정 행동(예: 룰렛 돌리기나 특정 버튼 누리기)을 해야함

필수