Some updates to server configuration

pages/server_configuration.txt

@@ -1,53 +1,48 @@
-====== ManaServ Configuration ======
+====== Mana Server Configuration ======
 
-**Note:** This article is about setting up your own Mana server, either for testing purposes or because you want to provide an alternative to the official server. \\
-To get support about setting up a **TmwAthena server**, please have a look at [[http://wiki.themanaworld.org/index.php/Main_Page|The Mana World wiki]].
+This article is about setting up your own Mana server.
 
-There are several steps to achieve this:
+==== Running the Example ====
 
-==== Running ManaServ ====
+There is a small example world and an example configuration file provided with manaserv that allows you to quickly get started. The needed steps to get it running are:
 
   * [[Database Installation|Install]] or [[upgrade database|upgrade]] your database backend.
 
-  * Prepare the different configuration files as much as you can, starting by the manaserv.xml file:
-The server uses the following configuration files: \\
-[[manaserv.xml]] \\
-data/[[attributes.xml]] \\
-data/[[equip.xml]] \\
-data/[[items.xml]] \\
-data/[[skills.xml]] \\
-data/[[maps.xml]] \\
-data/[[monsters.xml]] \\
-data/[[permissions.xml]] \\
-
-  * Get the client data from [[Git repository|Git]] and put it into a ''client-data'' directory where you will be running the game server from.
-  * Get the server data, also from git, and put it into a ''server-data'' directory.
-  * Copy the ''docs/manaserv.xml.example'' file to your favourite directory with the name ''manaserv.xml'', for instance and change the following configuration values to your corresponding client-data and server-data paths:
-      * ''clientDataPath'' to the path of your client data.
-      * ''serverDataPath'' to the path of your server data.
-  * Note that you can use the data given in the ''example/'' folder to start with a proper base.
-  * Start the account server and the game server (The starting sequence doesn't matter.).
-
-**Note:** you can use the ''--config'' option to set where your manaserv.xml file is located. E.g.:
+  * Copy the ''docs/manaserv.xml.example'' file to ''./manaserv.xml''.
+
+  * Start the account server and the game server (the order doesn't matter).
+
+**Note:** you can use the ''--config'' option to set where your ''manaserv.xml'' file is located. By default the server looks for ''./manaserv.xml''. E.g.:
+
   manaserv-game --config /path/to/my/manaserv.xml
-  
+
 **Tip:** Type ''manaserv-account --help'' and ''manaserv-game --help'' to get the list of available options.
 
-==== Making yourself a GM ====
+==== Server and World Configuration ====
 
-This assumes that you are using sqlite as database backend (default) and that your accountname is "MyAccount". When you use another database backend you should be able to use the same SQL statements but you will need different tools to run them. Giving GM rights to an account with a name different from "MyAccount" is an exercise left to the reader :)
+The server is configured in [[manaserv.xml]]. The world has its own [[settings.xml]] file that defines the maps, NPCs, monsters, items, etc. in your world. Most of these settings are also used by the client. The following pages document different parts of the world settings:
 
-=== For SQLite database users (default) ===
+[[maps.xml]] \\
+[[attributes.xml]] \\
+[[equip.xml]] \\
+[[items.xml]] \\
+[[skills.xml]] \\
+[[maps.xml]] \\
+[[monsters.xml]] \\
+[[permissions.xml]] \\
 
-  * Get sqlite3 from http://www.sqlite.org/download.html
-  * Put it into the manaserv directory
-  * Open a command prompt inside the tmwserv directory
+==== Making yourself a GM ====
+
+=== For SQLite database users (the default) ===
+
+  * Install the sqlite3 command line tool (for example from http://www.sqlite.org/download.html)
+  * Open a command prompt inside the manaserv directory
   * Enter ''sqlite3 mana.db "UPDATE mana_accounts SET level=255 WHERE username='MyAccount';"''
   * You can check if you were successful by entering ''sqlite3 mana.db "SELECT username, level FROM mana_accounts;"'' (lists all accounts and their userlevels) or ''sqlite3 mana.db "SELECT username FROM mana_accounts WHERE level > 1;"'' (lists all GM accounts)
 
 === For MySQL database users ===
 
-  * The SQL requests are the same, except that you'll have to logon the mySQL server, using a shell command for instance:
+  * Log in to your MySQL server, using a shell command for instance: \\
   mysql --user=<user> --password=<password> --hostname=<hostname> --port=<port>
   * Choose the database: ''use <my-database-name>;''
   * Then, you can enter the SQL requests: ''"UPDATE mana_accounts SET level=255 WHERE username='MyAccount';"''
@@ -57,7 +52,6 @@ This assumes that you are using sqlite as database backend (default) and that yo
 
 FIXME: This is to be done.
 
-
 **Note:** The level 255 means maximum rights. When you want to give selected people limited rights, refer to the [[permissions.xml]] file configuration.
 
-Basic knowledge of [[http://en.wikipedia.org/wiki/SQL|SQL]] and [[http://sqlzoo.net/|how to use it]] is an important skill for a ManaServ administrator.
+Basic knowledge of [[http://en.wikipedia.org/wiki/SQL|SQL]] and [[http://sqlzoo.net/|how to use it]] is an important skill for a Mana server administrator.