feat/plugins

Cargo.toml

@@ -7,7 +7,12 @@ members = [
     "pomme-block",
     "pomme-protocol",
     "tools/blockgen",
-    "tools/protogen"
+    "tools/protogen",
+
+    "plugin-api",
+    "plugin-loader",
+    "plugin-macros",
+    "plugin-example",
 ]
 
 [workspace.dependencies]
@@ -28,7 +33,14 @@ glam = "0.33"
 # client
 pyronyx = "=0.3.2"
 tracing = "0.1"
-tracing-subscriber = "0.3"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+tracing-shared = "0.1"
+
+plugin-api = { path = "./plugin-api" }
+plugin-loader = { path = "./plugin-loader" }
+plugin-macros = { path = "./plugin-macros" }
+
+stabby = "=72.1.16"
 
 # azalea lags crates.io releases; track the 26.2 branch from git.
 # azalea-block is replaced by the pomme-block shim (pomme owns block data);

justfile

@@ -13,6 +13,7 @@ launcher-pre-pr:
     @pnpm --filter pomme-launcher pre-pr
 
 client-dev *args:
+    @cargo build -p plugin-example
     @cargo run -p pomme-client {{ args }}
 
 # Optimized release client for accurate benchmarking (supplies the launch token the guard needs).

plugin-api/Cargo.toml

@@ -0,0 +1,9 @@
+[package]
+name = "plugin-api"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+stabby.workspace = true
+tracing-shared.workspace = true
+plugin-macros.workspace = true

plugin-api/src/lib.rs

@@ -0,0 +1,52 @@
+use stabby::boxed::Box;
+use stabby::dynptr;
+use stabby::str::Str;
+
+pub mod meta;
+
+pub use plugin_macros::plugin;
+pub use stabby;
+
+use crate::meta::Version;
+
+pub trait Plugin {
+    fn new() -> Self;
+
+    fn on_client_started(&mut self) {}
+    fn on_client_stopping(&mut self) {}
+
+    fn on_client_tick_start(&mut self) {}
+    fn on_client_tick_end(&mut self) {}
+}
+
+#[stabby::stabby]
+pub trait SPlugin {
+    extern "C" fn on_client_started(&mut self);
+    extern "C" fn on_client_stopping(&mut self);
+
+    extern "C" fn on_client_tick_start(&mut self);
+    extern "C" fn on_client_tick_end(&mut self);
+}
+
+impl<T: Plugin> SPlugin for T {
+    extern "C" fn on_client_started(&mut self) {
+        <Self as Plugin>::on_client_started(self);
+    }
+    extern "C" fn on_client_stopping(&mut self) {
+        <Self as Plugin>::on_client_stopping(self);
+    }
+
+    extern "C" fn on_client_tick_start(&mut self) {
+        <Self as Plugin>::on_client_tick_start(self);
+    }
+    extern "C" fn on_client_tick_end(&mut self) {
+        <Self as Plugin>::on_client_tick_end(self);
+    }
+}
+
+#[stabby::stabby]
+pub struct PluginModule {
+    pub name: Str<'static>,
+    pub version: Version,
+    pub plugin: dynptr!(Box<dyn SPlugin>),
+}