shmup/mud
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
python mudlib using telnetlib3
437 commits 57 branches 0 tags 4.3 MiB
Python 99.9%
Find a file
Jared Miller 37d1c86b34
Delete trivial constructor and property tests 
Removed 32 tests that only verified constructor args are stored as
properties. Type annotations and behavioral tests already cover this.
2026-02-16 16:10:38 -05:00
.claude Improve doc discovery 2026-02-11 21:47:05 -05:00
content Update combat TOML schema 2026-02-16 12:17:28 -05:00
docs Update combat docs to match 3-state machine and correct field names 2026-02-16 14:48:39 -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 Delete trivial constructor and property tests 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/