게임 내 리더보드: 순위, 라운드, 보상

플레이어가 보는 것

• 탭으로 된 보드: 각 보드에 플레이어의 점수, 순위, 라운드 종료까지의 시간이 나오는 카드가 있습니다.
• 상위 플레이어, 플레이어 강조 표시, 상위 3명 메달.
• 창으로 보는 순위 보상과 점수 보상. 점수 보상은 그 자리에서 받습니다.
• 지난 라운드 보상 창: 라운드가 끝나면 "받기" 버튼과 함께 저절로 뜹니다.
• 게임에 점수를 얻는 모드가 있으면 카드의 "플레이" 버튼.
• 보상이 기다릴 때 탭의 배지.

보드의 구조

• 라운드. 보드는 주기적으로(예: 매주) 반복되거나, 일정에 따라 돌거나, 라운드 체인으로 진행됩니다.
• 점수 계산 방식. 모든 결과의 합, 최고 결과, 최고 기록 시간, 마지막 값.
• 순위 보상: 라운드가 끝날 때 순위 구간별로. 1위, 23위, 410위 등.
• 점수 보상: 라운드 안의 마일스톤. "이번 주에 1000점 얻기".

점수는 어디서 오나

점수는 보드에 설정한 출처에서 옵니다:

• 게임의 결과(ClientScore). 게임이 숫자를 보냅니다. 예를 들어 달리기 점수. ⚠ 출처에 한도를 거세요. 제출당 최대치, 하루 최대치, 제출 사이의 간격. 이 출처가 없으면 보드는 게임의 숫자를 아예 받지 않습니다.
• 서버가 직접 세는 이벤트. 예를 들어 구매나 끝낸 퀘스트. 이것은 게임에서 조작할 수 없습니다.

개발자용

리더보드는 @idosgames/core의 client.leaderboard로 작동합니다.

// 결과 제출: 서버가 계산 규칙과 한도를 적용합니다
const sub = await client.leaderboard.submitScore('weekly_score', 150)
if (!sub.ok) return showError(sub.error)
sub.data.NewScore // 계산 후의 점수

// 보드가 여러 개인 화면: 상위 목록과 플레이어 진행도를 한 번의 요청으로
const overview = await client.leaderboard.getOverviewBatch(['weekly_score', 'season_pvp'])

// 기다리는 모든 것 받기: 순위 보상과 점수 보상
await client.leaderboard.claimAllRewardsBatch(['weekly_score', 'season_pvp'])

• SDK는 0 이하의 점수를 요청 없이 스스로 거부합니다.
• 새 점수는 응답의 NewScore에서 가져오세요. "최고 결과" 방식에서는 더 나쁜 결과가 점수를 바꾸지 않습니다.
• 친구 순위는 getFriendsLeaderboard(leaderboardID)입니다.

모든 필드는 SDK의 MCP 서버가 제공하는 leaderboard-system 스킬에 설명되어 있습니다.