Planescape MUD build instructions

Tested on Ubuntu 16.04.

If you want to build a ready-to-run image using docker, see these instructions.

Install packages

apt-get update
apt-get install -y gcc make automake libtool bison flex gcc-multilib g++-multilib git
dpkg --add-architecture i386
apt-get update
apt-get install -y libdb5.3++:i386 libdb5.3++-dev:i386 libdb5.3:i386 zlib1g-dev:i386

Create folder tree

Let's assume we're under /home/planescape:

git clone https://github.com/planescape-mud/planescape_world.git
git clone https://github.com/planescape-mud/planescape_code.git
mkdir runtime
mkdir objs
ln -s /home/planescape/planescape_world runtime/share
ln -s /home/planescape/planescape_world/world.mini runtime/share/world

Compile source code

cd planescape_code
make -f Makefile.git
cd ../objs
../planescape_code/configure --prefix=/home/planescape/runtime
make -j 4 && make install 

Start MUD

cd /home/planescape/runtime
./bin/planescape etc/planescape.xml &

Or, recommended:

./bin/autorun &

Autorun script will take care of restarting the server after a crash or a kill.

View log files

less var/log/syslog*

Changing a plugin

First, rebuild and reinstall the plugin you want to change. For example, you've just changed something in feniaroot plugin:

cd /home/planescape/objs/plug-ins/feniaroot
make -j 4 && make install

Tell the server to reload all plugins:

kill -s SIGUSR1 PID

Or from inside the game, type:

reload plugins

Tell the server to reload just changed plugins:

kill -s SIGUSR2 PID

Note: when running as ./bin/autorun, you can use cat /home/planescape/runtime/var/run/ps.pid instead of PID to get the server process ID.

Changing core code or libdreamland

First, rebuild and reinstall src or libdreamland. For example:

cd /home/planescape/objs/src
make -j 4 && make install

Then reboot:

kill -1 PID

or, from inside the game, type:

shutdown reboot