Troubleshooting

Cause: The game wasn't launched from GameTribe, so there's no session token in the URL.

Solution:

• In development, enable mockAPIResponses = true in your PlatformConfig
• In production, ensure the game is launched via GameTribe (not directly)
• For testing with real tokens, copy the full URL from GameTribe including query parameters

Cause: The session or user token is invalid or expired.

Solution:

• Check that your API Key and Game ID are correct in PlatformConfig
• Verify the backend URL is correct
• Sessions expire after 24 hours — refresh the game page
• Check backend logs for more details

Cause: PlatformSDK component isn't in the scene or hasn't initialized yet.

Solution:

• Ensure a GameObject with PlatformSDK component exists in your scene
• Wait for OnSDKReady before accessing SDK features
• Don't destroy the SDK GameObject when loading scenes

// Always wait for SDK ready
void Start()
{
    PlatformSDK.Instance.OnSDKReady += () =>
    {
        // Now safe to use SDK
    };
}

Cause: Score submission is asynchronous or the session wasn't ended properly.

Solution:

• Always call EndSessionAsync() with the final score
• Wait 1-2 seconds for backend processing before refreshing the leaderboard
• Check that the session was active (IsSessionActive = true)
• Verify the response from EndSessionAsync shows success = true

Cause: Events are batched and not sent immediately, or there's a configuration issue.

Solution:

• Check API Key and Base URL in PlatformConfig
• Call FlushAsync() in OnApplicationQuit()
• Enable debugMode = true to see event logs
• Verify network connectivity

Cause: API Key doesn't match the game or authentication token is invalid.

Solution:

• Double-check your API Key matches the one in the GameTribe dashboard
• Ensure you're using the correct Game ID
• Verify the game was created in the dashboard before testing

Cause: mockAPIResponses is still enabled.

Solution:

• Set mockAPIResponses = false in your PlatformConfig
• Create separate config assets for development and production

Cause: WebGL-specific issues with JavaScript bridge or CORS.

Solution:

• Ensure the game is served from the same domain or CORS is configured
• Check browser console for JavaScript errors
• Verify the WebGL build includes the Plugins/WebGL folder
• Test with a simple HTTP server, not file:// protocol

Yes! Enable mockAPIResponses = true in your PlatformConfig. The SDK will return mock data for all API calls, allowing you to develop and test without a backend connection.

Events are queued locally and retried with exponential backoff. If the player goes offline during gameplay, events will be sent when connectivity is restored. For critical events like scores, implement your own local storage as backup.

Leaderboard rankings are computed asynchronously. The scoreRankfield in EndSessionResponse may be null initially. Poll the leaderboard API after a few seconds to get the updated rank.

Yes! The SDK works in the Editor with mock responses enabled. Token extraction from URL only works in WebGL builds, so use mock mode or manual token injection for Editor testing.

Tournaments are handled automatically by the backend. When you submit a score viaEndSessionAsync() or SubmitScore(), the backend checks for active tournaments and enrolls the player automatically. No SDK changes are needed.