Gobligine/doc/install.html

153 lines
5.6 KiB
HTML
Raw Normal View History

<HTML>
<HEAD>
2000-03-25 15:38:54 -07:00
<!--
---- $Id$
2001-05-30 08:26:35 -06:00
---- (c) Copyright 2002-2003 by Nehal Mistry.
2001-05-30 08:26:35 -06:00
---- FreeCraft is free software; you can redistribute it and/or modify
---- it under the terms of the GNU General Public License as published by
2002-05-13 15:00:35 -06:00
---- the Free Software Foundation; only version 2 of the License.
2001-05-30 08:26:35 -06:00
---- FreeCraft 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.
2000-03-25 15:38:54 -07:00
-->
<TITLE>FreeCraft Installation</TITLE>
2000-03-25 15:38:54 -07:00
</HEAD>
2003-04-19 21:53:14 -06:00
2000-03-25 15:38:54 -07:00
<BODY>
2003-04-19 21:53:14 -06:00
<H1>Installation instructions for FreeCraft 1.18</H1><p>
<B>(C) Copyright 1998-2003 by The FreeCraft Project. Distributed under the
<A HREF="gpl.html">GNU General Public License</A></B>
2000-03-25 15:38:54 -07:00
<HR>
<H2>Software Requirements</H2>
<UL>
<LI><b>A supported operating system:</b> Win32, Linux, Mac OS X, BSD,
Possibly any other Unix/POSIX OS.<br>
<font color=red>NOTE: some features of Winsock2 (WS2_32.DLL) are used. So even
if you plan to play single player only,
WinNT4.0 users will need Service Pack 3 or higher and Windows 95 users
will need the winsock 2 update from
<A HREF="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">here</A>.</font><p>
<LI><b>A supported graphics library:</b> SDL, svgalib, X11/Xlib
(although X11 is supported, SDL is recommended).<br>
<font color=red>NOTE: remote displays aren't supported.</font><p>
2003-04-19 21:53:14 -06:00
<li><a href="http://www.libpng.org/pub/png/">libpng</a> (required).<p>
<li><a href="http://www.gzip.org/zlib/">zlib</a> (required).<p>
<li><a href="http://www.xiph.org/ogg/vorbis/">libogg/libvorbis</a> (recommended).<p>
<li><a href="http://sources.redhat.com/bzip2/">libbzip2</a> (optional).<p>
<li><a href="http://flac.sourceforge.net/">libFLAC</a> (optional).<p>
<li><a href="http://www.underbit.com/products/mad/">libmad</a> (optional).<p>
<LI><a href="http://zziplib.sourceforge.net/">zziplib</a> (optional).<p>
<LI>Either the original or expansion W*rcr*ft 2 CD, or the FcMP data.<br>
<font color="red">NOTE: the Battle.net CD edition is not supported</font><p>
</UL>
<H2>Hardware Requirements</H2>
<UL>
<LI><b>Processor:</b> A 133 MHz CPU (faster recommended).<br>
<font color="red">NOTE: FreeCraft 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.</font><p>
2001-04-09 02:01:27 -06:00
<LI><b>Memory:</b> 16 MB of RAM (32 MB for mp3/ogg support).<br><p>
2001-04-09 02:01:27 -06:00
<LI><b>Video Card:</b> Any graphics card that can handle 8 bpp
and 640x480 is supported.<p>
2000-03-25 15:38:54 -07:00
<LI><b>Sound Card:</b> Optional. Windows (for Win32) or SDL
(for unix) compatible sound cards are supported.<p>
</UL>
2000-03-25 15:38:54 -07:00
<H2>Installation</H2>
2002-05-24 08:15:12 -06:00
Mac OS X users: Extract the "contrib/macosx.tgz" file to the
top-level directory and read "Read Me.rtf"<p>
2000-03-25 15:38:54 -07:00
Binary users may skip to step 3<p>
<UL>
<LI><b>Step 1, Download and Extract:</b><p>
2001-06-29 08:04:25 -06:00
<UL>
<LI>Download the source from
<a href="http://freecraft.sourceforge.net/download.html">here</a>.<br>
<font color="red">NOTE: both the tar.gz and zip files are the same,
we provide both formats for convenience.</font><p>
2001-06-29 08:04:25 -06:00
<LI>Unpack the source freecraft-DATE.tar.gz with
<pre> tar -zxvf freecraft-DATE.tar.gz</pre>
</UL>
2000-03-25 15:38:54 -07:00
<LI><b>Step 2, Compile:</b><p>
2001-06-29 08:04:25 -06:00
<UL>
<LI><b>GCC/Mingw users:</b> run the 'setup' script and answer
the questions instructions to create the Makefile.
When complete, type 'make depend && make' to compile, and it
should compile a working 'freecraft' ('freecraft.exe' for win32)
binary. To see all options of setup, type 'setup --help'.<p>
2001-06-29 08:04:25 -06:00
<LI><b>MSVC users:</b>
<UL>
<li>Extract the VC++ project and workspace files from freecraft\contrib\msvc.zip
into the root freecraft directory.</LI>
2002-11-29 14:09:09 -07:00
<LI><a href="http://freecraft.sourceforge.net/snapshots/msvc-libs.zip">
Download</a> the VC++ libraries and extract them into the root
freecraft directory.
2002-11-29 14:09:09 -07:00
<LI>Copy freecraft\contrib\freecraft.ico to freecraft\src.
<LI>You should now be able to compile freecraft by opening
the freecraft.dsw file.<p>
</UL>
</UL>
2002-11-29 14:09:09 -07:00
<li><b>Step 3, Extract data:</b><p>
Now that you have a working engine, you need some media data before
you can actually play the game. There are two options, use the data
from the W*rcr*ft 2 CD, or use FcMP.<p>
<ul>
<li><b>Using W*rcr*ft 2 data:</b><p>
For Win32, run:
<pre> build.bat DIR</pre>
where DIR is the directory to your CD or your
installation, (eg, 'e:\' or 'c:\war2\').<p>
For Unix, run:
<pre> build.sh -p DIR</pre>
where DIR is the directory to your mounted CD or your
installation, (eg, '/cdrom/' or '/mnt/win/war2').<p>
<font color="red">NOTE: You will need to execute this
script from withing your root freecraft directory or
you will run into problems. It will take some
time to extract everything.</font><p>
<li><b>Using FcMP data:</b><p>
Download FcMP from the download page and extract it to
the freecraft root directory (where the freecraft
binary exists)<br>
<font color="red">NOTE if you extract to a different directory,
you will need to specify the directory by passing '-d DIR' flag
when you run the freecraft binary, by default the binary
looks for 'data' in the current directory.</font><p>
</ul>
</UL>
</ul>
2001-06-29 08:04:25 -06:00
2000-03-25 15:38:54 -07:00
<HR>
All trademarks and copyrights on this page are owned by their respective owners.
<ADDRESS><A HREF="http://freecraft.sourceforge.net">The FreeCraft Project</A>
</ADDRESS>
</BODY>
</HTML>