2003-04-19 21:30:57 -06:00
|
|
|
<HTML>
|
|
|
|
<HEAD>
|
2000-03-25 15:38:54 -07:00
|
|
|
<!--
|
|
|
|
---- $Id$
|
2001-05-30 08:26:35 -06:00
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
-->
|
2003-04-19 21:30:57 -06: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>
|
2002-01-03 16:37:20 -07:00
|
|
|
<UL>
|
2003-04-19 21:30:57 -06:00
|
|
|
<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>
|
2003-04-19 21:30:57 -06:00
|
|
|
<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>
|
2002-01-03 16:37:20 -07:00
|
|
|
</UL>
|
|
|
|
|
2003-04-19 21:30:57 -06:00
|
|
|
<H2>Hardware Requirements</H2>
|
2002-01-03 16:37:20 -07:00
|
|
|
<UL>
|
2003-04-19 21:30:57 -06:00
|
|
|
<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
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -06: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
|
|
|
|
2003-04-19 21:30:57 -06:00
|
|
|
<H2>Installation</H2>
|
2002-05-24 08:15:12 -06:00
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -06:00
|
|
|
Binary users may skip to step 3<p>
|
2001-03-09 10:50:25 -07:00
|
|
|
|
2003-04-19 21:30:57 -06:00
|
|
|
<UL>
|
|
|
|
<LI><b>Step 1, Download and Extract:</b><p>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -06:00
|
|
|
<LI><b>Step 2, Compile:</b><p>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -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
|
|
|
|
2003-04-19 21:30:57 -06: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
|
|
|
|
2003-04-19 21:30:57 -06: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
|
|
|
|
2003-04-19 21:30:57 -06: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.
|
2003-04-19 21:30:57 -06:00
|
|
|
<ADDRESS><A HREF="http://freecraft.sourceforge.net">The FreeCraft Project</A>
|
|
|
|
</ADDRESS>
|
|
|
|
</BODY>
|
|
|
|
</HTML>
|