Skip to documentation
LITHIUM
Lithium knowledge base / v1

Understand the runtime. Ship the feature.

Start with a small addon, move shared behavior into services and connect packages through explicit contracts.

01

Getting started

Create a discoverable addon, own its lifecycle and keep package identity explicit from the first file.

Read guide
02

Addons

Addon is the smallest lifecycle boundary in Lithium — one manifest, one initialization path and an explicit teardown.

Read guide
03

Services

ComponentService keeps global-style systems inside the same scene and lifecycle model used by s&box.

Read guide
04

Configuration

Addon configuration loads before the addon lifecycle and persists changes in the addon's own data directory.

Read guide
Experimental

Events

Lithium's experimental event API discovers callable endpoints and listeners in the active scene without direct references between packages.

Read guide
06

Addon

Base class for a Lithium addon.

Read guide
07

Migrate from v0 to v1

Upgrade a pre-1.0 Lithium addon to the current lifecycle, configuration and service contracts.

Read guide
08

Addon<TConfig>

An addon backed by a strongly typed, persistent configuration.

Read guide
09

AddonAttribute

Declares the package identity and display name of a Lithium addon.

Read guide
10

AddonConfig

Base settings shared by configurable addons.

Read guide
11

AddonDependency

Describes another addon required or optionally used by an addon.

Read guide
12

AddonManifest

Runtime metadata used to initialize and order a Lithium addon.

Read guide
13

AddonManifestExtensions

Convenience queries for addon manifest dependencies.

Read guide
14

IAddonManifestInfo

Common identity fields shared by addon declarations and runtime manifests.

Read guide
Experimental

Event

Provides named calls and events between addons. Instance handlers are limited to components in the target scene. Static handlers are discovered through Sandbox.Internal.TypeLibrary.

Read guide
Experimental

CallableAttribute

Marks a component or static method as callable by another addon through Call(string, object[]).

Read guide
Experimental

ListenerAttribute

Marks a component or static method as a listener for a named event.

Read guide
Experimental

PropagateAttribute

Emits the named event after the decorated method completes successfully.

Read guide
Experimental

EventCodeGenerator

Public compiler bridge used by generated addon code. Event dispatch logic remains internal to Event.

Read guide
20

ComponentService

A component that will be automatically registered by the ComponentServiceManager and added into the Scene.

Read guide
21

IComponentServiceEvent

Scene event contract notified after a component service is mounted.

Read guide