~ubuntu-branches/ubuntu/trusty/sauerbraten-data/trusty

« back to all changes in this revision

Viewing changes to docs/static_wiki/Beginners Guide.html

  • Committer: Bazaar Package Importer
  • Author(s): Bruno "Fuddl" Kleinert
  • Date: 2008-06-28 10:58:08 UTC
  • mfrom: (1.1.4 upstream) (3.1.1 lenny)
  • Revision ID: james.westby@ubuntu.com-20080628105808-qjjjg12cwhw406lv
Tags: 0.0.20080620-1
* New upstream release
* Update debian/copyright
* Update debian/rules to remove the executable bit from some more plain text
  files

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<html>
2
2
  <head>
3
3
    <title>cube &raquo; Beginners Guide</title>
4
 
    <link rel="stylesheet" href="static/style.css" type="text/css" />
 
4
    <link rel="stylesheet" href="../style.css" type="text/css" />
5
5
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
6
6
  </head>
7
7
  <body>
21
21
<div style="margin-left: 1em;"><a href="#toc12">help on finding help</a></div>
22
22
<div style="margin-left: 2em;"><a href="#toc13">Grrr!</a></div>
23
23
<div style="margin-left: 2em;"><a href="#toc14">You'll see!</a></div>
24
 
<div style="margin-left: 2em;"><a href="#toc15">See?!??</a></div>
25
 
<div style="margin-left: 2em;"><a href="#toc16">Watch! Listen ... and Learn!</a></div>
 
24
<div style="margin-left: 2em;"><a href="#toc15">Tutorials</a></div>
 
25
<div style="margin-left: 2em;"><a href="#toc16">See?!??</a></div>
 
26
<div style="margin-left: 2em;"><a href="#toc17">Watch! Listen ... and Learn!</a></div>
26
27
</div>
27
28
On this page you will get information about your first steps into the project.<br />
28
29
<br />
29
30
<a name="prepreq"></a><br />
30
31
<h1 id="toc0">requirements</h1>
31
 
When you decide to try out Sauerbraten you should be aware of your operating system, your current graphics chipset (manufacturer and card name) and that this project is still &quot;Work in Progress&quot; (WiP)!<br />
 
32
 When you decide to try out Sauerbraten you should be aware of your operating system, your current graphics chipset (manufacturer and card name) and that this project is still &quot;Work in Progress&quot; (WiP)!<br />
32
33
<br />
33
34
Typically, to run Sauerbraten at playable speeds on minimum settings, you'll need at least:<br />
34
35
1GHz or higher CPU, 256MB RAM and a GeForce 4 MX or equivalent GPU.<br />
39
40
Before you even download Sauerbraten, make sure you meet the above requirements and have the latest video card drivers installed for your OS. If you're on Linux, make sure you're not using MESA drivers, and if you're on Windows, make sure you're not using the generic drivers.<br />
40
41
<br />
41
42
<h2 id="toc1">graphics cards</h2>
42
 
Be prepared that some graphics cards have problems running with the default configuration.<br />
 
43
 Be prepared that some graphics cards have problems running with the default configuration.<br />
43
44
You should then try to use all toggles to reduce rendering complexity and work yourself up.<br />
44
45
Some example combinations:<br />
45
46
 
52
53
See the <a class="wiki_link" href="Performance%20Guide.html">Performance Guide</a> for an in-depth view at what to tweak.<br />
53
54
<br />
54
55
<h2 id="toc2">platform dependencies</h2>
55
 
Due to platform dependencies some stuff works differently depending on your O/S (operating system).<br />
 
56
 Due to platform dependencies some stuff works differently depending on your O/S (operating system).<br />
56
57
For example on linux users can dynamically change their screen resolution, on Win32 this isn't possible.<br />
57
58
Other aspects include driver issues, file formats (jpg, mp3) and naming (Pic1.jpg is <u>not</u> pic1.JPG)<br />
58
59
<br />
64
65
<br />
65
66
<a name="progstart"></a><br />
66
67
<h1 id="toc3">setup</h1>
67
 
First try running the game out-of-the-box,<br />
 
