| 1 |
Deliantra development VM |
| 2 |
|
| 3 |
<h2>The Deliantra development VM</h2> |
| 4 |
|
| 5 |
<h3>What is it?</h3> |
| 6 |
<p> |
| 7 |
It's a virtual computer which comes with GNU/Linux as operating system |
| 8 |
and all necessary packages for Deliantra development pre installed: Map |
| 9 |
editor, server, all maps and archetypes. You can immediately edit and |
| 10 |
create maps on it, create or edit archetypes and test them easily with |
| 11 |
the installed server. |
| 12 |
</p> |
| 13 |
|
| 14 |
<h3>What do I need and where to get it?</h3> |
| 15 |
<p> |
| 16 |
<ul> |
| 17 |
<li> |
| 18 |
First you will need something to run a virtual VMware image: If |
| 19 |
you don't already have the VMware workstation, VMware server or |
| 20 |
something like that installed we recommend to use the free-of-charge |
| 21 |
<a href="http://www.vmware.com/products/player/">VMware Player</a>. |
| 22 |
Download and install the right package for your system. |
| 23 |
</li> |
| 24 |
<li> |
| 25 |
The only other thing you need to download is our <a |
| 26 |
href="http://data.schmorp.de/deliantra-vm.rar">Deliantra |
| 27 |
development VMware image (deliantra-vm.rar)</a>. Download the |
| 28 |
file <tt>deliantra-vm.rar</tt>, unpack it (use <tt>unrar</tt> or |
| 29 |
<tt>winrar</tt>) and run it with the VMware player. |
| 30 |
</li> |
| 31 |
<li> |
| 32 |
<p> |
| 33 |
You should see a screen with boot messages of the linux system scrolling up. |
| 34 |
A few seconds or minutes later you should finally see a graphical desktop similiar to this: |
| 35 |
</p> |
| 36 |
<p> |
| 37 |
<img src="images/deliantra_vm_player.jpg" alt="deliantra VM run by VMware player" /> |
| 38 |
</p> |
| 39 |
</li> |
| 40 |
</ul> |
| 41 |
</p> |
| 42 |
|
| 43 |
<h2>How do I...</h2> |
| 44 |
|
| 45 |
<h3>...start and operate the test server?</h3> |
| 46 |
|
| 47 |
<p> |
| 48 |
<b>First notice the "Terminal" window you get after the virtual machine has |
| 49 |
booted. It contains some valuable gems of information about the VM. You can |
| 50 |
always get back to that screen by opening a new terminal and type in the |
| 51 |
<tt>info</tt> command!</b> It shows you which IP address the virtual machine, |
| 52 |
and thus the test server, has. Remember that IP address, you will need it to |
| 53 |
connect to the test server after it has started. |
| 54 |
</p> |
| 55 |
|
| 56 |
<p> |
| 57 |
To start up the server there is a button on the right side of the |
| 58 |
desktop called "Start Server". Clicking it once will open a terminal |
| 59 |
window on the bottom of the screen with the server log messages |
| 60 |
scrolling through. The very first time you start the server it scans |
| 61 |
all maps, which can bring your machine down to its knees for a |
| 62 |
minute. If you want to stop the server you can press <tt>CTRL+C</tt> in |
| 63 |
that terminal window or simply hit the "close the window" button in |
| 64 |
the upper right corner. If you want to restart the server you can just |
| 65 |
click on the <tt>Start Server</tt> button again. |
| 66 |
</p> |
| 67 |
|
| 68 |
<p> |
| 69 |
When the server is starting up wait a while until the messages in the server log window |
| 70 |
have calmed down a bit. |
| 71 |
</p> |
| 72 |
|
| 73 |
<p> |
| 74 |
Next start up the Deliantra client and enter the IP address of the virtual |
| 75 |
machine in the "Host:Port" field in the "Server" tab of the Setup dialog |
| 76 |
in the client. Next choose a character name and password for your test |
| 77 |
character (the server has no registered players) Log in and create the |
| 78 |
character. |
| 79 |
</p> |
| 80 |
|
| 81 |
<p> |
| 82 |
In the test server everybody can become Dungeon Master by issuing the |
| 83 |
command '<tt>dm</tt>'. As dungeon master you can use special commands that |
| 84 |
manipulate the world, create items and walk and see through walls. This is a |
| 85 |
small cheat sheet of useful DM commands you are able to use as dungeon master: |
| 86 |
<ul> |
| 87 |
<li><tt>dm</tt> - become dungeon master</li> |
| 88 |
<li><tt>nodm</tt> - drop dungeon master privileges</li> |
| 89 |
<li><tt>goto <path></tt> - become dungeon master<br /> |
| 90 |
<p> |
| 91 |
For example to go to the inn in scorn you could use:<br /> |
| 92 |
<tt>goto /scorn/taverns/inn</tt> |
| 93 |
</p> |
| 94 |
</li> |
| 95 |
<li><tt>reset .</tt> or <tt>reset <path></tt> - resets the current map or the map with the path <tt><path></tt><br /> |
| 96 |
<p> |
| 97 |
Resetting maps is necessary if you for example changed a map and |
| 98 |
want to load the changes from disk to the running server. Or if you |
| 99 |
messed it up somehow and want to reset it. |
| 100 |
</p> |
| 101 |
<p> |
| 102 |
<ul> |
| 103 |
<li> |
| 104 |
For example to reset the current map your DM character is on |
| 105 |
use:<br /> |
| 106 |
<tt>reset .</tt> |
| 107 |
</li> |
| 108 |
<li> |
| 109 |
Or to reset the inn in scorn use:<br /> |
| 110 |
<tt>reset /scorn/taverns/inn</tt> |
| 111 |
</li> |
| 112 |
</ul> |
| 113 |
</p> |
| 114 |
</li> |
| 115 |
|
| 116 |
<li><tt>create <number> <archetype name></tt> - create an object from an archetype<br /> |
| 117 |
<p> |
| 118 |
Some examples:<br /> |
| 119 |
<ul> |
| 120 |
<li><tt>create 100 platinacoin</tt></li> |
| 121 |
<li><tt>create 1 dog hp 1000 name "strong dog"</tt></li> |
| 122 |
</ul> |
| 123 |
</p> |
| 124 |
<p> |
| 125 |
Regular objects will be put into your inventory and monsters are put |
| 126 |
on the ground where your DM character is. |
| 127 |
</p> |
| 128 |
</li> |
| 129 |
<li><tt>addexp <player name> <amount of XP points> [<skill name>]</tt> - adds experience to your overall experience or to the experience of a skill<br /> |
| 130 |
<p> |
| 131 |
Some examples:<br /> |
| 132 |
<ul> |
| 133 |
<li><tt>addexp elmex 1000000</tt> - boosts the overall experience of the character 'elmex' to level 15</tt></li> |
| 134 |
<li><tt>addexp elmex 1000000 punching</tt> - boosts the 'punching' skill experience of the character 'elmex' to level 15</tt></li> |
| 135 |
</ul> |
| 136 |
</p> |
| 137 |
</li> |
| 138 |
</ul> |
| 139 |
</p> |
| 140 |
|
| 141 |
<h3>... navigage the file system?</h3> |
| 142 |
|
| 143 |
<p> |
| 144 |
The virtual machine is a regular (a bit stripped down, for smaller size) Debian |
| 145 |
GNU/Linux distribution. If you are not familiar with using terminals and shells |
| 146 |
to browse the file system here are some hints that might help: <a |
| 147 |
href="http://tldp.org/LDP/GNU-Linux-Tools-Summary/html/using-filesystem.html">Moving around the filesystem</a> |
| 148 |
(from the GNU Linux Tools Summary of the Linux documentation Project). |
| 149 |
</p> |
| 150 |
|
| 151 |
<p> |
| 152 |
If you don't have the energy to look into that or still feel more comfortable with a graphical file manager |
| 153 |
we recommend XFE. You can install it by issuing the following commands in a terminal window (an internet |
| 154 |
conenction is required, as this will download the required packages from there):<br /> |
| 155 |
</p> |
| 156 |
<ul> |
| 157 |
<li><tt>apt-get update</tt></li> |
| 158 |
<li><tt>apt-get -y install xfe</tt></li> |
| 159 |
</ul> |
| 160 |
<p> |
| 161 |
And then you can start the XFE by typing <tt>xfe</tt> in a terminal window or use the |
| 162 |
appliaction menu on the "Other ..." to start it (you will find it in the menu Applications => File mangagement). |
| 163 |
</p> |
| 164 |
|
| 165 |
<h3>... find other interesting application packages?</h3> |
| 166 |
|
| 167 |
<p> |
| 168 |
Here is a list of other probably interesting applications you might want to install:<br /> |
| 169 |
<b>NOTE: </b> Remember to run <tt>apt-get update</tt> <i>before</i> using <tt>apt-get install</tt>! |
| 170 |
</p> |
| 171 |
|
| 172 |
<ul> |
| 173 |
<li><tt>apt-get -y install synaptic</tt> - graphical Debian package browser (if you don't like apt-get)</li> |
| 174 |
<li><tt>apt-get -y install gimp</tt> - The GNU Image manipulation Program - if you want to edit or create images</li> |
| 175 |
</ul> |
| 176 |
|
| 177 |
<h3>... stay up to date to Deliantra development?</h3> |
| 178 |
|
| 179 |
<p> |
| 180 |
As time passes there are going to be changes on the server, the maps |
| 181 |
and/or the archetypes of Deliantra. To update your VM to the latest |
| 182 |
state of our CVS, you just have to click on the "Update" button on the right. |
| 183 |
It will automatically update the server, the maps and the archetypes on the VM. |
| 184 |
This might take some time. |
| 185 |
</p> |
| 186 |
|
| 187 |
<p> |
| 188 |
However, if you made local changes (for example on the maps or archetypes) you |
| 189 |
might get conflicts when updating. If you get those conflicts, you will have to |
| 190 |
sort them out yourself. (We recommend you to become more familiar with CVS, see <a href="http://ximbiot.com/cvs/manual/">CVS manuals</a>). |
| 191 |
</p> |
| 192 |
|
