qubiz
Back to all docs
qubiz-game-sdk

Python Creator SDK

Use Python helpers to validate manifests and analytics events before upload.

pythonmanifestvalidatepypi

Install

The Python package is creator tooling. It does not run inside the browser game. Use it for validation scripts, CI checks, upload helpers, and release pipelines.

Install from PyPI
pip install qubiz-game-sdk

Validate a manifest and event

validate_manifest checks slug format, title length, description length, tag limits, scope limits, and known permission scopes. validate_event checks event name, stage, source, numeric value, and metadata limits.

Python validation
from qubiz_game_sdk import GameManifest, SDKEvent, validate_event, validate_manifest

manifest = GameManifest(
    slug="my-game",
    title="My Game",
    description="A small HTML5 arcade game.",
    requested_scopes=["profile:username", "analytics:events"],
    tags=["arcade", "short-rounds"],
)
validate_manifest(manifest)

progress_event = SDKEvent(
    name="level_reached",
    stage="world-1",
    source="tutorial",
    value=3,
    metadata={"difficulty": "normal"},
)
validate_event(progress_event)