68
 First try running the game out-of-the-box,<br />
68
69
but in the long run you will want to optimize <a class="wiki_link" href="configuration.html">your setup</a> to your hardware and personal preferences.<br />
69
70
There is a <a class="wiki_link" href="Performance%20Guide.html">plethora of settings</a> for you to do this.<br />
70
71
RTFM : <a class="wiki_link_ext" href="http://sauerbraten.org/docs/config.html" rel="nofollow">config page</a><br />
121
122
<br />
122
123
<a name="download"></a><br />
123
124
<h2 id="toc4">download walk-through</h2>
124
 
Click on the <a class="wiki_link_ext" href="https://sourceforge.net/project/showfiles.php?group_id=102911" rel="nofollow">appropriate download link</a> and select your mirror to download the installation file.<br />
 
125
 Click on the <a class="wiki_link_ext" href="https://sourceforge.net/project/showfiles.php?group_id=102911" rel="nofollow">appropriate download link</a> and select your mirror to download the installation file.<br />
125
126
Currently official clients exist for Win32, *Nix and OS X.<br />
126
127
Pick a local mirror.<br />
127
128
<br />
128
129
<a name="unpacking"></a><br />
129
130
<h2 id="toc5">unpacking</h2>
130
 
 
 
131
 
131
132
<ul>
132
133
    <li>There is an installer wrapper for Win32, execute and follow the well known set of dialogs.</li>
133
134
    <li>On *Nix untar to your favourite location (say /usr/local/sauerbraten), chmod the binaries +x if required.</li>
137
138
<br />
138
139
<a name="autoexec"></a><br />
139
140
<h2 id="toc6">basic configuration</h2>
140
 
Manage your <a class="wiki_link" href="configuration.html">configuration</a> via the &quot;<em>autoexec.cfg</em>&quot;.<br />
 
141
 Manage your <a class="wiki_link" href="configuration.html">configuration</a> via the &quot;<em>autoexec.cfg</em>&quot;.<br />
141
142
If the file does not exist in your base installation folder then create it.<br />
142
143
Two lines are a bare minimum:<br />
143
144
 
162
163
<br />
163
164
<a name="firstrun"></a><br />
164
165
<h3 id="toc7">first run</h3>
165
 
 
 
166
 
166
167
<ul>
167
168
    <li>Win32 : run the sauerbraten.bat</li>
168
169
    <li>*Nix : run the ./sauerbraten_unix script from the base installation folder</li>
197
198
<br />
198
199
<a name="introRUN"></a><br />
199
200
<h1 id="toc8">engine modes</h1>
200
 
<a name="introSP"></a><br />
 
201
 <a name="introSP"></a><br />
201
202
<h2 id="toc9">a look at SP</h2>
202
 
The SinglePlayer (SP) modes of Sauerbraten enable you to play offline against a range of monsters.<br />
 
203
 The SinglePlayer (SP) modes of Sauerbraten enable you to play offline against a range of monsters.<br />
203
204
Start your SP game via the menu or set your mode and an appropriate map by hand.<br />
204
205
Beware that the so-called <tt>Episode 1</tt> does not currently contain monsters. It is still WiP!<br />
205
206
The single maps for basic SP (<tt>mode -2</tt>) <em>do have</em> monsters, though;<br />
221
222
<br />
222
223
<a name="introMP"></a><br />
223
224
<h2 id="toc10">a look at MP</h2>
224
 
The integrated server browser is available via the multiplayer menu, be sure to regularly update from master server.<br />
 
225
 The integrated server browser is available via the multiplayer menu, be sure to regularly update from master server.<br />
225
226
The list is sorted by ping for your convenience.<br />
226
227
A &quot;<strong>P</strong>&quot; next to the number of players indicates a <em>private server</em>.<br />
227
228
A &quot;<strong>L</strong>&quot; next to the number of players stands for <em>locked server</em>.<br />
229
230
<br />
230
231
<a name="introRPG"></a><br />
231
232
<h2 id="toc11">a look at RPG</h2>
232
 
This is still - very much - WiP!<br />
 
233
 This is still - very much - WiP!<br />
