--- deliantra/www/src/editor_tut.html 2007/09/13 20:50:53 1.3 +++ deliantra/www/src/editor_tut.html 2008/06/20 08:32:32 1.7 @@ -1,12 +1,12 @@ Editor Tutorial
-

Crossfire TRT map making and server installation tutorial for Linux

+

Deliantra map making and server installation tutorial for Linux

-So, you don't know much about crossfire and or programming, but +So, you don't know much about deliantra and or programming, but you want to make maps? This Tutorial will explain how to -install the Crossfire TRT server (from CVS) on your linux system +install the Deliantra server (from CVS) on your linux system and making your first maps. If you are stuck somewhere, please contact us (the developers).

@@ -17,138 +17,11 @@ handling yourself.

-

Step 1: Downloading the maps and the server from CVS

- -

-I assume here you have cvs installed. (the debian shortcut would -be: apt-get install cvs). -

- -

-Create a directory in your home where all your Crossfire TRT (map) development -should take place: -

- -
-root@localhost: ~# mkdir ~/crossfire/
-
- -

- NOTE: the 'root@localhost: ~#' stands for your shellprompt, where '~' is the - current working directory. And the ~ stands for your root homedirectory, if you are working - as user 'root' your homedirectory should be something like /root. -

- -

Go into that directory:

- -
-root@localhost: ~# cd ~/crossfire/
-
- - -

Now, we are going to get the files, first the maps:

- -
-root@localhost: ~/crossfire# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de:636/schmorpforge co -d maps cf.schmorp.de/maps
-
- -

And then the archetypes (needed for building the server, and could take a while):

- -
-root@localhost: ~/crossfire# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de:636/schmorpforge co -d arch cf.schmorp.de/arch
-
- -

Finnally the server source itself:

- -
-root@localhost: ~/crossfire# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de:636/schmorpforge co -d server cf.schmorp.de/server
-
- -

-Now a ls -l should show something like this: -

- -
-root@localhost: ~/crossfire# ls -l
-   1 drwxr-xr-x 39 root users    1192 2006-06-01 21:29 maps
-   1 drwxr-xr-x 39 root users    4096 2006-05-26 12:38 arch
-   1 drwxr-xr-x 17 root users    1072 2006-05-26 11:34 server
-
- -

Step 2: Compiling and installing the server

- -

-Start by going into the server CVS checkout directory and just call configure (the script that -will find all the neccessary tools to compile the server). Please make sure you have -development tools like gcc (gnu c compiler) and headers installed: -

- -
-root@localhost: ~/crossfire# cd server
-root@localhost: ~/crossfire/server# ln -s /root/crossfire/arch lib/arch
-root@localhost: ~/crossfire/server# ./configure --prefix=/opt/crossfire/
-
- -

-The prefix argument tells the configure script to choose /opt/crossfire/ as installation -destination. This is done to prevent the server installation from polluting your -system and to keep all files together. -

- -

Next step is the compilation and installation of the server:

- -
-root@localhost: ~/crossfire/server# make install
-
- -

-That should build the sources and install them. If you encounter problems here you could try to contact us. -If everythin went fine, there should be a /opt/crossfire/ directory now with files in it. -

- -

-Next step is to link the maps into the installed server directory. First go back into the parent -directory and then link the maps dir to the right location: -

- -
-root@localhost: ~/crossfire/server# cd ..
-root@localhost: ~/crossfire# ln -s ~/crossfire/maps /opt/crossfire/share/crossfire/maps
-
- -

-Now everything is in place and all thats left is to write a -startup script for the server: -

- -
-root@localhost: ~/crossfire# echo "CROSSFIRE_LIBDIR=/opt/crossfire/share/crossfire/ /opt/crossfire/bin/crossfire" > startcf
-root@localhost: ~/crossfire# chmod a+x startcf
-
- -

- Note: The CROSSFIRE_LIBDIR thing is setting an environment variable which - tells the server where to look for the configuration variables and the maps -

- -

Now try to shoot it up:

- -
-root@localhost: ~/crossfire# ./startcf
-
- -

-You should see lots of output running accross your screen. -Congratulations, you just setup a Crossfire TRT server. -You maybe want to dive into the server tree and look around in the doc/ -directory to find more about the server. -

- -

Step 3: Getting the map editor and setting it up

+

Step 1: Getting the map editor and setting it up

Now download the editor! You can either install all the Perl modules and stuff by yourself -or just choose the binary: gce-gnu-linux-x86.bin. +or just choose the binary: editor download page. I'm not going to discuss the installation procedure for the CVS here, as it requires much knowledge about your system and how to install (perl) software from source. If you only want to make maps, the binary will do very fine (on x86 systems). @@ -158,13 +31,13 @@ So, the next thing is to download the editor.

-root@localhost: ~/crossfire# wget http://dist.schmorp.de/gce/gce-gnu-linux-x86.bin
+root@localhost: ~/deliantra# wget http://dist.schmorp.de/gce/gce-gnu-linux-x86.bin
 

