# Nightmare Residuum / Nightmare Residuum

> slug: `residuum` · browser status: `playable` · native port: `40237`

A from-scratch space-themed LPMud that takes only its name and thematic inspiration from the classic Nightmare Mudlib, distinct from this collection's `nightmare3`/`nightmare4` in both codebase and setting. A new arrival wakes in Origin, a small orbital station (a central chamber with corridors to a tank room, a nanite-injection vendor, and a transporter) whose android greeter walks them through a two-stage character-creation process: first a species choice, then a "tank" console where `download <class>` installs one of six classes -- warrior, mystic, scoundrel, ranger, psionist, or paladin -- and `encode`/`randomize` sets physical attributes before `done` finalizes the specimen and releases it into the world. Leaving the station via Origin's transporter pad drops a character onto Planet, a fully procedural surface generated live from Perlin/simplex noise: every coordinate computes its own biome, heat, humidity, and elevation on the fly (tropical rainforest, desert, tundra, and more), populated with wildlife (curious raccoons, feral cats, large ants, lurking vultures, plasma snails, rabid rats, watchful crows, wild dogs) to hunt or be hunted by. Architecturally the mudlib runs a genuine account/character split -- one login account can hold several independent characters, each with its own save file and its own class/level/stats/experience/defeat-count progression -- and drives its whole verb/command/ability layer through a custom dispatch registry rather than the driver's native `add_action()`. The very first character ever created on a fresh copy of the world is automatically granted immortal rank. The codebase ships its own in-game unit-test and code-coverage framework (`D_TEST`, invoked live via a `test` command) directly alongside the game content. English-language content.

## Play in the browser (WebAssembly)

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

## Download source ZIP

- Same-origin ZIP (trimmed source tree, no need to clone the whole repo):
  https://mudlibs.fluffos.info/residuum/residuum.zip
- GitHub tree: https://github.com/fluffos/mudlibs/tree/main/libs/residuum
- README: https://github.com/fluffos/mudlibs/blob/main/libs/residuum/README.md
- Restoration notes (NOTES.md): https://github.com/fluffos/mudlibs/blob/main/libs/residuum/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 `residuum.zip` from the URL above (or clone
   `https://github.com/fluffos/mudlibs` and use `libs/residuum/`).
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:40237`.

- 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/residuum/llms.txt