rookiegamers (Python)

Server-side helpers for RookieGamers games: verify the short-lived player JWT from the browser SDK, and report trusted scores with a game server key.

This is the companion to the browser SDK (https://rookiegamers.com/sdk/v1.js / npm rookiegamers). Version 1.5.0 matches that SDK line.

Docs: rookiegamers.com/docs · Source: github.com/ecoay/rookiegamers

Install

pip install rookiegamers

Usage

from rookiegamers import RookieGamers, TokenError

rg = RookieGamers(
    "my-game",
    server_key="rgs_...",   # from /dev or create_server_key MCP/CLI
)

# Browser sent the SDK token (rg.user.token()) to your server:
try:
    claims = rg.verify_token(token_from_browser)
except TokenError:
    ...  # reject

player_id = claims["sub"]   # e.g. p0123...

# Trusted score (same body unsays posts):
rg.submit_score(player_id, 212)

# Optional — documented store entitlements check:
owned = rg.entitlements(player_id)

What verify_token checks

Matches the unsays reference integration:

Documented REST used here

• POST /api/v1/scores — { "game", "player", "score" } with Authorization: Bearer rgs_...
• GET /api/v1/store/<slug>/entitlements?player=<id> — with the same server key

No other endpoints are wrapped. For publishing games, use the CLI/MCP (rgk_... developer key), not this library.

License

Proprietary. Copyright © Tenacié LLC. All rights reserved.

The RookieGamers portal repository does not currently ship a LICENSE file. Use of this package is subject to the RookieGamers Terms. Contact the publisher for other licensing.