Skip to content
Planescape MUD: server source code
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin
etc
libdreamland
plug-ins
src
.gitignore
AUTHORS
COPYING
INSTALL.old
Makefile.am
Makefile.git
README.md
configure.ac

README.md

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
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.