Installing Cyphesis

From WorldForgeWiki
Jump to: navigation, search

Note that we only support *NIX like environments, like Linux and *BSD. It should probably work on OSX, but we haven't tried. We don't support Windows. If you're on a Windows box and want to run a server for testing, we recommend that you use something like Virtualbox to set up a virtual machine.

Installation of Cyphesis from source

Hammer Script

The Hammer script greatly automates the process of downloading and compiling all the dependencies, libraries, server, and clients.

Running Cyphesis

Next, you will need to set up the PostgreSQL database for Cyphesis. Do the following as root and replace the username with the name of the account that Cyphesis will run as (Note for Ubuntu users: Instead of running "su - postgres" as root and then running "createuser", run "sudo -u postgres createuser"):

blackjack:~ # su - postgres
postgres@blackjack:~> createuser
Enter name of role to add: kai
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
CREATE USER

Now as the user who is going to run Cyphesis:

kai@blackjack:~> createdb cyphesis
CREATE DATABASE

Now that our database is set up, we can load the ruleset into the database:

kai@blackjack:~> cyloadrules
Reading rules from mason
80 classes stored in rule database.
Reading rules from basic
30 classes stored in rule database.

Once that is done, we can start Cyphesis for the first time:

kai@blackjack:~> cyphesis

Cyphesis is up and running with a default world.

There is one more thing you should do. To be able to edit the world you need to be able to log into it as an administrator. To set the password on the admin account do the following:

kai@blackjack:~> cypasswd
[...]

Errors

For a list of Commonly encountered errors and how to fix them please visit the Troubleshooting page.

Development

The following pages related to cyphesis development are current hosted on the wiki:

Collision Detection Engine Blueprint

Event Broadcasting Blueprint