Unity SDK

Unity SDK

Unity 2021.2+ client (.NET Standard 2.1 API Compatibility Level), zero external package dependencies — no Newtonsoft.Json, no additional UPM packages. Works on Desktop, Mobile, and Console builds; WebGL works for online calls, with one crypto caveat noted below.

Installation

Not yet published as a UPM registry or git-URL package — extract the source ZIP above, then in Unity: Window → Package Manager → + → Install package from disk... and select the extracted folder's package.json. Or copy Runtime/'s contents straight into your project's Assets/ folder.

Quick start — validate

using PermitCore;
using UnityEngine;

public class LicenseGate : MonoBehaviour
{
    private PermitCoreClient _client;

    async void Start()
    {
        _client = new PermitCoreClient("https://api.permitcore.dev");
        var result = await _client.ValidateAsync("PERMIT-XXXX-XXXX-XXXX-XXXX");

        if (!result.IsValid)
        {
            Debug.LogError("License invalid: " + result.Message);
            return;
        }

        if (result.HasFeature("pro"))
            EnableProFeatures();
    }
}

Activate (call once per installation)

var result = await _client.ActivateAsync(
    "PERMIT-XXXX-XXXX-XXXX-XXXX",
    deviceId: null,                    // auto-generated when omitted
    deviceName: SystemInfo.deviceName,
    version: Application.version);  // optional — enforces min/maxVersion

if (!result.IsValid)
    Debug.LogError("Activation failed: " + result.Message);

Metered billing

await _client.MeterAsync(licenseKey, "level_completed");

await _client.MeterAsync(licenseKey, "export", quantity: 5,
    meta: new Dictionary<string, object> { ["format"] = "png" });

Floating licenses

var session = await _client.CheckoutAsync(licenseKey);
if (!session.Success) { Debug.LogError("No seats available: " + session.Message); return; }

// Heartbeat every 4-5 minutes (e.g. from a coroutine or InvokeRepeating)
await _client.HeartbeatAsync(session.SessionToken);

// On quit / logout
await _client.CheckinAsync(session.SessionToken);

Offline license tokens

No extra package needed — System.Security.Cryptography.ECDsa is part of Unity's .NET Standard 2.1 surface on Desktop, Mobile, and Console targets.

// Pure local verification — no network call, never throws on Desktop/Mobile/Console.
var result = PermitCoreClient.VerifyOfflineToken(token, publicKeyBase64);
if (result.IsValid)
    Debug.Log("Valid! Product: " + result.Payload.ProductName);

// Bind to this device + persist locally (call once, e.g. at install time)
var activated = _client.ActivateOffline(token, publicKeyBase64, deviceId);

// On every later launch — no token needed, reads the local cache
var cached = _client.ValidateOffline(deviceId);

Hardware ID

// Default: a random id persisted to a local file — works identically on every platform.
string hwid = _client.GetHardwareId();

// Unity-idiomatic alternative, recommended on mobile/console:
string hwid = UnityHardwareId.Get(); // SHA-256 of SystemInfo.deviceUniqueIdentifier

LicenseResult reference

HasFeature(string feature) — case-insensitive feature check.