Build for Aether
Build a game system, content module, or capability-gated mod against the contracts Aether runs today.
Aether is a game-agnostic tabletop platform. The engine supplies documents, scenes, permissions, rolls, automation, and sandbox boundaries. A package supplies the game vocabulary or the optional feature.
Code-extension guides currently use the Aether source checkout because the @aether/* packages and
the aether CLI are private workspace packages. Portable Soundscape packages use a separate browser
path: export from a world, then publish through Creator Studio with a signed-in Aether account.
#Choose the extension surface
| You want to build | Use | Current distribution |
|---|---|---|
| A game's document types, native sheets, initiative, and automation | system | source checkout and host registration; one active system per world |
| Reusable types, documents, and assets | module or content pack | source checkout and host composition |
| A panel, scene tool, chat command, or other engine extension | mod | sandboxed app installed from a local manifest |
| Cues, groups, sequences, layers, and their audio | Soundscape package | export from a world; publish through Creator Studio |
Systems currently reach a world through source checkout and host registration. Marketplace system installation is a separate future distribution path.
#Start with a running system
Build your first system scaffolds a package, registers it with the local CLI, creates a world, and runs that world in the browser. The guide uses only commands that exist in this repository.
#Publish a Soundscape from the browser
Export and publish Soundscape packages starts in a world where you are the GM, carries the audio and definitions into one portable file, and finishes in Creator Studio. The guide uses the signed-in product interface from export through Marketplace publication.
#Learn the contracts
- Documents and schemas explains document identity, validation, defaults, and capabilities.
- Native sheets uses the same declarative renderer as Aether's built-in sheets.
- Rolls and expressions separates deterministic formulas from server-authoritative roll results.
- Permissions and projection shows why a client can only read the fields the server projects for that member.
The maintained examples page maps each surface to an exact package, source file, and verification command.