# Spacemud / Spacemud

> slug: `spacemud` · browser status: `playable` · native port: `40259`

A space-themed fork of the LIMA Mudlib (the same FluffOS reference framework already onboarded standalone as libs/lima) that keeps Lima's engine -- natural-language command parsing ('take the red potion from the box'), capability-based security, Unix-like wizard shell -- but swaps its fantasy wizard's-guildhall demo world for a decaying, nine-floor space station called Omega. A fresh character wakes up there and can wander its maintenance corridors, waiting rooms, and a domed Stargate Terminal (a pulsating circular teleport platform under a star-filled skylight) run by chief landing controller Aria Voss and a small cast of named station staff (Doc Green, Doc Williams, Rigel Fluxx, Zara Nebulon, Max Nova); the Yakitori delivery guild runs its own chef/cashier counter selling skewer snacks, tech gremlins and space roaches skitter the lower decks, and a lunar lurker mob and salvageable hyperspace hoodie armour round out Omega's authored content. Underneath the station sits a from-scratch procedural-universe layer (space_d/ship_d/spacestation_d/proc_gen_d) that generates star systems and planets at first boot -- Greek-alphabet naming conventions, gravity/mass/radius stats -- meant to support the game's real ambition per its own README: fly a purchased spacecraft, haul and sell goods, dock at stations, and eventually manage planet-side corporations, layered on top of a genuine crafting/salvage system (break weapons and armour into scrap metal, cloth, and plastics at any workbench). The parallel domains/pinto directory is not spacemud's own content -- it's LimaLib's official docs.limalib.dev tutorial reference code (a single swamp room and a swan NPC), bundled for readers following the upstream learning path rather than a second game area. First character auto-granted wizard/admin per Lima's own documented AUTO_WIZ convention.

## Play in the browser (WebAssembly)

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

## Download source ZIP

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

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