DjangoMOO
"LambdaMOO on Django"
DjangoMOO is a MOO server built on Python and Django. A MOO is a persistent online text world where objects — rooms, things, players — have properties and verbs (methods) that define how they behave. Those verbs are written in Python and run in a sandboxed execution environment, so the world itself is programmable by its inhabitants.
The design follows the LambdaMOO model where it makes sense: a parsed command line, verb dispatch through the caller's inventory and location, object inheritance, and a permission system. The implementation is independent — no MOO bytecode, no C — just Python and Django.
Documentation | GitLab | GitHub mirror | PyPI
What's included
- A LambdaMOO-inspired parser with full dobj/iobj preposition support
- Objects, Properties, Verbs, and a ManyToMany inheritance hierarchy backed by PostgreSQL
- A RestrictedPython verb sandbox with and integrated permissions system and extensive testing
- A default bootstrap world: rooms, exits, containers, players, a lighting system, in-world mail, and an object placement system
- Browser playable with no client required, or via plain SSH client
- Full support for MUDlet and other MUD clients using sshelnet helper
- Django admin for browsing and editing the world's objects, properties, and verb source
- Docker for self-hosting with
docker compose up
Quick Start
git clone https://gitlab.com/bubblehouse/django-moo
cd django-moo
docker compose up
Bootstrap the database and create your first wizard:
docker compose run webapp manage.py migrate
docker compose run webapp manage.py collectstatic
docker compose run webapp manage.py moo_init
docker compose run webapp manage.py createsuperuser --username wizard
docker compose run webapp manage.py moo_enableuser --wizard wizard Wizard
Connect at https://localhost/ and log in with the account you just created.
Interfaces
MUD Clients
A Mudlet package in extras/mudlet/ provides one-click
setup for MUD-client users. Mudlet has no native SSH support, so the package
bundles a managed sshelnet launcher
that bridges Mudlet's plain-TCP connection to the server's SSH port. It also
ships a setup wizard (dmsetup) and a generic-mapper bridge that subscribes
to GMCP Room.Info events and feeds them into Mudlet's bundled mapper.
The server speaks GMCP, MSSP, MSP, EOR, and CHARSET, so other clients (TinTin++, MUSHclient, Blightmud) work too, though without the bundled mapper integration, or automatic sshelnet setup. MXP is not implemented.
Web (WebSocket SSH)
The server is accessible through a browser-based SSH client at /. No SSH client needed.
SSH
Direct SSH access is also available.
ssh -p 8022 yourname@localhost
Hit Ctrl-D to disconnect.
Changing your password and managing SSH keys
Credentials are managed from inside the world with in-game verbs rather than the Django admin:
@password— interactively changes your password. Prompts for the old password, then the new one twice for confirmation. Wizards may leave the old password blank to perform an administrative reset.@keys— lists your currently registered SSH public keys.@add-key <public-key>— registers a new SSH public key. The key name is taken from the comment field automatically.@remove-key <index>— removes a key by its index from@keys.
Once a key is registered, reconnecting with ssh -p 8022 yourname@localhost
skips the password prompt.
Django Admin
A full Django admin interface is available at /admin for managing objects, properties,
verbs, and users.
Attributions
LambdaCore
This package is derived from the LambdaMOO and LambdaCore documentation, including the LambdaCore Programmer's Manual and the LambdaMOO Programmer's Manual. The code was written without reading the original LambdaCore source; it is an independent reimplementation based on documented behavior and conventions.
Various verbs have been modified from their LambdaCore equivalents to better fit a Pythonic
codebase: output uses print() rather than return values, property access follows Django ORM
patterns, and permission idioms have been updated to account for differences in how this
server dispatches verbs compared to LambdaMOO.
DjangoMOO could not have happened without the work of the following authors:
-
LambdaCore Database User's Manual (LambdaMOO 1.3, April 1991) Mike Prudence (blip), Simon Hunt (Ezeke), Floyd Moore (Phantom), Kelly Larson (Zaphod), Al Harrington (geezer)
-
LambdaCore Programmer's Manual (LambdaMOO 1.8.0p6, Copyright 1991) Mike Prudence (blip), Simon Hunt (Ezeke), Floyd Moore (Phantom), Kelly Larson (Zaphod), Al Harrington (geezer)
-
LambdaMOO Programmer's Manual (LambdaMOO 1.8.0p6, March 1997) Pavel Curtis (Haakon / Lambda)
1 maintainer
Release files for django-moo 1.14.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django_moo-1.14.2.tar.gz | 714.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_moo-1.14.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / django_moo-1.14.2.tar.gz
| Download URL | django_moo-1.14.2.tar.gz |
|---|---|
| Size | 714.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9f8984e870db356375a108bb6911d60f1545202e4d09e0a817256181cba3f0f7
|
|
BLAKE2b-256 checksum How to use checksums |
d6d134ded28f83f741b809b90aab9a31ea56f608e52b1b30a9af200b5b2b746d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / django_moo-1.14.2-py3-none-any.whl
| Download URL | django_moo-1.14.2-py3-none-any.whl |
|---|---|
| Size | 635.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d4bdea92158bf1fc2d70af3df8e92f75824984125b891f025b1b7f888668ea15
|
|
BLAKE2b-256 checksum How to use checksums |
88b9319b246ea624dd3826e0180c5652d6514518e7c1f7d8fbb2e17c1f22d5c2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
