LootLocker C++ SDK

A pure C++ SDK for the LootLocker Game API, so a studio on an in-house engine, a middleware stack, or an engine we have no SDK for has a path to LootLocker.

Status: pre-release. The design is accepted and the scaffolding is in place; the features are being built. Nothing here is ready to ship against.

What it is

• C++17, source-only, MIT.
• No exceptions, no RTTI in the public contract.
• No internal threads by default. You call Update(); the SDK does a frame's worth of work and returns. A built-in scheduler exists for hosts with no loop of their own, and it is opt-in.
• Modular. One CMake target per feature module. There is no umbrella target: you name the modules you use, and a module depends on LootLocker::core and nothing else.

Requirements

• A C++17 compiler: MSVC 19.11+, GCC 7+, or Clang 4+.
• CMake 3.16+ if you use CMake. There is also a documented no-build-system path.

Using it

The SDK vendors nlohmann/json as a submodule, so clone recursively:

git clone --recursive https://github.com/lootlocker/cpp-sdk.git

Then:

add_subdirectory(third_party/cpp-sdk)

target_link_libraries(my_game PRIVATE
    LootLocker::auth
    LootLocker::broadcasts)

Only what you name is compiled and linked. To declare a subset of modules without add_subdirectory deciding for you, pass -DLOOTLOCKER_MODULE_ONLY="auth;broadcasts" — quoted, because an unquoted ; ends the cmake command on a POSIX shell.

What is in v1

Guest, white label and Steam authentication, plus broadcasts. Presence, offline mode, caching and the admin API are explicitly out of scope.

Platforms

Windows, Linux and macOS are verified by CI on every pull request.

Console support is not verified and must not be claimed. The PS5 and Switch toolchains need devkits, which we do not have. The SDK is designed for them — the transport is an injectable interface precisely so a console can supply its own — but "designed for" is not "tested on".

Documentation

The design decisions, the risk register and the public API sketch live in the index repo:

• specs-library/specs/discipline/sdk/cpp-sdk/README.md — the spec
• specs-library/specs/discipline/sdk/cpp-sdk/api-sketch.md — the public surface

Contributing

Feature branches come off dev and are rebased onto it, never merged into it. main is releases only. See AGENTS.md for the conventions this codebase enforces.

Licence

MIT. See LICENSE and NOTICE.