Plugin SDK (C++ legado)
A ABI de plugins C++/ImGui, serviços do host e registo de painéis usados pelo host legado.
Host legado. O Doppio ativo em Rust/Iced não carrega plugins C++.
Estas páginas documentam o SDK C++/ImGui e o seu host em
caffeine-runtime / doppio-archived. A engine continua a
compilar todos os plugins do submódulo para manter o SDK testado.
O SDK de plugins destina-se ao host C++/ImGui em caffeine-runtime / Doppio C++ arquivado. O Doppio ativo em Rust/Iced não carrega estas bibliotecas. O código-fonte vive no submódulo separado doppio-plugins.
Architecture#
┐ │ Doppio (core IDE) │ │ Scene editor, viewport, hierarchy, inspector, assets │ │ PluginManager + PluginServiceRegistry (empty at start) │ │ NO terrain/procedural/post-process/git UI in core │ └ │ PluginHostApi (dlopen) ┐ ▼ ▼ ▼ terrain_plugin procedural_tools_plugin git_plugin (owns TerrainBridge) (owns ProceduralBridge) (owns GitRunner)
Rules#
- Plugins own their logic — bridges, panels, services live in
.sofiles, not indoppiosources. - Core owns ECS + runtime —
PostProcessComponent,TerrainComponent, procedural systems are engine data/runtime; editor UI for them is plugin territory. - Service registry is generic — plugins call
registerServiceinOnLoad; Doppio never hardcodes feature services. - Plugins vivem no submódulo — o CMake da engine compila todos os plugins de
doppio-pluginsparabuild/plugins, mas o código-fonte nunca vive na árvore da engine. UseCAFFEINE_BUILD_DOPPIO_PLUGINS=OFFpara um build sem plugins. - Carregamento opt-in — nada é pré-carregado no arranque. As bibliotecas descobertas ficam desativadas até o utilizador as ativar em Plugins → Plugin Manager; a escolha é guardada em
~/.config/caffeine/plugins.cfg.
Instalar plugins#
A configuração normal da engine já compila os plugins do submódulo para
build/plugins:
./scripts/submodules.sh
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
Para compilar o repositório de plugins contra outra engine, aponte-o ao SDK:
cmake -S doppio-plugins -B doppio-plugins/build \
-DCAFFEINE_ROOT=/caminho/para/caffeine \
-DIMGUI_DIR=/caminho/para/caffeine/build/_deps/imgui-src
cmake --build doppio-plugins/build -j
cp doppio-plugins/build/plugins/*.so build/plugins/
Depois abra Plugins → Plugin Manager e ative apenas os plugins necessários.
Plugin catalog (reference)#
| Plugin | Purpose |
|---|---|
hello_plugin |
Minimal SDK example |
terrain_plugin |
Ultra-realistic terrain generator (Node.js) |
procedural_tools_plugin |
Modular procedural streaming tools |
post_processing_plugin |
Post-process effect stack UI |
git_plugin |
Optional Git project management |
ai_development_plugin |
NPC navigation and behaviour authoring |
Host API#
See include/caffeine/plugin/PluginAPI.hpp:
registerPanel,registerMenuAction,registerComponentDrawerregisterService/invokeServicegetProjectRootPath,getActiveWorld,markSceneDirty
Services (cross-plugin)#
Plugins may expose services for aggregators / stores:
| Service | Owner plugin |
|---|---|
terrain.generateUltra |
terrain_plugin |
terrain.importHeightmap |
terrain_plugin |
procedural.* |
procedural_tools_plugin |
Inspector drawers#
Plugins register component drawers via registerComponentDrawer. Doppio Inspector delegates to registered drawers (e.g. Post Process shows plugin UI when plugin is loaded).
Writing a plugin#
#include "caffeine/plugin/PluginAPI.hpp"
class MyPlugin : public Caffeine::Editor::IPlugin {
void OnLoad() override {
m_host->registerPanel(m_host->editorContext, GetName(), "My Panel", &render, this);
}
// ...
};
extern "C" CAFFEINE_PLUGIN_API Caffeine::Editor::IPlugin* CreatePlugin(
const Caffeine::Editor::PluginHostApi* host) {
return new MyPlugin(host);
}
Build as SHARED library with CAFFEINE_PLUGIN_EXPORTS=1, output to plugins/.