{"id":13337496,"url":"https://github.com/seisatsu/DennisMUD","last_synced_at":"2025-03-11T06:32:36.527Z","repository":{"id":44530114,"uuid":"149866129","full_name":"seisatsu/DennisMUD","owner":"seisatsu","description":"Dennis MUD - A multiplayer text adventure sandbox engine where the players build the world with in-game commands.","archived":false,"fork":false,"pushed_at":"2022-12-21T20:35:13.000Z","size":754,"stargazers_count":29,"open_issues_count":34,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2023-03-11T01:37:47.580Z","etag":null,"topics":["cli","collaborative-writing","command-line","exploration","game-engine","interactive-fiction","mud","mud-engine","mud-server","online-game","python3","sandbox","sandbox-game","telnet","text","text-adventure","text-adventure-engine","tinydb","user-content","websocket"],"latest_commit_sha":null,"homepage":"https://dennismud.xyz/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seisatsu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-22T10:17:30.000Z","updated_at":"2023-02-17T18:39:02.000Z","dependencies_parsed_at":"2023-01-30T04:45:59.825Z","dependency_job_id":null,"html_url":"https://github.com/seisatsu/DennisMUD","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seisatsu%2FDennisMUD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seisatsu%2FDennisMUD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seisatsu%2FDennisMUD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seisatsu%2FDennisMUD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seisatsu","download_url":"https://codeload.github.com/seisatsu/DennisMUD/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213069690,"owners_count":15532837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","collaborative-writing","command-line","exploration","game-engine","interactive-fiction","mud","mud-engine","mud-server","online-game","python3","sandbox","sandbox-game","telnet","text","text-adventure","text-adventure-engine","tinydb","user-content","websocket"],"created_at":"2024-07-29T19:14:22.994Z","updated_at":"2024-10-23T16:30:35.128Z","avatar_url":"https://github.com/seisatsu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dennis MUD - Multiplayer Text Adventure Sandbox\n\nDennis is a MUD (Multi-User Dungeon, aka a multi-player text adventure) and collaborative writing exercise inspired by [ifMUD](http://ifmud.port4000.com/), in which all content is created by the users, by utilizing in-game commands. The game starts with a single empty room, and one or more players build a world from that point by adding rooms, exits, and items, and assigning them descriptions and attributes. The in-game `help` command provides a categorized listing and usage instructions for every command in the game. This is an experimental project in early alpha, and new features are added frequently. Bugs and backwards-incompatible updates are to be expected.\n\nA public test instance is generally kept running. Access it with the web client at http://play.dennismud.xyz/ or via telnet at the same host on port 37380.\n\nDefaults Configuration\n======================\n\nThere is a configuration file `defaults.config.example.json` which contains a number of default values to use when creating new in-game rooms, items, and users. It is necessary before running Dennis to copy this file to `defaults.config.json`, and make changes if desired.\n\nSingle User Mode (Single-player)\n================================\n\nTo try out single user mode on the command line, first make sure you have [Python 3](https://www.python.org/), [TinyDB](https://tinydb.readthedocs.io/en/latest/), [Python Prompt Toolkit](https://python-prompt-toolkit.readthedocs.io/en/master/), and [jsonschema](https://python-jsonschema.readthedocs.io/en/stable/). (Previous versions used MongoDB.) Then copy `singleuser.config.example.json` to `singleuser.config.json`, change any necessary settings, and  run `python3 singleuser.py` in the project's top directory from your console.\n\nMulti-player Server\n===================\n\nTo run a multi-player server, you can run `server.py`, which will start a websocket service and a telnet service by default. `websocket-client.example.html` provides an example in-browser client for the websocket service. You will also have to copy `server.config.example.json` to `server.config.json` and change any necessary settings. If you would like, you can also copy `motd.telnet.example.txt` to `motd.telnet.txt` and modify it as needed to provide a message to telnet users upon connection. To run the services, you will need [Python 3](https://www.python.org/), [TinyDB](https://tinydb.readthedocs.io/en/latest/), [jsonschema](https://python-jsonschema.readthedocs.io/en/stable/), [Twisted](https://twistedmatrix.com/trac/), [Autobahn](https://crossbar.io/autobahn/), [pyOpenSSL](https://www.pyopenssl.org/en/stable/), and [service_identity](https://service-identity.readthedocs.io/en/stable/installation.html).\n\nWindows Releases\n================\n\nThe Windows releases contain binaries which already contain all of the requirements for running the server and cli. You shouldn't need to install anything. You also don't need to copy or rename the config files if you download a Windows release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseisatsu%2FDennisMUD","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseisatsu%2FDennisMUD","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseisatsu%2FDennisMUD/lists"}