Extending HoloMUSH
Build plugins that add game mechanics, integrate external services, or shape how the world works. HoloMUSH supports two plugin runtimes — both use the same event-driven model.
Plugin Types
Section titled “Plugin Types”| Type | Language | Best For | Compilation |
|---|---|---|---|
| Lua | Lua 5.1 | Simple scripts, rapid iteration | None |
| Binary | Go | Complex logic, external APIs | Required |
Both types work the same way: your plugin subscribes to events (like a character speaking or moving) and can emit new events in response. The server handles delivery, ordering, and access control.
Tutorials Build your first plugin step by step — Lua and binary walkthroughs.
How-to guides Register verbs, write policies, handle errors, and configure plugins.
Reference Plugin API, manifest schema, actor kinds, and substrate contract.
Explanation The rules plugins can rely on and the boundaries they must not cross.
Start here → Getting Started with Plugins
Example Plugins
Section titled “Example Plugins”The plugins/ directory in the repository contains working examples you can use as starting points.