Godot-GameBackendSDK 1.0.0 Scripts 4.4 Community

Submitted by user HOXSEC; MIT; 2025-12-26

GameBackendSDK is a production-ready Godot 4.4+ addon for integrating a custom game backend into your project.

It provides a clean, type-safe GDScript API for common online features without external dependencies.

Features
- Authentication: guest login, email/password register & login, automatic token refresh
- Cloud Saves: key-value storage with versioning and optimistic locking
- Leaderboards: submit scores, fetch rankings, get player position
- Remote Config: platform-specific config and feature flags
- Automatic retries with exponential backoff
- Request queueing to avoid race conditions
- Persistent token storage
- Pure GDScript, zero external plugins

Requirements
- Godot 4.4 or newer
- A backend implementing the provided REST API contract
(A reference backend is available on GitHub)

Installation
1. Copy addons/GameBackendSDK/ into your project’s addons/ folder
2. Enable the plugin in Project Settings
3. Add Backend.gd as an Autoload singleton named Backend

Quick Example
- Initialize the SDK with your backend URL and project ID
- Ensure a guest session
- Save cloud data or submit leaderboard scores
All API calls return a consistent result dictionary with clear error handling.

What this is
- A client SDK for your own backend
- Suitable for production projects
- Designed to be predictable, debuggable, and safe by default

What this is NOT
- A hosted backend service
- A drop-in replacement for PlayFab or Firebase

Includes a demo scene and smoke tests to verify backend integration quickly.

Licensed under MIT.