Text Game Hosting

  Payment Center

  Hosted Games

  Website Hosting

  Code Repository

  Contact Us

  MudMagic FAQ- Dedicated Text Game Hosting

Hosting FAQ

Getting Started - The Shell

* How do I login to the account?
    - SSH
    - Telnet
    - FTP  
* Getting around the Shell (Basic Unix Commands)
    - Changing Directories & Listing contents
    - Changing Password
    - Changing Permissions (Execution Rights)
    - Checking TCP Connections
    - Crontab
    - Killing Processes
Error Message: Incomplete terminfo entry
* Checking CPU/RAM Usage
* Editing Files (VI/PICO)
* Where do I get more help?

Setting Up A MUD

* Choosing A Codebase (What is good/bad)
* Asking MudMagic to set you up.
* How to get the Code
* Installing and Compiling a MUD

* Common Error Messages:
    - ./startup: Permission denied
    - Init socket: bind: Address already in use
    - My MUD dies when I log out of the shell!
* Where To Get Help with Common MUD Questions
    - ROM
    - SMAUG
    - Circle


  1. How Do I Login to the Account?


    SSH (Secure Shell) is a program to log into another computer over a
    network, to execute commands in a remote machine, and to move files
    from one machine to another. It provides strong authentication and
    secure communications over insecure channels. It is intended as a
    replacement for rlogin, rsh, and rcp.

    SSH protects the user from illicit network snooping ("packet sniffing"), whereby
    un-encrypted passwords and text can be read by unscrupulous persons.
    SSH is most useful for logging into a UNIX computer from a Windows or
    Mac computer or from another UNIX computer, where the traditional
    'telnet' and 'rlogin' programs would not provide password and session
    encryption; the CSUA administrative personnel tend to use SSH exclusively
    in preference to telnet or rlogin, except in cases where SSH is not available.

    SSH serves a purpose that is similar to Kerberos, but it works consistently
    amongst different operating systems and is easier to administer (no ticket-
    server is required, sysadmin privileges are not required to set it up). When
    you first use ssh, it asks you to invent an "RSA indentity passphrase". It
    generates public and private keys for you, in files called ""
    and "identity". The "identity" fi4le should not be readable by anyone but
    you. On UNIX, those files are located in your .ssh directory. On Windows,
    they are typically located in your lop-level home directory folder.

    This is our prefered method for getting to MudMagic. What is really cool is
    that SSH is secure and easy to use. Most of the products you download
    come with BOTH SSH and Telnet for you to use. So why not give this a
    shot? It's secure and easy to use.

    Jaelli uses a freeware program PuTTY



    Telnet is a system for logging onto a remote computer through the Internet. There
    are lots of reasons to do this. Telnet allows you to access computers all over the
    world and use the resources you find on those computers. You could use telnet to
    access MudMagic while on vacation to check your mail. You can use it to code
    your MUD,  play your MUD, or you can use it to access and modify web pages
    if you want a web site.

    Telnet began as one of the basic features of Unix. Once you've got a connection
    started, all of the various forms of Telnet are the same because what you really
    see is whatever the other computer is sending you, and telnet is always going to
    be text no matter which version of telnet you use. Telnet  is easy and it is popular.
    It is well worth learning. If you enjoy the Internet, Telnet  will become one of
    your most useful and frequently used tools.

    Clients such as ZMUD are simply a telnet application with built in bells and
    whistles. However the drawback to telnet is its lack of security. The data it sends
    is NOT encrypted, so it is not our favorite choice when connecting to your
    shell account. You'll also need to turn off parsing. That being said, we won't restrict you from using it, we just
    want to warn you :).



    FTP is a method of retrieving files from other computers on the Internet. Normally,
    you need a password and authorised access in order to get hold of a file from elsewhere,
    but there is a special case of FTP called Anonymous FTP, which allows Internet users
    access to the many hundreds of thousands, maybe millions, of files which are available in
    this way.

    All you need is the use of a computer which has a direct TCP/IP connection to the Internet
    and the name (or IP address) of the site you want to download from (the exact directory
    name and filename is also useful, but often not essential, as you can browse through what
    is available).

    You will use FTP to either connect from your shell account by typing simply ftp
    Or you may connect directly to your shell account via FTP to upload/download files from
    your account.

    Hotfiles listings of FTP Clients

    We Like - CrystalFTP


  2. Getting Around the Shell (Basic UNIX Commands)
    Changing Directories - Will move you into whatever folder.

    Listing the Contents of a Folder
    cd whatever

    ls -la
    Changing Your Password passwd
    Changing Permissions (Execution Rights) chmod u+x filename   
    Checking TCP Connections - Replace the 3000 with _YOUR_ port number.  netstat -t |grep 3000 |wc -l
    Crontab - Create a listing for editing a crontab. type man crontab on the shell to learn more. NOTE: This places you inside the VI editor. crontab -e
    Killing Processes - Soft Kill
                                    - Hard Kill
    kill -12 PID
    kill -9 PID
    Error Message: Incomplete terminfo entry export TERM=vt100


  3. How do I see how much RAM/CPU% I'm using?

    To do this from your shell account, type ps -ux. You should get an output
    like this:
    1. [darkoth@www log]$ ps -ux
    darkoth 18345 0.0 0.1 1528 872 pts/14 S 14:53 0:00 -bash
    darkoth 19139 0.0 0.2 2256 1100 pts/14 S 15:11 0:00 csh ./startup
    darkoth 19140 0.6 0.5 6132 2912 pts/14 S 15:11 0:00 ../src/rom 9969
    darkoth 19215 0.0 0.1 2344 712 pts/14 R 15:13 0:00 ps -ux

        Let's break this down:
        USER = Your user name.
        PID = Process ID. Good for killing off processes.
        %CPU = What Percent CPU you are using. (WE CHECK THIS) Example: we are using 0.6 CPU for the MUD.
        %MEM = Percentage of memory you are using.
        VSZ = Virtual Size of RAM
        RSS = Resident Size of RAM (WE CHECK THIS) Exampe: we are using 2912 or 2 Meg for the MUD
        TTY = What TTY the process is using.
        STAT = what state the process is using.
        START = What time the process started.
        TIME = How much time is clocking on the process.
        COMMAND = The actual process that is running.


  4. Editing Files - VI & PICO

    There are a few different editors out there for editing from the shell. Vi has a little bit of a learning curve to it, so if you aren't familiar with it, we'd recommend pico.  Syntax: pico filename or vi filename. If you want more info on these check out the
    following links.

    Pico Info:

    VI Info:


  5. Getting More Help with the Shell.

    Are you still having problems with your shell account? I suggest getting
    yourself a couple great books to assist in your learning process. The more
    you learn about the shell the better of a MUD admin you will become. If
    you still get stuck feel free to email hosting. Another great
    place to look is google, our favorite search engine.


    Learning the Unix Operating System (Nutshell Handbook)



  1. Choosing A Codebase (What is Good/Bad)

    You should have a good idea what you want from a codebase. Most people
    chose to run the same codebase of the MUD they like to play the most. Some
    like to venture off and find their own thing. This is all up to you. Just be sure
    that you pick a codebase that has the features and flexability you want. If you
    aren't sure, ask around or visit the codebase sites listed at the bottom of this

  2. Asking MudMagic To Set You Up.

    If you wish, you may send an email to hosting and request us
    to set your MUD up. However, you MUST know what codebase you want.
    Once this is done, we will install the MUD for you. Please provide the following

    login name:
    MUD Base you wish to use:

    Once we have this information your game will be setup on your port and you
    should receive an email when it is complete. Please be advised that we only
    offter this to get you started.
  3. How To Get the Code

    If you are opting for a "do-it-yourself" approach, then simply either copy the
    files from the local machine or ftp them from the official site of the codebase.
    Here are a few shortcuts below for cutting and pasting into your shell window
    to copy from some of the most popular codebases:

    FTP - do this from your shell account if you know where the codebase is:

    login: anonymous

    cd /dir/you/want
    get filename.tgz

  4. Installing and Compiling a MUD.

    Once you have your MUD downloaded, you must "unpack" it. Most of
    the time these files come in either a .tar.gz or a .tgz. Simply type this to
    get them "unpacked"

    tar -zxvf file.tar.gz
    tar -zxvf file.tgz

    So if you copied the smaug source from above you'd do this:

    tar -zxvf smaug.tgz

    To compile the MUD you need to follow the specific instructions for
    your particular codebase. For most its something like this for ROM:

    cd Rom24/src

    Once it is done it will come back to the prompt and you will need to
    edit your startup script and change the port number. Simple enough.
    Again this is dependant on what codebase you are running. Be sure
    to read over all the instructions and/or helpfiles they give you. We
    provide links to those at the bottom of this page.

  5. Common Error Messages

    Error Message or Problem How to Correct or Why it happens
    ./startup: Permission denied This means your file isn't executable simple type this:
    chmod u+x startup
    Init socket: bind: Address already in use If you get this message it will probably appear in your logfiles. The cause for this is that someone else is already using that port. Telnet to that port to find out if someone is using it or you can see if your MUD is already running by typing ps -ux. If someone is using your port please let us know.
    My MUD dies when I log out of the shell! Simple Problem. When you start the MUD you just type ./startup. To correct this add the & to place it into the background. So you'd do:
    ./startup &


  6. Darkoth's Site - FAQ's and much much more.

Kudos | AUP |

Web site and all contents © Copyright MudMagic