Game Developer Guide
GRG Games SDK로 간단하게 랭킹 시스템을 구축하세요
🚀 Game Developer Guide - Ranking Game
JS SDK 포함하기
게임 HTML에 GRG Games SDK를 포함하세요.
<script src="https://grggames.com/grg-games-sdk.js"></script>
스코어 제출하기
- 게임 종료 시 간단한 함수 호출로 스코어를 제출하세요.
- 스코어는 -999,999 ~ 999,999,999,999 범위 내에서 제출 가능합니다.
- 낮은 숫자가 높은 순위를 의미하는 게임이라면, 최종 score에 * -1로 전달하여 음수를 사용하세요.
// 게임 종료 시 score(typeof Number) 제출. GRGScore.onGameEnd(score);
완료!
- 이제 게임에서 스코어가 자동으로 랭킹에 등록됩니다. 토큰이나 인증 처리는 게임에서 하지 않습니다.
- GRG Games에서 플레이할 때 플랫폼이 세션을 만들고, SDK는 점수만 전달합니다.
🛡️ Security & Protection Guide
세션은 플랫폼이 처리
- 게임은 점수를 제출하기만 하면 됩니다. 토큰을 읽거나 전달하지 마세요.
- 로그인과 플레이 세션은 GRG Games 페이지에서 서버로 처리됩니다.
- iframe URL, localStorage, DOM에 인증값을 넣지 않아도 됩니다.
스코어 검증
- 스코어는 숫자 타입만 허용됩니다.
- 유효한 범위: -999,999 ~ 999,999,999,999
- 무한대, NaN 등은 자동으로 차단됩니다.
// 올바른 스코어 제출 예시
const finalScore = 1250; // 숫자 타입
GRGScore.onGameEnd(finalScore);
// 잘못된 예시 (자동 차단됨)
GRGScore.onGameEnd("1250"); // 문자열
GRGScore.onGameEnd(Infinity); // 무한대
GRGScore.onGameEnd(null); // null속도 제한 (Rate Limiting)
- 1초당 1회만 스코어 제출이 가능합니다.
- 일일 최대 100회 제출 제한이 있습니다.
- 게임 시작 직후 너무 빠른 제출은 서버에서 차단됩니다.
Cross-Origin 보안
- 게임이 호스팅된 도메인에서만 스코어 제출이 가능합니다.
- 다른 도메인이나 동일 출처에서의 조작은 모두 차단됩니다.
- 새로운 게임 도메인은 자동으로 지원됩니다.
보안 안내
게임에서는 GRGScore.onGameEnd(score)만 호출하면 됩니다. 점수는 플랫폼 서버를 통해서만 기록되며, 개발자가 토큰이나 DB를 직접 다룰 필요는 없습니다.