233
234
You can have a look at what's cooking by running with a -grpg parameter included.<br />
234
235
So far only some NPC models are visible and the action menu is visible and ready for use. Attacking and trading has been implemented along with an inventory and monetary system, but there is no AI, so nothing fights back. Stay tuned for further progress ...<br />
235
236
...for example <a class="wiki_link" href="Eisenstern%20Modelling.html">Eisenstern Modelling</a>.<br />
236
237
<br />
237
238
<a name="help-yourself"></a><br />
238
239
<h1 id="toc12">help on finding help</h1>
239
 
<br />
 
240
 <br />
240
241
<h2 id="toc13">Grrr!</h2>
241
 
While getting to know a new piece of software it is often the case that you might need help with an aspect you (personally) don't find intuitive.<br />
 
242
 While getting to know a new piece of software it is often the case that you might need help with an aspect you (personally) don't find intuitive.<br />
242
243
This is perfectly natural and nothing to be ashamed of,<br />
243
244
but the way you go about <em>asking for help</em> can be! So here's some help on getting help:<br />
244
245
<br />
245
246
<h2 id="toc14">You'll see!</h2>
246
 
First thing to do is try finding a help ressource,<br />
 
247
 First thing to do is try finding a help resource,<br />
247
248
try a <a class="wiki_link_ext" href="http://www.google.com" rel="nofollow">google search</a>, try a lot of <a class="wiki_link_ext" href="http://www.google.com/help/refinesearch.html" rel="nofollow">different combinations</a> - try news- and code-searches too!<br />
248
249
Try searching this wiki, or the forums.<br />
249
250
<br />
250
251
Your <em>local manual</em> is accessible via the <tt>README.html</tt> in your installation folder;<br />
251
252
the documentation is also available from <a class="wiki_link_ext" href="http://sauerbraten.org/README.html" rel="nofollow">sauerbraten.org</a>.<br />
252
253
<br />
253
 
<h2 id="toc15">See?!??</h2>
254
 
The game is pretty straight-forward to jump into,<br />
 
254
<h2 id="toc15">Tutorials</h2>
 
255
 The Cube/Cube II community is the place to find guides and tutorials. <br />
 
256
Check out <a class="wiki_link_ext" href="http://www.quadropolis.us/taxonomy/term/21" rel="nofollow">the guides on Quadropolis</a>, <br />
 
257
or use one of the wiki pages below:<br />
 
258
<br />
 
259
 
 
260
<ul>
 
261
    <li><a class="wiki_link" href="Mapping%20and%20Editing.html">Mapping and Editing</a></li>
 
262
    <li><a class="wiki_link" href="Cubescript%20Tutorial.html">Cubescript Tutorial</a> (still <tt>Work in progress</tt>)</li>
 
263
    <li><a class="wiki_link" href="Scripting%20Guide.html">Scripting Guide</a> (to be merged with the Tutorials at a later time)</li>
 
264
    <li><a class="wiki_link" href="Modding%20Guide.html">Modding Guide</a></li>
 
265
</ul>
 
266
 
 
267
<br />
 
268
<h2 id="toc16">See?!??</h2>
 
269
 The game is pretty straight-forward to jump into,<br />
255
270
so some people seem to overlook the manual -<br />
256
271
don't make that mistake yourself!<br />
257
272
<br />
265
280
Familiarize yourself with the different aspects that make up the game.<br />
266
281
From OGZ files to CFGs, from ./data/ to ./packages/base/<br />
267
282
<br />
268
 
<h2 id="toc16">Watch! Listen ... and Learn!</h2>
269
 
Even if we first off - as always - hint at RTFM.<br />
 
283
<h2 id="toc17">Watch! Listen ... and Learn!</h2>
 
284
 Even if we first off - as always - hint at RTFM.<br />
270
285
RTFM = Read The Fine Manual<br />
271
286
Even if we hint @ RTFM it seems impossible to stress it hard enough,<br />
272
287
Don't be a <a class="wiki_link_ext" href="http://www.slash7.com/pages" rel="nofollow">Help Vampire</a>.<br />