Your IP : 216.73.216.224
Latest Upddate - 04/25/2026
===========================
# Install Ubuntu according to my install instructions: https://ubuntu.retro-os.live/Install_Ubuntu.txt
Do these steps as root unless told otherwise... These steps have been tested on Ubuntu 16.04, 20.04, 22.04, and 24.04. Some steps may be different on other Linux distros.
run:
apt install dos2unix
Download jdk from https://PocketMud.com/jdownloads/Tested\ Java/jdk-12.0.1_linux-x64_bin.deb - the version here has been tested and known to work well with CoffeeMUD.
run:
wget https://PocketMud.com/jdownloads/Tested\ Java/jdk-12.0.1_linux-x64_bin.deb
run:
dpkg -i ./jdk-12.0.1_linux-x64_bin.deb
# If needed:
apt --fix-broken install # Then run above command again
rm ./jdk-12.0.1_linux-x64_bin.deb
run:
adduser cmowner
cd /home/cmowner
#git clone https://github.com/bozimmerman/CoffeeMud.git
If you also want to automate the discovery of the latest tag, you can use:
git ls-remote --tags --sort="v:refname" https://github.com/bozimmerman/CoffeeMud.git | tail -n1 | sed 's/.*\///; s/\^{}//'
then:
git clone --depth 1 --branch v5_11_0_1 https://github.com/bozimmerman/CoffeeMud.git
cd CoffeeMud
dos2unix *.sh
chmod a+x *.sh
./config.sh
when asked enter the path as /usr/lib/jvm/jdk-12.0.1
Now you need to get the mysql java plugin so you can run with your DB properly stored.
run:
cd lib
wget https://PocketMud.com/jdownloads/Tested\ Java/mysql-connector-java-5.1.46-bin.jar
cd ..
Edit mud.sh to look like this:
/usr/lib/jvm/jdk-12.0.1/bin/java -classpath ".:./lib/js.jar:./lib/jzlib.jar:./lib/mysql-connector-java-5.1.46-bin.jar" -Xms129m -Xmx256m com.planet_ink.coffee_mud.application.MUD "Your MUD Name"
Most important is adding the ":./lib/mysql-connector-java-5.1.46-bin.jar" to the end of the classpath, removing the "nohup" from the start and the "&" from the end.
===
Ok now to set up the MySQL portion
Open the coffeemud.ini configuration file and find this part of the file about fakedb:
DBCLASS=com.planet_ink.fakedb.Driver
DBSERVICE=jdbc:fakedb:resources/fakedb
DBUSER=
DBPASS=
DBCONNECTIONS=2
DBREUSE=TRUE
DBPINGINTERVALMINS=60
Add a "#" sign at the beginning of each of those lines to comment those lines out.
Right above the fakedb configuration part, you should see this part for MySQL. Make it look like this:
DBCLASS=com.mysql.jdbc.Driver
DBSERVICE=jdbc\:mysql\://localhost\:3306/coffeemud
DBUSER=coffeemud
DBPASS=<coffeemud password>
DBPARMS=autoReconnect=true useSSL=false allowPublicKeyRetrieval=true
DBREUSE=TRUE
DBTRANSACT=TRUE
DBCONNECTIONS=10
DBREUSE=TRUE
DBPINGINTERVALMINS=60
Now to set up the blank database...
run:
cd /home/cmowner/CoffeeMud/guides/database
mysql -p
then enter this:
create database coffeemud;
use coffeemud;
source coffeemuddbmysql.sql;
CREATE USER 'coffeemud'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON * . * TO 'coffeemud'@'localhost';
quit;
Ok, now edit the coffeemud.ini file for your desired selections
Install my utilities:
cd /home/cmowner
wget https://pocketmud.com/InstallFiles/CoffeeUtilitiesLatest.zip
unzip CoffeeUtilitiesLatest.zip
rm CoffeeUtilitiesLatest.zip
Set up the required perl modules:
cd CoffeeManagementConsole
./installdeps
chown -R cmowner:cmowner /home/cmowner
su - cmowner
Set the tools up:
Go into CoffeeBackup, CoffeeManagementConsole, and CoffeeStartup
directories and follow the steps in the README.md files
Edit the backup config:
# When you run it for the first time it will ask you for database info:
cd /home/cmowner/CoffeeBackup
./coffeebackup
# If you want to change the settings use: "./coffeebackup -prefs"
If they want area files loaded do this:
wget https://PocketMud.com/InstallFiles/areas.zip
# Log into the MUD and use this command:
import which.cmare