1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
---- (c) Copyright 2002-2013 by Nehal Mistry, Francois Beerten.
---- This program is free software; you can redistribute it and/or modify
---- it under the terms of the GNU General Public License as published by
---- the Free Software Foundation; only version 2 of the License.
----
---- This program is distributed in the hope that it will be useful,
---- but WITHOUT ANY WARRANTY; without even the implied warranty of
---- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
---- GNU General Public License for more details.
----
---- You should have received a copy of the GNU General Public License
---- along with this program; if not, write to the Free Software
---- Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
---- 02111-1307, USA.
-->
<title>Bos Wars Installation</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<h1>Installation instructions for Bos Wars</h1>
<h2>Hardware Requirements</h2>
<ul>
<li><b>Processor:</b> A 300 MHz CPU (faster recommended).<br>
NOTE: Bos Wars is believed to be endian and word size safe, so other
architectures like (big endian) PPC or (64bit) Alpha should also
work, at least with Linux.</li>
<li><b>Memory:</b> 128 MB of RAM (more is better).</li>
<li><b>Video Card:</b> Any graphics card that can handle 16 bpp or 32 bpp
and 640x480 is supported. (OpenGL is supported, and requires a 32MB Card)</li>
<li><b>Sound Card:</b> Recommended. SDL compatible sound cards are supported.</li>
</ul>
<h2>Software Requirements</h2>
<ul>
<li><b>A supported operating system:</b> Linux or Microsoft Windows (2000 or higher).
Possibly any other Unix/POSIX OS.
</li>
<li><a href="http://www.libsdl.org/index.php">SDL</a> (required).</li>
<li><a href="http://www.libpng.org/pub/png/">libpng</a> (required).</li>
<li><a href="http://www.gzip.org/zlib/">zlib</a> (required).</li>
<li><a href="http://www.lua.org/">Lua 5.1</a> (required).</li>
<li><a href="http://www.xiph.org/downloads/">libvorbis</a> (recommended).</li>
<li><a href="http://www.theora.org/">libtheora</a> (recommended).</li>
<li><a href="http://www.xiph.org/downloads/">libogg</a> (recommended).</li>
</ul>
<p>
On Debian based distributions, you can easily obtain the required dependencies by installing the following packages:
libsdl liblua5.1 libtheora libogg libpng12 libsdl1.2 libvorbis libgl1-mesa
</p>
<p>
On OpenSuse you can obtain the required dependencies by installing with the following command line:<pre>
zypper in libSDL-devel lua51-devel libogg-devel
</pre>
</p>
<h2>Running Bos Wars</h2>
Run the boswars binary in the root boswars direcory.
By default, the engine looks in the current working directory,
if your data is in a different location you
will need to run boswars with <i>'-d /path_to_data'</i>.<p>
<h1>Build instructions for Bos Wars</h1>
<h2>Software Requirements for Development</h2>
In addition to the software requirements listed above, you will also need:
<ul>
<li>Compiler suite: GCC or MINGW or MSVC</li>
<li>The development files for the libraries listed above.</li>
<li><a href="http://www.codenix.com/~tolua/">toLua++</a> version 1.0.93 if you plan to change the Lua API</li>
</ul>
<p>
On Debian based distributions, you can easily obtain the required dependencies by installing
the following packages: <i>liblua5.1-dev libtolua++5.1-dev libtheora-dev libogg-dev
libpng12-dev libsdl1.2-dev libvorbis-dev libx11-dev libgl1-mesa-dev
x11proto-core-dev build-essential.</i>
</p>
<p>
On Fedora 13, these packages should help: <i>lua-devel
tolua++-devel libtheora-devel libogg-devel libpng-devel SDL-devel
libvorbis-devel libX11-devel mesa-libGL-devel</i>.
</p>
<h2>Building</h2>
<h3>Step 1: Download and Extract:</h3>
<ul>
<li><a href="http://www.boswars.org/download.shtml">
Download</a> the source code.</li>
<li>Extract the source boswars-version.tar.gz with
'tar -xzvf boswars-DATE.tar.gz'</li>
</ul>
Alternatively you can get the latest <a href="http://www.boswars.org/development.shtml">
development version</a> from subversion.
<h3>Step 2: Generate toLua binding</h3>
If you changed one of the pkg files in engine/tolua, you must rerun
the tolua++ tool in the engine/tolua directory:
<pre>
tolua++ -L stratagus.lua -o tolua.cpp stratagus.pkg
</pre>
If you did not change the pkg files, you can safely skip this step.
<h3>Step 3: Compile:</h3>
<ul>
<li><b>On Posix systems like Linux:</b>
<ul>
<li>Run 'make.py' for the release build.</li>
<li>Run 'make.py debug' for the debug build.</li>
</ul>
The build results are stored in the <i>fbuild/</i> directory.
</li>
<li><b>Microsoft Visual Studio 2005:</b>
<ul>
<li><a href="http://www.boswars.org/dev/msvc-libs.zip">
Download</a> the precompiled VC++ libraries and extract them into the root
boswars directory. You can also fetch all the libs and
compile them manually if you want.</li>
<li>Open the workspace file boswars.sln and compile.</li>
</ul>
</li>
</ul>
<br>
<hr>
(C) Copyright 1998-2013 by The <a href="http://boswars.org">Bos Wars</a> Project
under the <a href="gpl.html">GNU General Public License</a>.<br>
All trademarks and copyrights on this page are owned by their respective owners.<br>
</body>
</html>
|
