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

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.

TutorialsBuild your first plugin step by step — Lua and binary walkthroughs.

How-to guidesRegister verbs, write policies, handle errors, and configure plugins.

ReferencePlugin API, manifest schema, actor kinds, and substrate contract.

ExplanationThe rules plugins can rely on and the boundaries they must not cross.

Start here → Getting Started with Plugins

Example Plugins

The plugins/ directory in the repository contains working examples you can use as starting points.