There it is, now we make it an executable and run it:

-root@localhost: ~/crossfire# chmod a+x gce-gnu-linux-x86.bin
+root@localhost: ~/deliantra# chmod a+x gce-gnu-linux-x86.bin
 

@@ -173,9 +46,9 @@

-root@localhost: ~/crossfire# echo "CROSSFIRE_LIBDIR=/opt/crossfire/share/crossfire/ ./gce-gnu-linux-x86.bin" > startgce
-root@localhost: ~/crossfire# chmod a+x startgce
-root@localhost: ~/crossfire# ./startgce
+root@localhost: ~/deliantra# echo "CROSSFIRE_LIBDIR=/opt/deliantra/share/deliantra/ ./gce-gnu-linux-x86.bin" > startgce
+root@localhost: ~/deliantra# chmod a+x startgce
+root@localhost: ~/deliantra# ./startgce
 

@@ -218,7 +91,7 @@

Finished! You have now a layout we can work with. Go on to the next step:

-

Step 4: Making your first map

+

Step 2: Making your first map

This step will introduce some tools and shortcuts you may use on a regular basis when making maps. @@ -295,7 +168,141 @@ map editor with floor and walls -to be continued... +

to be continued...

+ +
+ +

Installing the server for testing the maps

+ + +

Step A: Downloading the maps and the server from CVS

+ +

+I assume here you have cvs installed. (the debian shortcut would +be: apt-get install cvs). +

+ +

+Create a directory in your home where all your Deliantra (map) development +should take place: +

+ +
+root@localhost: ~# mkdir ~/deliantra/
+
+ +

+ NOTE: the 'root@localhost: ~#' stands for your shellprompt, where '~' is the + current working directory. And the ~ stands for your root homedirectory, if you are working + as user 'root' your homedirectory should be something like /root. +

+ +

Go into that directory:

+ +
+root@localhost: ~# cd ~/deliantra/
+
+ + +

Now, we are going to get the files, first the maps:

+ +
+root@localhost: ~/deliantra# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d maps deliantra/maps
+
+ +

And then the archetypes (needed for building the server, and could take a while):

+ +
+root@localhost: ~/deliantra# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d arch deliantra/arch
+
+ +

Finnally the server source itself:

+ +
+root@localhost: ~/deliantra# cvs -z3 -d :pserver:anonymous@cvs.schmorp.de/schmorpforge co -d server deliantra/server
+
+ +

+Now a ls -l should show something like this: +

+ +
+root@localhost: ~/deliantra# ls -l
+   1 drwxr-xr-x 39 root users    1192 2006-06-01 21:29 maps
+   1 drwxr-xr-x 39 root users    4096 2006-05-26 12:38 arch
+   1 drwxr-xr-x 17 root users    1072 2006-05-26 11:34 server
+
+ +

Step B: Compiling and installing the server

+ +

+Start by going into the server CVS checkout directory and just call configure (the script that +will find all the neccessary tools to compile the server). Please make sure you have +development tools like gcc (gnu c compiler) and headers installed: +

+ +
+root@localhost: ~/deliantra# cd server
+root@localhost: ~/deliantra/server# ln -s /root/deliantra/arch lib/arch
+root@localhost: ~/deliantra/server# ./configure --prefix=/opt/deliantra/
+
+ +

+The prefix argument tells the configure script to choose /opt/deliantra/ as installation +destination. This is done to prevent the server installation from polluting your +system and to keep all files together. +

+ +

Next step is the compilation and installation of the server:

+ +
+root@localhost: ~/deliantra/server# make install
+
+ +

+That should build the sources and install them. If you encounter problems here you could try to contact us. +If everythin went fine, there should be a /opt/deliantra/ directory now with files in it. +

+ +

+Next step is to link the maps into the installed server directory. First go back into the parent +directory and then link the maps dir to the right location: +

+ +
+root@localhost: ~/deliantra/server# cd ..
+root@localhost: ~/deliantra# ln -s ~/deliantra/maps /opt/deliantra/share/deliantra/maps
+
+ +

+Now everything is in place and all thats left is to write a +startup script for the server: +

+ +
+root@localhost: ~/deliantra# echo "CROSSFIRE_LIBDIR=/opt/deliantra/share/deliantra/ /opt/deliantra/bin/deliantra" > startcf
+root@localhost: ~/deliantra# chmod a+x startcf
+
+ +

+ Note: The CROSSFIRE_LIBDIR thing is setting an environment variable which + tells the server where to look for the configuration variables and the maps +

+ +

Now try to shoot it up:

+ +
+root@localhost: ~/deliantra# ./startcf
+
+ +

+You should see lots of output running accross your screen. +Congratulations, you just setup a Deliantra server. +You maybe want to dive into the server tree and look around in the doc/ +directory to find more about the server. +

+ +