BuildSource

The following instructions explain how you run cuwo from source on Linux/UNIX.

Method 1 (manual)

This should work on at least Ubuntu 12.04 LTS, Mac OS X (with homebrew) and FreeBSD 8.4. Alternatively, get python3.3 instead (but remember to also install asyncio with pip).

1. Install Python 3.4 with pip and build tools.

• Debian/Ubuntu:
  • sudo apt-get install -y python3.4 python3.4-dev python3-pip build-essential

2. Install Cython (and asyncio on Python 3.3)

• Debian/Ubuntu:
  • sudo pip3 install cython

3. Checkout the cuwo repository from GitHub or get the souce here.
4. Unzip the package (to e.g. ~/cuwo) and cd into it.
5. Build cuwo

• python3.4 setup.py build_ext --inplace

Method 2 (bootstrap.sh)

This method is necessary if your distro does not have packages for Python 3.4 or 3.3. It also makes installation a lot more convenient, since it wraps the whole install in one .sh file.

This is necessary on Debian, CentOS, and older versions of Ubuntu.

1. First, install the prerequisites for Python 3.4, curl, and git.

• Ubuntu/Debian: sudo apt-get install -y curl git build-essential libsqlite3-dev libssl-dev libbz2-dev libreadline-dev

2. Create a new directory (e.g. ~/cuwo) and cd into it.
3. Run curl -L http://cuwo.org/bootstrap.php | bash

Running

1. Place the data1.db and data4.db files from Cube World in the data folder.
2. Edit config/base.py to your liking. You should perhaps edit 'server_name' and the 'PASSWORDREPLACEME' key, which is the default password for administration purposes.
3. Start your cuwo server with sh run_server.sh and have fun.

If you have any (reproducible) issues post them here on GitHub or come to #cuwo on EsperNet IRC.

Troubleshooting

• If you get an 'internal compiler error' during compilation, make sure you have at least 2GB of swap space. cuwo itself doesn't need a lot of memory, but the initial compilation process is very memory-hungry.