The mod SDK
The mod SDK is everything needed to write, check, build and load a code mod for one exact game build. Each build that has one publishes it as one signed release, tag sdk-<build id>, where the build id is the game's full commit sha. People see builds by their Nightly names: nightly-2026-11-13 (afe471c), or the short sha for a build no Nightly shipped.
From Sunrise's modding bookead8a1e
- A mod author's project holds the small part of it: the API crates, with their generated code already written out, in
.sunrise/sdk/.cargo sunrise-modfetches and verifies it there (In a mod project); no clone of the game and no generator run. - The launcher fetches the compiled part a build needs on the player's computer, after the same checks (What the launcher does).
- Tools outside Sunrise read
sdk.json, check the signature, then readsurface.jsonand the build data. They need no source tree.
A mod is made for one build, the one it pins. A mod on the mod API alone also fits every other build where nothing it uses changed, and the launcher compiles it there (Fitting another build).
Edit this page on GitHub · Spotted something wrong? Open an issue or ask on Discord.



