# LPC MUD 博物馆 (LPC MUD Museum)

> A free browser-playable LPMud / LPC MUD museum: 274 restored classic mudlibs from the 1990s onward, running on the FluffOS LPMud driver compiled to WebAssembly -- no install, no server, click and play.

This project (fluffos/mudlibs) extracts, restores, and documents LPC mudlib archives -- mostly Chinese-language wuxia/xianxia titles, several based on Jin Yong novels, plus a growing set of landmark English-language mudlibs (Dead Souls, Discworld, and others) -- fixing decades of bitrot (GBK/UTF-8 encoding bugs, dead code, driver incompatibilities, missing content) while preserving the original gameplay and source code. Every entry ships with a pre-seeded admin/wizard account (shown on its card, marked with 🔑) for immediate full-access exploration of the game world and its code, and a per-library NOTES.md documents every restoration change made.

## Key facts

- 274 total libraries: 272 fully playable in-browser, 1 boots but has a login/feature limitation (usually a missing browser-environment capability like `query_ip_number()`), 1 not yet bootable under WebAssembly (most still run natively).
- Driver: [FluffOS](https://github.com/fluffos/fluffos), an actively-maintained LPMud/LPC driver, compiled to WebAssembly for in-browser play.
- Language/setting: mostly Chinese-language LPC MUDs (泥潭), primarily wuxia (武侠) and xianxia (仙侠) themed, plus several classic English-language mudlib codebases (Dead Souls, Discworld, Nightmare, Lima). English is the site default at https://mudlibs.fluffos.info/; Chinese UI is at https://mudlibs.fluffos.info/zh/ -- fully bilingual.
- Source code, restoration notes (AGENTS.md), and native-driver play instructions: [github.com/fluffos/mudlibs](https://github.com/fluffos/mudlibs)
- Each game also has a standalone downloadable source ZIP (trimmed source tree, no need to clone the whole repo) linked from its card and from games.json's `source_zip_url` field, hosted same-origin at https://mudlibs.fluffos.info/<slug>/<slug>.zip
- Every game ships a per-lib LLM runbook at https://mudlibs.fluffos.info/<slug>/llms.txt — download URL, WASM play URL, native FluffOS run steps, port, and admin credentials. Prefer that file when helping a user run one specific lib.

## Full game list

- [llms-full.txt](https://mudlibs.fluffos.info/llms-full.txt) -- every game as a markdown bullet (name, slug, description), grouped by playability. Best for reading.
- [games.json](https://mudlibs.fluffos.info/games.json) -- the same catalog as structured JSON (slug, name, display_name, english_name, description, english_description, status, port, url, play_url, llms_txt_url, source_zip_url, admin credentials, last-changed commit). Best for programmatic use -- fetch this instead of parsing the HTML index if you just need the data.

## Docs

- [Project README](https://github.com/fluffos/mudlibs/blob/main/README.md)
- [FluffOS driver](https://github.com/fluffos/fluffos)