MudForge plugins for Aardwolf.
This first release is two plugins: a GMCP hub, and a panel showing who and what is in the room with you.
These are plain .lua files. There is no installer and no build step. You copy
them into MudForge and load them.
| Plugin | What it does |
|---|---|
| AardForge Core 0.1.2 | Subscribes to Aardwolf GMCP, keeps a shared state snapshot, and publishes it to other plugins over an event bus. Provides the aardcore command. |
| Aardwolf Room 0.1.0 | Panel listing players, NPCs and objects in the current room, with click-to-target actions. Resolves NPC keywords from scan here. Provides the awroom command. |
Core is a prerequisite. Room looks for it when it loads and will say so if it is missing.
More AardForge plugins are in development and will be added as they are ready.
MudForge 1.2.2046. That is the version I test against. Older builds may work, but MudForge's Lua runtime has changed behavior between releases before, so I would treat anything else as untested rather than supported.
You also need an Aardwolf character with GMCP available. Core turns on the packages it needs when you connect.
The room panel additionally needs Aardwolf's roomchars, roomobjs and scan
tags. awroom setup shows you the command it wants to send and
awroom setup confirm sends it. See docs/INSTALL.md.
Copy both .lua files into MudForge and load Core first, then run
awroom setup.
docs/INSTALL.md has the full steps, including the Aardwolf tag setup and the command list for each plugin.
On MudForge 1.2.2046:
Aardwolf Room passes 166 of 166 cases in its model suite. A live look
produces exactly one automatic scan here, and the panel clears state properly
when the connection drops.
AardForge Core survives a reload while connected, and goes offline cleanly on disconnect.
Reloading Core while disconnected, and reloading Room on its own while connected, are both untested. See docs/KNOWN-ISSUES.md for those and the other rough edges. docs/COMPATIBILITY.md covers the MudForge runtime quirks the code is written around, which is worth reading if you plan to modify any of this.
Open an issue. Useful things to include: your MudForge version, which plugins
are loaded, and the output of aardcore status. For room panel problems, add
awroom status and the raw game output that produced the wrong result.
A shout-out to SeanStoves/aardwolf-mudforge. It was a useful reference while I was figuring out Aardwolf support in MudForge, especially around GMCP and how MudForge plugins behave in practice.
It's also worth checking out on its own. Sean's project covers a much broader set of Aardwolf features than AardForge currently does.
MIT, see LICENSE.