Download » History » Sprint/Milestone 17

Vincent Le Goff, 12/17/2017 05:12 PM

1 9 Vincent Le Goff
h1. Downloading and installing CocoMUD
2 9 Vincent Le Goff
3 9 Vincent Le Goff
CocoMUD is pre-built on Windows as a portable archive.  It means that the only thing you'll have to do, if you are using Windows, is downloading the archive (see link below), extract it and open the *cocomud.exe* file.  The details are provided in the following sections.
4 9 Vincent Le Goff
5 9 Vincent Le Goff
h2. Downloading CocoMUD
6 9 Vincent Le Goff
7 9 Vincent Le Goff
| Build | Windows |
8 17 Vincent Le Goff
| +*48*+ | "CocoMUD for Windows (.zip)": |
9 9 Vincent Le Goff
10 9 Vincent Le Goff
If you are using another platform, you might wish to [[InstallFromSource|install CocoMUD from source]].  CocoMUD can run on Linux or Mac OS, although there's no pre-built version yet.
11 9 Vincent Le Goff
12 9 Vincent Le Goff
If you are accessing this page from a version of CocoMUD already installed, please note that the links given above may be out-of-date.  You should refer to the "online documentation": to download the correct file.
13 9 Vincent Le Goff
14 9 Vincent Le Goff
h2. Installing CocoMUD
15 9 Vincent Le Goff
16 9 Vincent Le Goff
Once you have downloaded the archive, you can extract it in a folder.  CocoMUD doesn't require installation, it will run as a portable software (you can even put it on a USB flash drive and take it with you).
17 9 Vincent Le Goff
18 9 Vincent Le Goff
# Extract the ** file in your desired folder.  Note that CocoMUD cannot run from the archive itself (if it does, it will not be able to write anything).
19 9 Vincent Le Goff
# In the extracted archive, you should find a folder named *CocoMUD*.  Open it.
20 9 Vincent Le Goff
# In it is a file *cocomud.exe*.  Click on it.  CocoMUD should open and display the connection screen.
21 9 Vincent Le Goff
# Should you like CocoMUD, don't hestitate to create a shortcut leading to *cocomud.exe* to make your life a bit easier.
22 9 Vincent Le Goff
23 9 Vincent Le Goff
To learn how to use CocoMUD, you might want to read [[Basics|the basics of CocoMUD]].  It will give you a step-by-step explanation and demonstration of some of the basic features.  More advanced topics will be convered in the rest of the documentation.
24 9 Vincent Le Goff
25 9 Vincent Le Goff
h2. Updating CocoMUD
26 9 Vincent Le Goff
27 9 Vincent Le Goff
CocoMUD has a built-in updater that opens when you launch CocoMUD.  The updater will check for new versions of CocoMUD and, if found, will ask you if you wish to update.  If you reply *yes*, CocoMUD will close and the updater will download and install CocoMUD, before starting the program again.
28 9 Vincent Le Goff
29 9 Vincent Le Goff
You can also see if there are updates by opening CocoMUD.  In the menu bar, select *Help*, then *Check for updates*.  The dialog might take a few seconds to load, since CocoMUD checks for updates on the website.  If everything goes well, the updater should tell you that there is no update, or that there is one and ask you if you want to install it.
30 9 Vincent Le Goff
31 9 Vincent Le Goff
Several things can prevent the updater of running properly.  Windows Firewall, Windows Defender, an anti-virus software or another software to protect your system might deny the updater the right to install CocoMUD.
32 9 Vincent Le Goff
33 9 Vincent Le Goff
If you run into problems while updating, CocoMUD might become corrupted, meaning it can't even start, or if it does, it displays aa lot of errors.  If that happens, there are a few steps you can take to solve the issue:
34 9 Vincent Le Goff
35 9 Vincent Le Goff
# Forcing update: in some cases, CocoMUD tries to update, but some folders are incorrectly changed.  A software to protect your system might increase the risks of this situation to arise.  With Windows firewall and Windows Defender, that situation doesn't occur very often.  If you click on *cocomud.exe* after updating and nothing happens, or if CocoMUD opens but creates a lot of errors, try to force update.  To do this, close CocoMUD (if it were open at all) and click on the file named *dbg_updater.exe*.  *dbg* stands for *debug*, and it will run a debug update with minimal data.  Even if it looks like you're up-to-date, *dbg_updater* will just download the lattest version of CocoMUD, keeping your configuration.  This file will open a console with a progress bar, but you are not expected to do anything, just let it do its work.  If everything goes well, CocoMUD should open in its new version after updating.  If that still doesn't fix the problem, try to run it again before moving to step 2.
36 9 Vincent Le Goff
# Manual update: sometimes, CocoMUD is so corrupted that *dbg_updater* can't run, or can't do much.  A manual installation is then the next step.  Simply download CocoMUD again (see the link above), and extract it in a folder.  To transfer your old configuration in your fresh copy, just go in your old directory.  Copy both the *settings* folder and the *worlds* folder.  These contains your configuration.  Go into your fresh copy, remove these folders and replace them with the ones you had in your old configuration.  Then launch CocoMUD.
37 9 Vincent Le Goff
38 9 Vincent Le Goff
If that doesn't fix the problem, you can definitely contact the team of developers by "creating a bug report": .
39 9 Vincent Le Goff
40 9 Vincent Le Goff
We wish you the best of gaming experiences with CocoMUD!