Service registry
Legacy host. The active Rust/Iced Doppio does not load C++ plugins.
These pages document the C++/ImGui plugin SDK and its host in the archived C++ editor
(doppio-archived/). The engine still builds every plugin from the submodule
so the SDK stays compile-tested.
Named request/response handlers let one plugin call another, or a host capability, without linking the two together.
The legacy C++ host provides a generic service registry. Plugins register named
handlers; any code (host or other plugins) can call invokeService.
This avoids hardcoding feature bridges inside the editor core.
Architecture#
text
┌──────────────┐ registerService ┌─────────────────┐
│ terrain_plugin│ ──────────────────────► │ PluginService │
└──────────────┘ │ Registry │
└────────┬────────┘
┌──────────────┐ invokeService │
│ other plugin │ ◄────────────────────────────────┘
└──────────────┘
Well-known services#
Defined in include/caffeine/plugin/PluginServices.hpp:
Terrain#
| Service | Request | Response |
|---|---|---|
terrain.generateUltra |
TerrainGenerateUltraRequest |
— |
terrain.importHeightmap |
TerrainImportHeightmapRequest |
— |
Procedural streaming#
| Service | Request | Response |
|---|---|---|
procedural.installScripts |
— | — |
procedural.createStreamingSetup |
ProceduralStreamingSetupRequest |
ProceduralSetupResponse |
procedural.loadBenchmark |
ProceduralLoadBenchmarkRequest |
ProceduralSetupResponse |
Registering a service#
cpp
bool myHandler(void* editorContext, const void* request, std::size_t requestSize,
void* response, std::size_t responseSize) {
// parse request, fill response
return true;
}
void OnLoad() override {
m_host->registerService(m_host->editorContext, GetName(),
"myplugin.export", &myHandler);
}
Invoking a service#
cpp
MyRequest req{};
MyResponse resp{};
m_host->invokeService(m_host->editorContext, "terrain.generateUltra",
&req, sizeof(req), &resp, sizeof(resp));
Guidelines for new services#
- Use dot-separated names:
vendor.feature.action(e.g.acme.navmesh.bake) - Document struct layouts in your plugin README — they are plain C structs, not versioned wire format
- Return
falseon unknown request size or invalid state - Keep handlers fast; offload heavy work to background jobs inside your plugin
Owner plugins#
| Service prefix | Owner |
|---|---|
terrain.* |
terrain-generator |
procedural.* |
procedural-tools |