b80d1fd4ed
Implement RFC 6455 Sec-WebSocket-Protocol negotiation for Evennia's WebSocket server, following the MUD Standards WebSocket specification (https://mudstandards.org/websocket/). New subprotocols: - json.mudstandards.org: JSON envelope format with structured OOB - gmcp.mudstandards.org: GMCP over WebSocket (TEXT + BINARY frames) - terminal.mudstandards.org: Raw ANSI/UTF-8 in BINARY frames Architecture: Wire format strategy pattern via composition. A single WebSocketClient delegates encoding/decoding to a WireFormat instance selected during onConnect(). Adding a new format means adding a single file to the wire_formats/ package with zero changes to webclient.py. Backward compatibility: Clients that send no Sec-WebSocket-Protocol header (including the built-in Evennia webclient) get v1.evennia.com format automatically. Existing behavior is fully preserved. Additional changes: - Extract shared GMCP encode/decode into gmcp_utils.py (used by both telnet and websocket GMCP paths) - Add WEBSOCKET_SUBPROTOCOLS setting for server-side format control - Built-in JS webclient now sends Sec-WebSocket-Protocol: v1.evennia.com - Comprehensive test suite for all wire formats (~870 lines) |
||
|---|---|---|
| .github | ||
| bin | ||
| docs | ||
| evennia | ||
| .flake8 | ||
| .gitignore | ||
| .release.sh | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CODING_STYLE.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| INSTALL.md | ||
| LICENSE.txt | ||
| Makefile | ||
| pyproject.toml | ||
| README.md | ||
| SECURITY.md | ||
| setup.py | ||
Evennia MUD/MU* Creation System 
Evennia is a modern library for creating online multiplayer text games (MUD, MUSH, MUX, MUCK, MOO etc) in pure Python. It allows game creators to design and flesh out their ideas with great freedom.
Evennia does not impose a particular style, genre or game mechanic. Instead it solves the boring networking and basic stuff all online games need. It provides a framework and tools for you to build the game you want. Coding in Evennia is done using normal Python modules imported into the server at runtime.
Evennia has extensive documentation. It also has a very active community with discussion forums and a discord server to help and support you!
Installation
pip install evennia
(windows users once: py -m evennia)
(note: Windows users with multiple Python versions should prefer `py -3.11` instead of `python` when creating virtual environments)
evennia --init mygame
cd mygame
evennia migrate
evennia start / stop / reload
See the full installation instructions for more help.
Next, browse to http://localhost:4001 or use your third-party mud client to
connect to localhost, port 4000 to see your working (if empty) game!
A game website is created automatically. Connect to your Evennia game from your
web browser as well as using traditional third-party clients.
Where to go next
If this piqued your interest, there is a lengthier introduction to read. You can also read our Evennia in pictures overview. After that, why not check out the Evennia Beginner tutorial.
Welcome!