Developer Guide¶
This section covers everything you need to build plugins and extend HoloMUSH.
Overview¶
HoloMUSH supports two plugin systems:
| Type | Language | Use Case | Performance |
|---|---|---|---|
| Lua | Lua 5.1 | Simple scripts, rapid iteration | Fast |
| Binary | Go | Complex logic, external APIs | Fastest |
Both plugin types use the same event-driven architecture: plugins subscribe to events and can emit new events in response.
Getting Started¶
- Understand the Architecture - Learn how HoloMUSH components interact
- Set Up Your Environment - Clone the repository and build the server
- Build Your First Plugin - Follow the plugin guide to create a simple handler
Documentation Sections¶
Architecture¶
- System Architecture - Core components and data flow
- Coding Standards - Go idioms and conventions
- PR Guide - Contributing workflow
Plugin Development¶
- Plugin Guide - Complete guide to building plugins
- Host Functions - Functions available to plugins
Advanced Topics¶
- ABAC Authorization - Attribute-based access control
- Testing Plugins - Unit and integration testing
Example Plugins¶
The plugins/ directory
contains example plugins:
- echo-bot - Echoes messages back (Lua)