Ex Apeirou Studios — Caelestris Server
Extension Architecture

Built to Extend

Extensions shouldn't mean downtime, and they shouldn't break on the next update. Caelestris is designed so mods snap in — and out — cleanly, backed by stable APIs that don't move under you.

🔌

Hot-Pluggable. Removable.

Add a mod while the server is running. Pull it back out the same way. No restart, no downtime, no players kicked to a loading screen — capabilities that come and go on a live world instead of a maintenance window.

That's a genuinely hard thing to do well, and it's a defining goal of the Caelestris extension model: every mod loads in isolation and unloads cleanly, so removing one leaves the rest of your world untouched.

Planned

A server you can't extend safely isn't really extensible. Caelestris treats extension as a first-class concern: mods that load and unload on a live server, stable, versioned APIs so what you build keeps working, and clean isolation so one mod can never quietly take down another.

What "Built to Extend" Means

The principles behind the extension model.

🔄

Load & Unload Live

Mods attach and detach while the world runs — iterate in minutes, not restart cycles.

Planned capability
🧷

Clean Removal

Pulling a mod releases its resources and leaves everything else exactly as it was.

Planned capability
📐

Stable, Versioned APIs

Extension points are versioned and supported, so a mod written today survives tomorrow's update.

Planned capability
🧯

Isolation by Design

Each mod runs behind clear boundaries — a fault in one doesn't cascade into the rest.

Built on the no-fallback model

Two Ways to Extend

Reach for raw performance or rapid iteration — or both, side by side.

⚙️
Native · Compiled

Binary Plugins

Compiled extensions that run at native speed, for the systems where every microsecond counts — physics, generation, custom protocols.

  • Full-performance native code
  • Direct access to core systems
  • For heavy, hot-path logic
Planned
📝
Scripted · Iterative

Scripted Mods

Lightweight, fast-to-write extensions for gameplay and content, where iteration speed matters more than raw throughput.

  • Rapid, low-friction authoring
  • Ideal for gameplay & content
  • Safe, sandboxed surface
Planned

Why the Foundation Makes It Possible

Hot-pluggable extension isn't bolted on later — it's what the current architecture is built to allow.

🧩

Dependency Injection Throughout

Every subsystem receives its dependencies rather than reaching for globals — the seam that lets new components slot in cleanly.

Core architecture today
🧱

Subsystem Model

The server is a set of well-bounded subsystems that validate their dependencies and start or fail explicitly — the same discipline an extension plugs into.

Core architecture today
⛰️

Modded Content Is First-Class

The terrain pipeline is explicitly designed to accept modded content as a source of world material, alongside importers and procedural generators.

In the terrain design today
🎛️

Configuration-Driven

Behaviour is governed through a central configuration subsystem, so extensions can be switched on, tuned, and gated without code changes.

Core architecture today
🛡️

No Silent Degradation

Systems either run at full performance or fail loudly with diagnostics — so a misbehaving mod surfaces immediately instead of rotting quietly.

Core architecture today
🗄️

Portable Persistence

A database abstraction spanning many backends means extensions store their state without binding your game to one vendor.

Core architecture today

The dependency-injected subsystem architecture, configuration system, no-fallback discipline, and portable persistence exist in Caelestris today and are what make safe extension achievable. The plugin and mod loader, hot-plug lifecycle, and versioned extension APIs are on the roadmap — this page describes where that foundation is heading.

Extend Without Fear

Caelestris Server is currently in development. Join our early look program and help shape an extension model built to last.

Tell me more !