shmup/mud
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
python mudlib using telnetlib3
455 commits 57 branches 0 tags 4.3 MiB
Python 99.9%
Find a file
Jared Miller f450952e04
Add admin help topics for building, spawning, editing, content, and commands
2026-02-16 16:45:47 -05:00
.claude Improve doc discovery 2026-02-11 21:47:05 -05:00
content Add admin help topics for building, spawning, editing, content, and commands 2026-02-16 16:45:47 -05:00
docs Update index.rst with new system documentation 2026-02-16 16:31:34 -05:00
scripts Add bulk book import script 2026-02-14 12:39:48 -05:00
src/mudlib Validate timing fields per move type in load_move 2026-02-16 14:49:09 -05:00
tests Strengthen loose assertions in test suite 2026-02-16 16:10:38 -05:00
worlds/earth Add seed-based terrain world with movement and viewport 2026-02-07 13:27:44 -05:00
.dockerignore Add a docker container solution 2026-02-09 12:34:56 -05:00
.gitignore Re-copy fixed repos/zvm source into src/mudlib/zmachine 2026-02-09 20:44:21 -05:00
AGENTS.md Add a top level redirecting agent config 2026-02-15 10:49:38 -05:00
BRAINSTORM.txt Add brainstorm note about player safety 2026-02-14 11:13:29 -05:00
compose.yml Add a docker container solution 2026-02-09 12:34:56 -05:00
demo_terrain.py Add seed-based terrain world with movement and viewport 2026-02-07 13:27:44 -05:00
Dockerfile Add a docker container solution 2026-02-09 12:34:56 -05:00
DREAMBOOK.md Add a dreambook 2026-02-07 12:19:49 -05:00
justfile Strip dfrotz prompt even without preceding newline 2026-02-09 17:55:14 -05:00
LICENSE.txt Add anti-capitalist license 2026-02-15 10:41:50 -05:00
mud.tin Fix tintin aliases 2026-02-15 15:02:10 -05:00
pyproject.toml Add YAML map import script with tests 2026-02-14 12:39:48 -05:00
README.md Add anti-capitalist license 2026-02-15 10:41:50 -05:00
uv.lock Add YAML map import script with tests 2026-02-14 12:39:48 -05:00

README.md

mudlib

a telnet MUD engine

built on telnetlib3, python 3.12+, managed with uv.

Quickstart

uv sync
just run

then connect: telnet localhost 6789

Commands

just check   # lint + typecheck + test
just run     # start the server
just debug   # start with debug logging
just render  # generate world map HTML

What's in here

  • src/mudlib/ — the engine (commands, world, combat, rendering, storage)
  • tests/ — pytest tests
  • worlds/ — world definitions (yaml/toml)
  • docs/ — internal knowledge base
  • DREAMBOOK.md — vision and wild ideas

License

https://anticapitalist.software/