2003-04-23 14:39:26 -06:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2003-04-22 18:44:03 -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-22 18:44:03 -06:00
|
|
|
<title>FreeCraft Installation</title>
|
2003-04-23 14:39:26 -06:00
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
2003-04-22 18:44:03 -06:00
|
|
|
</head>
|
2003-04-19 21:53:14 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<body>
|
2003-04-19 21:53:14 -06:00
|
|
|
|
2003-04-23 14:39:26 -06:00
|
|
|
<h1>Installation instructions for FreeCraft 1.18</h1><p>
|
2003-04-22 18:44:03 -06:00
|
|
|
<hr>
|
2000-03-25 15:38:54 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<h2>Software Requirements</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><b>A supported operating system:</b> Win32, Linux, Mac OS X, BSD,
|
2003-04-19 21:30:57 -06:00
|
|
|
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
|
2003-04-22 18:44:03 -06:00
|
|
|
<a href="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">here</a>.</font><p>
|
2003-04-19 21:30:57 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li><b>A supported graphics library:</b> SDL, svgalib, X11/Xlib
|
2003-04-19 21:30:57 -06:00
|
|
|
(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-22 18:44:03 -06:00
|
|
|
<li><a href="http://zziplib.sourceforge.net/">zziplib</a> (optional).<p>
|
2003-04-19 21:30:57 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li>Either the original or expansion W*rcr*ft 2 CD, or the FcMP data.<br>
|
2003-04-23 14:39:26 -06:00
|
|
|
<font color="red">NOTE: the Battle.net CD edition is not supported.</font><p>
|
2003-04-22 18:44:03 -06:00
|
|
|
</ul>
|
2002-01-03 16:37:20 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<h2>Hardware Requirements</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><b>Processor:</b> A 133 MHz CPU (faster recommended).<br>
|
2003-04-19 21:30:57 -06:00
|
|
|
<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-22 18:44:03 -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-22 18:44:03 -06:00
|
|
|
<li><b>Video Card:</b> Any graphics card that can handle 8 bpp
|
2003-04-19 21:30:57 -06:00
|
|
|
and 640x480 is supported.<p>
|
2000-03-25 15:38:54 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li><b>Sound Card:</b> Optional. Windows (for Win32) or SDL
|
2003-05-08 17:33:58 -06:00
|
|
|
(for unix or Mac OS X) compatible sound cards are supported.<p>
|
2003-04-22 18:44:03 -06:00
|
|
|
</ul>
|
2000-03-25 15:38:54 -07:00
|
|
|
|
2003-04-22 18:44:03 -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
|
2003-04-23 14:39:26 -06:00
|
|
|
top-level directory and read "Read Me.rtf".<p>
|
2000-03-25 15:38:54 -07:00
|
|
|
|
2003-04-23 14:39:26 -06:00
|
|
|
Binary users may skip to step 3.<p>
|
2001-03-09 10:50:25 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<ul>
|
|
|
|
|
<li><b>Step 1, Download and Extract:</b><p>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<ul>
|
|
|
|
|
<li>Download the source from
|
2003-04-19 21:30:57 -06:00
|
|
|
<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-22 18:44:03 -06:00
|
|
|
<li>Unpack the source freecraft-DATE.tar.gz with
|
2003-04-19 21:30:57 -06:00
|
|
|
<pre> tar -zxvf freecraft-DATE.tar.gz</pre>
|
2003-04-22 18:44:03 -06:00
|
|
|
</ul>
|
2000-03-25 15:38:54 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li><b>Step 2, Compile:</b><p>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<ul>
|
|
|
|
|
<li><b>GCC/Mingw users:</b> run the 'setup' script and answer
|
2003-04-19 21:30:57 -06:00
|
|
|
the questions instructions to create the Makefile.
|
|
|
|
|
When complete, type 'make depend && make' to compile, and it
|
2003-05-03 08:09:58 -06:00
|
|
|
should compile a working 'freecraft' (or 'freecraft.exe' for win32)
|
2003-04-19 21:30:57 -06:00
|
|
|
binary. To see all options of setup, type 'setup --help'.<p>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li><b>MSVC users:</b>
|
|
|
|
|
<ul>
|
2003-04-19 21:30:57 -06:00
|
|
|
<li>Extract the VC++ project and workspace files from freecraft\contrib\msvc.zip
|
2003-04-22 18:44:03 -06:00
|
|
|
into the root freecraft directory.</li>
|
2002-11-29 14:09:09 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li><a href="http://freecraft.sourceforge.net/snapshots/msvc-libs.zip">
|
2003-04-19 21:30:57 -06:00
|
|
|
Download</a> the VC++ libraries and extract them into the root
|
|
|
|
|
freecraft directory.
|
2002-11-29 14:09:09 -07:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<li>Copy freecraft\contrib\freecraft.ico to freecraft\src.
|
|
|
|
|
<li>You should now be able to compile freecraft by opening
|
2003-04-19 21:30:57 -06:00
|
|
|
the freecraft.dsw file.<p>
|
2003-04-22 18:44:03 -06:00
|
|
|
</ul>
|
2003-05-03 08:09:58 -06:00
|
|
|
|
|
|
|
|
<li><b>Windows CE(tm) / PocketPc(tm)</b>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>You need eMbedded Visual C++ 3.0. You can download or order it
|
2003-05-03 13:06:47 -06:00
|
|
|
<a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnppc2k/html/ppc_alc.asp">here</a>.
|
2003-05-03 08:09:58 -06:00
|
|
|
CE support for Visual C++ or Visual Studio isn't supported yet.
|
|
|
|
|
If you know how to compile with this, please inform us.
|
|
|
|
|
<li>You also need the
|
|
|
|
|
<a href="http://freecraft.sourceforge.net/snapshots/win-ce/FreeCraft%20CE.vcp.gz">emVC++ project</a> and
|
|
|
|
|
<a href="http://freecraft.sourceforge.net/snapshots/win-ce/FreeCraft%20CE.vcw.gz">emVC++ workbench</a> for FreeCraft.<p>
|
|
|
|
|
</ul>
|
2003-04-22 18:44:03 -06:00
|
|
|
</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
|
2003-04-23 14:39:26 -06:00
|
|
|
installation, (eg, 'e:' or 'c:\war2').<p>
|
2003-04-19 21:30:57 -06:00
|
|
|
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
|
2003-04-19 22:32:54 -06:00
|
|
|
script from within your root freecraft directory or
|
2003-04-19 21:30:57 -06:00
|
|
|
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
|
2003-04-23 14:39:26 -06:00
|
|
|
binary exists).<br>
|
2003-04-19 21:30:57 -06:00
|
|
|
<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>
|
2003-05-19 12:32:54 -06:00
|
|
|
|
|
|
|
|
If you are using the CVS engine, you may need to checkuot
|
|
|
|
|
the 'fcmp' module from CVS. Then edit the locations at the top
|
|
|
|
|
of 'buildfcmp.sh' and run it, this will create a working
|
|
|
|
|
FcMP dir called: 'data.fcmp' , you may then rename this to
|
|
|
|
|
'$FCDIR/data' where $FCDIR is the directory where the freecraft
|
|
|
|
|
binary exists, or run freecraft with the '-d' option.<p>
|
2003-04-19 21:30:57 -06:00
|
|
|
</ul>
|
2003-05-19 12:32:54 -06:00
|
|
|
|
|
|
|
|
<li><b>Step 4, Run:</b><p>
|
|
|
|
|
|
2003-05-19 13:03:40 -06:00
|
|
|
You may now go into the toplevel freecraft dir and run the binary. Remember,
|
2003-05-19 12:32:54 -06:00
|
|
|
if the data dir is not './data', you will need to run freecraft with
|
|
|
|
|
the '-d' option.<p>
|
2003-04-22 18:44:03 -06:00
|
|
|
</ul>
|
2001-06-29 08:04:25 -06:00
|
|
|
|
2003-04-22 18:44:03 -06:00
|
|
|
<hr>
|
2003-05-19 12:32:54 -06:00
|
|
|
(C) Copyright 1998-2003 by The <a href="http://freecraft.sf.net">FreeCraft</a> Project
|
2003-04-23 14:39:26 -06:00
|
|
|
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>
|
2003-04-22 18:44:03 -06:00
|
|
|
</body>
|
|
|
|
|
</html>
|
