# immaster (菜鸟飞天传) / immaster (a MudCore-framework LPC tutorial mudlib)

> slug: `immaster` · browser status: `playable` · native port: `40242`

A small, real Chinese-language LPC learning project built on 'MudCore', a modern (2019-2020) FluffOS-native engine framework (github.com/oiuv/mudcore) that immaster's own README describes as 'ongoing building of the mudlib, as a learning project'. immaster itself supplies only the thin content layer: a short outdoor/indoor tutorial map (game/world/tutorial/ -- start room, courtyard, backyard, forest, stream, waterfall, cave, tomb, cliff, treehouse, a random-maze-capable dungeon system, ~12 rooms total) plus a couple of player commands (help, test); MudCore supplies the actual account/login/registration flow, save/restore, room/movement/action dispatch, wizard tools, and a set of daemons (combat, chat/emote, virtual-object/maze, database, time-of-day, Chinese-name validation). There is no combat content, no NPCs, and no items in this specific archive -- the tutorial world is pure exploration -- and this is the archive's genuine, intentional scope, not a conversion gap: MudCore's own combat/NPC/item primitives compile and are fully present in the engine layer, immaster's game/ layer simply never uses them yet (an in-progress learning project, per its own README). Login uses a real account (English login ID) + password + Chinese character-name + gender registration flow, with save/restore verified to survive a real driver restart. A hardcoded engine account name (getuid()=="teamug") is automatically granted wizard privileges on login -- register with that id to get wizard commands (eval, whoami, update, dump, etc.), no separate seeding step needed.

## Play in the browser (WebAssembly)

- Landing page (description + notes): https://mudlibs.fluffos.info/immaster/
- Play now (boots the WASM driver): https://mudlibs.fluffos.info/immaster/play.html

## Download source ZIP

- Same-origin ZIP (trimmed source tree, no need to clone the whole repo):
  https://mudlibs.fluffos.info/immaster/immaster.zip
- GitHub tree: https://github.com/fluffos/mudlibs/tree/main/libs/immaster
- README: https://github.com/fluffos/mudlibs/blob/main/libs/immaster/README.md
- Restoration notes (NOTES.md): https://github.com/fluffos/mudlibs/blob/main/libs/immaster/NOTES.md

## Run natively with FluffOS

1. Build a current FluffOS driver from https://github.com/fluffos/fluffos
   (native `build` / `build-debug`; see that repo's docs).
2. Download and unzip `immaster.zip` from the URL above (or clone
   `https://github.com/fluffos/mudlibs` and use `libs/immaster/`).
3. From the unzipped lib directory, ensure `config.fluffos` points
   `mudlib directory` at this tree (the checked-in file may contain a
   maintainer-local absolute path — edit it to your extract path).
4. Start the driver:

```bash
/path/to/fluffos/build/src/driver config.fluffos
```

5. Connect a UTF-8 MUD client to `127.0.0.1:40242`.

- Admin / wizard login: see this lib's README (no seeded account recorded)
- If you host this on a public network, change the published default
  admin password before opening the port.

## Machine-readable catalog

- Site-wide catalog: https://mudlibs.fluffos.info/games.json
- Site-wide LLM overview: https://mudlibs.fluffos.info/llms.txt
- This file: https://mudlibs.fluffos.info/immaster/llms.txt