blob: a9f711a020a92c4272c9ceb5ca55e92047a09cc3 (
plain) (
tree)
|
|
Setting up a Mana server
========================
COMPILATION
Before trying to compile, make sure all the dependencies are installed. For
each dependency the Ubuntu package name is listed as well as the website.
* libxml2 (libxml2-dev) - http://xmlsoft.org/
* Lua (liblua5.1-0-dev) - http://lua.org/
* PhysFS (libphysfs-dev) - http://icculus.org/physfs/
* SQLite 3 (libsqlite3-dev) - http://sqlite.org/
Optional dependencies:
* MySQL (libmysqlclient-dev) - http://dev.mysql.com/
(replaces the SQLite 3 depency)
1) cmake .
2) make
The compilation should produce two binaries:
* manaserv-account - The account + chat server
* manaserv-game - The game server
SERVER DATA
The server depends on parts of the client data and also has its own data
repository. These are the 'manadata' and 'manaserv-data' repositories.
Currently, manaserv expects these to be merged into a single 'data' directory.
1) Clone manadata and manaserv-data next to the manaserv repository
2) Symlink a 'data' directory in manaserv to manaserv-data
3) Symlink the following files from manaserv-data to manadata:
* data/items.xml - Item definitions
* data/monsters.xml - Monster definitions
* data/maps/*.tmx{.gz} - Maps
CONFIGURATION
The server loads its configuration from manaserv.xml, which it tries to find in
the directory where you're running the server from. An example file is located
at docs/manaserv.xml.example.
Default option values:
accountServerAddress localhost
accountServerPort 9601
gameServerAddress localhost
gameServerPort 9604
serverPath .
worldDataPath example
RUNNING
1. Run manaserv-account on one single computer. It will open three consecutive
UDP ports, starting from the one given by the configuration option
"accountServerPort". This first port is the one you should advertise to your
users. The configuration option "accountServerAddress" should contain the
public address the server runs on, as it will be sent to the users as the
address of the chat server, which happens to be the account server for now.
2. Run manaserv-game on multiple computers. Each game server will open one UDP
port given by the configuration option "gameServerPort". It will also connect
to the account server given by the configuration options "accountServerAddress"
and "accountServerPort". The configuration option "gameServerAddress" should
contain the public address of the computer the server runs on, as it will be
sent to the users. The file data/maps.xml contains the maps the server will
load and register on the account server; split it across your multiple game
servers, in order to balance the load.
Access to port "accountServerPort + 1" of the account server can be restricted
to connections from game servers only. Users do not need to access it.
INITIAL DATABASE SETUP
To initally setup the database run the following command:
cat src/sql/sqlite/createTables.sql | sqlite3 mana.db
This will generate a database called mana.db according to the needs of the server.
For making a player admin do:
sqlite3 mana.db "UPDATE mana_accounts SET level=255 WHERE username='MyAccount';"
|
