CoolAPI for Unity

Install

Option A — One-click .unitypackage (recommended)

1. Download CoolGameX-SDK.unitypackage.
2. In Unity: Assets → Import Package → Custom Package…
3. Pick the file, click Import. Assets/CoolGameX/ appears — done.

Option B — Zip

Download the .zip, unzip it, and drop the CoolGameX/ folder anywhere under your project's Assets/.

Quick start

First, create your game in the launcher's Admin panel and note its slug (e.g. my-cool-game). Then:

The easy way — no code

1. Create an empty GameObject in your first scene.
2. Add Component → Cool GameX → Cool GameX Manager.
3. Set Game Slug and Server URL (https://coolgamex-davi.fly.dev).

It initializes the SDK, logs in with the launcher token, and tracks playtime automatically. Unlock achievements from anywhere:

using CoolGameX;

CoolGameXManager.Unlock("speed_runner");
CoolGameXManager.AddStat("enemies_killed");

// react to first-time unlocks (your own banner / SFX):
CoolGameXManager.AchievementUnlocked += slug => Debug.Log($"Unlocked {slug}!");

The manual way — full control

using CoolGameX;
using UnityEngine;

public class GameBootstrap : MonoBehaviour
{
    async void Start()
    {
        await CoolAPI.Initialize("my-cool-game", "https://coolgamex-davi.fly.dev");

        if (CoolAPI.IsAuthenticated)
            await CoolAPI.Auth.LoginWithToken(CoolAPI.Token);

        CoolAPI.Achievements.OnAchievementUnlocked += slug => Debug.Log($"🏆 {slug}");
        CoolAPI.Playtime.StartSession();
    }

    async void OnApplicationQuit() => await CoolAPI.Playtime.EndSession();
}

Achievements

Unlocks are idempotent — call them as often as you like; the backend ignores duplicates and the event fires only the first time.

// simple
await CoolAPI.Achievements.Unlock("first_blood");

// detailed — know if it was newly unlocked
UnlockResult r = await CoolAPI.Achievements.UnlockDetailed("first_blood");
if (r.NewlyUnlocked) PlayFanfare();

// typed list of this game's achievements
AchievementInfo[] all = await CoolAPI.Achievements.GetDefinitions();

Player Stats

Persist per-player numbers — kills, levels cleared, coins, a high score. Stats live on the backend and follow the player across machines.

CoolGameXManager.AddStat("enemies_killed");        // +1
CoolGameXManager.SetStat("high_score", 9001);

// or await for the result:
int total = await CoolAPI.Stats.Add("enemies_killed", 5); // returns new total
await CoolAPI.Stats.Set("high_score", 9001);
int kills = await CoolAPI.Stats.Get("enemies_killed");

DLC

Players acquire DLC by redeeming a code or buying it in the launcher. Your game just checks ownership:

if (await CoolAPI.DLC.Owns("haunted-expansion"))
    UnlockExpansionContent();

string[] owned = await CoolAPI.DLC.ListOwned();

Playtime

The manager tracks sessions for you. To do it manually (or add a crash-proof heartbeat):

CoolAPI.Playtime.StartSession();
// ... every few minutes, so progress survives a crash:
await CoolAPI.Playtime.ReportMinutes(5);
// on quit:
await CoolAPI.Playtime.EndSession();

API reference

CoolAPI

CoolAPI.Achievements

CoolAPI.Stats

CoolAPI.DLC

CoolAPI.Playtime