앱 리더보드
개요
게임 플레이를 통해 획득한 킬 수, 보유 포인트 등 주요 지표를 점수로 변환해 WorldRankService의 리더보드에 등록할 수 있습니다.
등록된 점수와 랭크는 앱(아웃게임)과 인게임(월드) 모두에서 확인 가능하며, 이를 통해 플레이어 간의 경쟁심을 높이고, 월드의 참여도와 전반적인 활성화를 크게 향상시킬 수 있습니다.
사용 방법
기능 목록
다음 기능은 서버 스크립트에서만 사용할 수 있으며, 클라이언트에서는 호출할 수 없습니다.
WorldRankService:IncrementScore(player, delta)
지정한 player의 점수 변화량을 리더보드에 등록합니다. 점수는 정수만 허용되며, 변화량은 양수만 입력할 수 있습니다. 입력 가능한 최대 변화량은 100,000이며, 이 값을 초과한 요청은 처리되지 않습니다.
WorldRankService:GetScore(player)
리더보드에 등록된 해당 player의 현재 점수를 반환합니다.
점수 정렬
리더보드의 점수는 항상 내림차순으로 정렬되며, 이 정렬 방식은 변경할 수 없습니다.
전체 코드 예시
다음 코드는 게임 종료 시점을 기준으로, 플레이어가 게임 진행 중에 획득한 추가 점수를 WorldRankService 리더보드에 등록하고, 등록된 최종 점수를 불러와 ResultUI에 표시하는 예시입니다.
IncrementScore 함수는 리더보드에 최종 점수 전체가 아닌 ‘증가한 점수의 변화량’을 전달하므로, 사용 시 이 점을 반드시 유의해야 합니다.
퍼블리시 및 테스트 환경의 동작 차이
퍼블리시 후 모바일 환경에서는 실제 서버에 데이터를 저장하고 불러옵니다. 반면, 스튜디오 테스트 환경에서는 해당 기능이 동작하지 않으며, 호출 시 WorldRank API is not available in the editor. It only works in the live game environment. 로그가 출력됩니다.
순위 및 점수 표시
리더보드에 플레이어의 점수가 등록되어 있는 경우, 캐릭터 상단에 현재 순위와 점수가 표시됩니다.
점수가 변경된 후에는 월드에 다시 접속해야 최신 정보로 갱신되어 표시됩니다.
앱(아웃게임)에서는 월드 상세 화면에 Top Scorer 섹션이 노출되며, 해당 월드의 플레이어 순위와 점수가 리스트 형태로 표시됩니다.
활용 예시
처치 수 등을 점수화해 리더보드에 등록하여 경쟁 요소를 강화할 수 있습니다.
월드 입장 전 아웃게임 Top Scorer 섹션을 통해 “이 월드의 상위 플레이어는 이 정도 점수를 달성했다”와 같은 목표 의식을 제공할 수 있습니다.
누적 점수를 활용해 스킨/코스튬 등 보상을 제공하는 경제 구조를 만들면 장기 플레이 유도 효과를 기대할 수 있습니다.
기간 한정 이벤트에서 누적 포인트를 집계해 상위권 플레이어에게 보상을 지급하는 방식으로 월드 참여도를 높일 수 있습니다.
주의 사항
리더보드에 전달되는 값은 최종 점수 전체가 아닌, 증가한 점수의 변화량입니다.
리더보드에 등록된 점수는 차감하거나 삭제(초기화)할 수 없습니다.
Last updated