This release is a pre-release and may not be stable for production use.
MudGym
A Gymnasium reinforcement learning environment for MUD2. One of the first online multiplayer text adventure games.
Setup
A Docker engine is required to run the game. The image ghcr.io/rolo/mudgym is pulled automatically on first use.
Install MudGym from PyPI:
uv add mudgym
Quickstart
from mudgym import make_env
env = make_env(observation="parsed")
observation, info = env.reset()
observation, reward, terminated, truncated, info = env.step("howl")
print(observation["room_name"], reward)
env.close()
Docs
See the docs for more examples.
License
The Python code and tooling in this repository are made available under the MIT License.
Permission to use the MUD2 game for research purposes has been provided by Richard Bartle, with kind thanks. The MUD2 game, name, source code, and associated story remain the intellectual property of Richard Bartle and Roy Trubshaw and may not be used for commercial purposes.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mudgym-0.3.0b1.tar.gz.
File metadata
- Download URL: mudgym-0.3.0b1.tar.gz
- Upload date:
- Size: 68.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2f6efb83cb5800236bc1a7c06668a81e8a813eea4b5afe1cf973268fec356fd4
|
|
| MD5 |
e591ed058c091c1dee0d122a7acf081f
|
|
| BLAKE2b-256 |
d31f42744e8b172bd66849faebadf9e3919babaf615f04793028485c419a3093
|
File details
Details for the file mudgym-0.3.0b1-py3-none-any.whl.
File metadata
- Download URL: mudgym-0.3.0b1-py3-none-any.whl
- Upload date:
- Size: 86.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
180c77a4a2c6c5b3de4f68f5eae9d13ef5bcb39760ec90e80aaf652a538ea627
|
|
| MD5 |
f86310cbbacbf4e1dfe88c18e85aa9b7
|
|
| BLAKE2b-256 |
79b7373700787d75301a79bd0259d6762c2608371cbfd902fb2f6dedec022ab9
|
