https://github.com/Frimkron/mud-pi Skip to content Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} Frimkron / mud-pi Public * Notifications * Fork 83 * Star 243 * A simple MUD server in Python, for teaching purposes, which could be run on a Raspberry Pi License MIT license 243 stars 83 forks Branches Tags Activity Star Notifications * Code * Issues 0 * Pull requests 1 * Actions * Projects 0 * Wiki * Security * Insights Additional navigation options * Code * Issues * Pull requests * Actions * Projects * Wiki * Security * Insights Frimkron/mud-pi This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master BranchesTags Go to file Code Folders and files Name Name Last commit message Last commit date Latest commit History 19 Commits README.md README.md licence.md licence.md mudserver.py mudserver.py simplemud.py simplemud.py View all files Repository files navigation * README * MIT license MUD Pi A simple text-based Multi-User Dungeon (MUD) game, which could be run on a Raspberry Pi or other low-end server. Requirements You will need to install Python (2.7+ or 3.3+) where you wish to run the server. Installers for Windows and Mac can be found at http:// www.python.org/download/. There are also tarballs for Linux, although the best way to install on Linux would be via the package manager. To allow players to connect remotely, the server will also need to be connected to the internet. To connect to the server you will need a telnet client. On Mac, Linux, and versions of Windows prior to Windows Vista, the telnet client is usually installed by default. For Windows Vista, 7, 8 or later, you may need to follow this guide to install it. Running the Server On Windows Double click on simplemud.py - the file will be opened with the Python interpreter. To stop the server, simply close the terminal window. On Mac OSX and Linux (including Raspberry Pi) From the terminal, change to the directory containing the script and run python simplemud.py Note, if you are connected to the machine via SSH, you will find that the script stops running when you quit the SSH session. A simple way to leave the script running is to use a tool called screen. Connect via SSH as usual then run screen. You will enter what looks like a normal shell prompt, but now you can start the python script running and hit ctl+a followed by d to leave screen running in the background. The next time you connect, you can re-attach to your screen session using screen -r. Alternatively you could create a daemon script to run the script in the background every time the server starts. Connecting to the Server If the server is running behind a NAT such as a home router, you will need to set up port 1234 to be forwarded to the machine running the server. See your router's instructions for how to set this up. There are a large number of setup guides for different models of router here: http://portforward.com/english/routers/port_forwarding/ You will need to know the external IP address of the machine running the server. This can be discovered by visiting http:// www.whatsmyip.org from that machine. To connect to the server, open your operating system's terminal or command prompt and start the telnet client by running: telnet 1234 where is the external IP address of the server, as described above. 1234 is the port number that the server listens on. If you are using Windows Vista, 7, 8 or later and get the message: 'telnet' is not recognized as an internal or external command, operable program or batch file. then follow this guide to install the Windows telnet client. If all goes well, you should be presented with the message What is your name? To quit the telnet client, press ctl + ] to go to the prompt, and then type quit. What is Telnet? Telnet is simple text-based network communication protocol that was invented in 1969 and has since been superseded by other, more secure protocols. It does remain popular for a few specialised uses however, MUD games being one of these uses. A long (and boring) history of the telnet protocol can be found here: http://www.cs.utexas.edu/users/ chris/think/ARPANET/Telnet/Telnet.shtml What is a MUD? MUD is short for Multi-User Dungeon. A MUD is a text-based online role-playing game. MUDs were popular in the early 80s and were the precursor to the graphical Massively-Multiplayer Online Role-Playing Games we have today, like World of Warcraft. http:// www.mudconnect.com is a great site for learning more about MUDs. Extending the Game MUD Pi is a free and open source project (that's free as in freedom). This means that the source code is included and you are free to read it, copy it, extend it and use it as a starting point for your own MUD game or any other project. See licence.md for more info. MUD Pi was written in the Python programming language. If you have never used Python before, or are new to programming in general, why not try an online tutorial, such as http://www.learnpython.org/. There are 2 source files in the project. mudserver.py is a module containing the MudServer class - a basic server script which handles player connections and sending and receiving messages. simplemud.py is an example game using MudServer, with player chat and rooms to move between. The best place to start tweaking the game would be to have a look at simplemud.py. Why not try adding more rooms to the game world? You'll find more ideas for things to try in the source code itself. Of course if you're feeling more adventurous you could take a look at the slightly more advanced networking code in mudserver.py. MUD-Pi-Based Projects Here are some of the cool projects people have made from MUD-Pi: * ESP8266 MUD by Barry Ruffner - a MUD that runs entirely within an ESP8266 microchip, using MicroPython * MuddySwamp by the University of Florida Open Source Club - a UF-themed MUD * Dumserver by Bartek Radwanski - a feature-rich MUD engine Author MUD Pi was written by Mark Frimston For feedback, please email mfrimston@gmail.com or add a comment on the project's Github page About A simple MUD server in Python, for teaching purposes, which could be run on a Raspberry Pi Topics game python raspberry-pi mud learning-python learn-to-code text-adventure-game rpg-game multi-user-dungeon telnet-server Resources Readme License MIT license Activity Stars 243 stars Watchers 21 watching Forks 83 forks Report repository Releases No releases published Packages 0 No packages published Contributors 3 * @Frimkron Frimkron Mark Frimston * @chadlung chadlung Chad Lung * @JordanWhittle JordanWhittle Languages * Python 100.0% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.