Installation

Installation

Several different installer archives are available for JamochaMUD; it is recommended that you download and install the archive type that you feel most comfortable with. All archives may be downloaded from http://www.jamochamud.org/downloads.html

Java Webstart

A part of many Java distributions, Java Webstart lets you down, install, and run Java software simply by clicking on a link on a web page. By clicking the JamochaMUD Webstart link on the JamochaMUD download page (trusting that Webstart is properly setup on your machine) you will be see a dialogue box appear. It will caution you that JamochaMUD was signed by an “untrusted” source (well, really!) and that you can either stop the download, trust the application once, or always trust it. Unless you don't want to run JamochaMUD, you should choose “always trust”. With only trusting the application once, it will download and install, but will not operate properly.

The reason that you need to trust JamochaMUD is that the MU* client needs to read and write to your hard drive to save its settings, save logs, and then read those settings again later.

More than likely Java Webstart will give you the option to make a desktop icon for JamochaMUD. After installation, whenever you start JamochaMUD from this icon it will automatically check the website for new versions. If there is a new version it will download it first, otherwise it will use the copy of JamochaMUD that is already on your system.

This is probably one of the easiest ways to get going.

Note: If clicking on the Webstart link does not automatically download and start JamochaMUD, you may need to set-up your web-browser to use Webstart, which has been detailed here.

Autopackage

Autopackage archives are a type of “universal installer” for Linux. This JamochaMUD download is wrapped in a basic shell script. You should be able to install this archive by either clicking / double-clicking on the link (depending on your system setup) or executing the archive from the command-line (such as ./JamochaMUD-1.1.051111.x86.package).

When the script runs, it first checks your system to see if you have the Autopackage tools already installed. If not, the script downloads and installs them for you, before proceeding with the installation of JamochaMUD. When the installation is complete Autopackage will create a menu icon for JamochaMUD and add the deinstall information to Autopackage (that may be accessed through the obscurely named “Manage 3rd Party Software” icon or via the command line).

This archive assumes that you have the Java executables in your PATH.

More information about Autopackage may be found at http://autopackage.org/

JarFile

A JarFile is a compressed type of archive, but unlike a Zip file or tarball does not need to be uncompressed to be used. Instead the jarfile contains additional files that indicate to the Java runtime while class needs to be executed and how the environment should be setup... thus, starting a JarFile is very simple. You can use a command such as java -jar JamochaMUD.jar to get started.

Warp-In

Warp-In archives are for use only with OS/2 and eComStation systems that already have Warp-In installed. Warp-In may be found at http://www.xworkplace.org Once you download a Warp-In archive the installation can be started simply by double-clicking on the archive's icon. The installer will walk you through the rest of the installation, automatically recognizing any previous Warp-In installs of JamochaMUD (and using the same directories unless you specify otherwise). When the Warp-In install has completed JamochaMUD icons will be created. Windows self-extracting installer By downloading and double-clicking on the Windows self-extracting installer version of JamochaMUD the installation process will begin. JamochaMUD icons will be created both on your desktop (if you choose) and under your “Programs” menu item.

Zip files and tarballs

Both zip files and tarballs are two no-frills compressed archives of JamochaMUD. These archives must be decompressed using your favourite decompression program (such as Winzip, unzip or tar, depending on the archive type). Using these types of archives will not create icons to start JamochaMUD nor setup the operating environment required to run JamochaMUD. The system's classpath must be updated to included the directory that contains the anecho directory, and then JamochaMUD can be launched by using: java anecho.JamochaMUD.JMUD

Once you have JamochaMUD installed, you can progress on to starting the MU* client.