Gobligine/doc/install.html

443 lines
18 KiB
HTML
Raw Normal View History

2001-05-30 08:26:35 -06:00
<HTML><HEAD>
2000-03-25 15:38:54 -07:00
<!--
---- $Id$
2001-05-30 08:26:35 -06:00
2002-01-16 17:47:29 -07:00
---- (c) Copyright 2002 by Lutz Sammer, Alex.
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
-->
2000-04-03 16:57:37 -06:00
<TITLE>INSTALL: The FreeCraft (fka ALE Clone) Version 1.17</TITLE>
2000-03-25 15:38:54 -07:00
</HEAD>
<BODY>
2000-04-03 16:57:37 -06:00
<H1>INSTALL: The FreeCraft (fka ALE Clone) Version 1.17</H1>
2000-03-25 15:38:54 -07:00
<HR><PRE WIDTH=80>
___________ _________ _____ __
\_ _____/______ ____ ____ \_ ___ \____________ _/ ____\/ |_
| __) \_ __ \_/ __ \_/ __ \/ \ \/\_ __ \__ \\ __\\ __\
| \ | | \/\ ___/\ ___/\ \____| | \// __ \| | | |
\___ / |__| \___ >\___ >\______ /|__| (____ /__| |__|
\/ \/ \/ \/ \/
______________________ ______________________
T H E W A R B E G I N S
FreeCraft - A free fantasy real time strategy game engine
</PRE>
2002-01-16 17:47:29 -07:00
<P><B>(C) Copyright 1998-2002 by The FreeCraft Project. Distributed under the
2001-05-30 08:26:35 -06:00
<A HREF="gpl.html">"GNU General Public License"</A></B>
2000-03-25 15:38:54 -07:00
<HR>
<A HREF="#unix-src">Install Unix source</A>
<A HREF="#unix-bin">Install Unix binary</A>
<A HREF="#win32-src">Install Win32 source</A>
<A HREF="#win32-bin">Install Win32 binary</A>
<H2>Software Requirements</H2>
You need:
<UL>
<LI>Operating system:
2000-03-25 15:38:54 -07:00
<UL>
2001-04-09 10:20:48 -06:00
<LI>Linux System with an installed X Windows System.
2000-03-25 15:38:54 -07:00
<LI>Linux System with console (graphic card) supported by svgalib.
2001-04-09 10:20:48 -06:00
<LI>Any BSD System with an installed X Windows System.
<LI>Maybe any other Unix/POSIX OS with X Windows System installed.
2001-05-30 08:26:35 -06:00
You may have to create the configuration by hand and install
additional non-common libraries (see below) and gcc (untested).
2001-04-09 10:20:48 -06:00
<LI>BeOS System with an installed X Windows System.
<LI>MacOS System with an installed X Windows System.
2001-04-15 04:23:15 -06:00
<LI>X Windows System with 8/15/16/24/32bit X Server.
2001-05-30 08:26:35 -06:00
Remote displays aren't supported!
2002-03-01 18:30:59 -07:00
<LI>On Unix/BSD-like systems, you'll need bash for the setup script.
<LI>Win32 system: Win95, Win98, WinME, WinNT or Win2000.
2001-04-09 10:20:48 -06:00
<UL>
2002-03-01 18:30:59 -07:00
<LI>For network play, Win95 OSR2 (aka Win95b) or higher is required,
2002-01-05 05:47:10 -07:00
since some features of Winsock2 (WS2_32.DLL) are used. We will try
to emulate this using WSOCK32.DLL features in future versions, but
that code is not in yet.<BR>
For now this MS <A HREF="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">download</A> link might help. You must
install WS2_32.DLL even if you don't intend to play over a network,
otherwise FreeCraft won't start.
2002-03-01 18:30:59 -07:00
<LI>WinNT needs to be WinNT4.0 + Service Pack 3 or higher, for the same
2001-05-30 08:26:35 -06:00
reasons.
2002-03-01 18:30:59 -07:00
<LI>Please note that WinXP is <I>not</I> supported for various incompatibilities
2002-01-05 05:47:10 -07:00
and most likely will never be.
2001-04-09 10:20:48 -06:00
</UL>
2000-03-25 15:38:54 -07:00
</UL>
2002-05-13 15:00:35 -06:00
<LI>libpng. (I use libpng-2.1, aka 1.0.12)
<LI>zlib. (Also needed for libpng, I use libz-1.1.4)
2000-03-25 15:38:54 -07:00
<LI>SIOD. (Included in the distribution)
<LI>The original game CD or expansion CD for manuals and maindat.war
for graphics and sfxdat.sud for sounds.
2002-05-13 15:00:35 -06:00
<BR>Or use the free replacements of graphics and sounds from the
FreeCraft Media Project.
2000-03-25 15:38:54 -07:00
</UL>
These are optional:
<UL>
2001-06-29 08:04:25 -06:00
<LI>libpthread (For threaded sound support)
2000-03-25 15:38:54 -07:00
<LI>SVGALib (for console support)
<LI>SDL (Additional SDK support)
2001-06-29 08:04:25 -06:00
<LI>Bzip2 (Freely available, high-quality data compressor)
<LI>ZZIPlib (Read access on ZIP-archives)
2000-03-25 15:38:54 -07:00
</UL>
<H2>Hardware Requirements</H2>
To use this program you need the following hardware:
<UL>
2002-05-13 15:00:35 -06:00
<LI>At least an i586 133 MHz (faster recommended) and 16 MB of RAM
(32 MB for mp3/ogg support).
2002-03-01 18:30:59 -07:00
<LI>Any graphic card running with X11 or SVGALib or Win32 in 640x480.
2002-05-13 15:00:35 -06:00
<LI>with 8/16/24/32 bpp video modes working.
<LI>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.
2000-03-25 15:38:54 -07:00
</UL>
<H2>Installation</H2>
<H3>Unix or BSD</H3>
<A NAME="unix-src"></A>
<H4>Unix or BSD source</H4>
Please follow the following instructions to get a working program.
2000-03-25 15:38:54 -07:00
<UL>
2000-04-03 16:57:37 -06:00
<LI>Unpack the archive freecraft-'data'.tar.gz to any directory.
2000-03-25 15:38:54 -07:00
(stored <B>with</B> path)
2002-03-01 18:30:59 -07:00
<LI>Change to the top-level directory (cd freecraft-'date').
2000-03-25 15:38:54 -07:00
<LI>Read <A HREF="install.html">doc/install.html</A>.
<LI>Install the required libraries (development version!).
<LI>You own the original:
<UL>
2000-04-01 17:32:18 -07:00
<LI>Search the files maindat.war, sfxdat.sud,strdat.war and rezdat.war
from the original game.
2000-03-25 15:38:54 -07:00
<B>This version supports the original or expansion CD!</B>
2001-04-12 12:35:15 -06:00
If you have only the original CD, it should also work, ignore the
2000-03-25 15:38:54 -07:00
warnings.
<LI>Edit tools/build.sh, and change ARCHIVE to the correct path.
(You could use an installed version or the CD-ROM)
2002-03-01 18:30:59 -07:00
Extract from "/cdrom" is the default. Just mount your CD on /cdrom.
2000-03-25 15:38:54 -07:00
</UL>
2002-01-16 17:47:29 -07:00
<LI><B>With the media from the FreeCraft Media Project:</B>
2000-03-25 15:38:54 -07:00
<UL>
2002-05-13 15:00:35 -06:00
<LI>FcGP (graphic) and FcSP (sound) are now combined in the FcMP
(media) archive.
<LI>Take the archive with the same version as the FreeCraft source.
<LI>FIXME: for final version add the direct download link.
<LI>Download FcMP from <A HREF="http://FreeCraft.Org/download.html">
FreeCraft - Download</A>
<LI>Extract it into the freecraft source directory. It overwrites the
content of data which is only needed with the original CD.
<LI>Read "readme" file that is in the archive for further
instructions on how to setup the graphics and sounds packs.
Note: The current version didn't contain it.
2000-03-25 15:38:54 -07:00
</UL>
<LI>Copy Rules.make.orig to Rules.make and edit it or run the setup
script.
<LI>Type "./setup" to configure the graphics, sound, and compression
options.
<UL>
<LI>"./setup --help" shows a list of available setup options
<LI>You have the option of running "make" from the script,
bypassing the next step.
</UL>
<LI>If you have the original type "make buildit" or
". tools/build.sh", to extract and convert the needed graphics,
sounds and puds. (You need to run this only once!)
<LI>Now it's time for a coffee break.
2000-04-01 17:32:18 -07:00
<LI>Type "make". (Should compile without errors :-)
2000-03-25 15:38:54 -07:00
<LI>Optional:
<UL>
<LI>Edit "data/ccl/freecraft.ccl" to configure FreeCraft
2002-05-13 15:00:35 -06:00
for your own needs.
2000-03-25 15:38:54 -07:00
</UL>
2000-04-03 16:57:37 -06:00
<LI>Now you could start with "./freecraft".
2000-03-25 15:38:54 -07:00
<LI>That's all, I hope you have enjoyed the game.
<LI>If you find any bug, look in
<A HREF="todo.html">todo.html</A>
if it is already known, if not please mail it to
<A HREF="mailto:aleclone@FreeCraft.org">The FreeCraft Project</A>.
<LI>ADVANCED: Type "make help" for more compile options.
<P>
2002-03-01 18:30:59 -07:00
<LI>If you get killed everytime by the computer, let the AI sleep with
2001-04-09 10:20:48 -06:00
the command line option "-s n" (sleep n frames) or set the build
2000-04-01 17:32:18 -07:00
costs and build times of the computer with -f 110 and -t 110 higher.
2000-03-25 15:38:54 -07:00
</UL>
<H4>Unix or BSD binary</H4>
<A NAME="unix-bin"></A>
Please follow the following instructions to get a working program.
<UL>
<LI>Download the binary version from the web page.
<LI>Unpack it into a directory of your choice (~/freecraft)
<LI>Open a shell.
<LI>Change to the top level directory. ("cd ~/freecraft")
<LI>You own the original:
<UL>
<LI>Search the files maindat.war, sfxdat.sud,strdat.war and rezdat.war
from the original game.
<B>This version supports the original or expansion CD!</B>
If you have only the original CD, it should also work, ignore the
warnings.
<LI>Edit tools/build.sh, and change ARCHIVE to the correct path.
(You could use an installed version or the CD-ROM)
Extract from "/cdrom" is the default. Just mount your cd to /cdrom.
</UL>
2002-01-16 17:47:29 -07:00
<LI><B>With the media from the FreeCraft Media Project:</B>
<UL>
2002-05-13 15:00:35 -06:00
<LI>FcGP (graphic) and FcSP (sound) are now combined in the FcMP
(media) archive.
<LI>Take the archive with the same version as the FreeCraft source.
<LI>FIXME: for final version add the direct download link.
<LI>Download FcMP from <A HREF="http://FreeCraft.Org/download.html">
FreeCraft - Download</A>
<LI>Extract it into the freecraft source directory. It overwrites the
content of data which is only needed with the original CD.
<LI>Read "readme" file that is in the archive for further
instructions on how to setup the graphics and sounds packs.
Note: The current version didn't contain it.
2002-01-16 17:47:29 -07:00
</UL>
2002-05-13 15:00:35 -06:00
<LI>Now you could enter "./freecraft" to play.
<LI>That's all, I hope you have enjoyed the game.
<LI>If you find any bug, look in
<A HREF="todo.html">todo.html</A>
if it is already known, if not please mail it to
<A HREF="mailto:aleclone@FreeCraft.org">The FreeCraft Project</A>.
<P>
<LI>If you get killed everytime by the computer, let the ai sleep with
the command line option "-s n" (sleep n frames) or set the build
costs and build times of the computer with -f 110 and -t 110 higher.
</UL>
<H3>Win32</H3>
<A NAME="win32-src"></A>
<H4>Win32 source</H4>
Please follow the following instructions to get a working program. <br>
<b>Note:</b> If you have not used mingw32 before, remember that in the
2002-05-13 15:00:35 -06:00
shell that comes with it, you must type '/' instead of '\' in path names.
<UL>
<LI>If you do not have a gnu compiler (eg. mingw32) then download the
2002-05-13 15:00:35 -06:00
mingw-fc-native-'date'.zip or freecraft-compiler-'date'.zip archive from
<a href="http://sourceforge.net/project/showfiles.php?group_id=1965&release_id=46537">this page.</a>
Unzip it into to the C:\ directory.
<LI>Download freecraft-'date'.zip and unzip it into any directory.
2002-01-05 05:47:10 -07:00
<LI>Install all required libraries. (If you downloaded mingw32 from the link
above you should not need to do this)
<LI>Open a shell. (run mingw32.bat)
<LI>Change to the top level freecraft directory. (cd /freecraft)
<LI><B>You own the original:</B>
<UL>
<LI>Edit tools\build.bat to meet your requirements.<BR>
If your original cdrom is in drive D:\, you didn't need to edit.
<LI>Run tools\build.bat from the FreeCraft toplevel directory.<BR>
This extracts the graphics and sound from the original data files.
</UL>
2002-01-16 17:47:29 -07:00
<LI><B>With the media from the FreeCraft Media Project:</B>
<UL>
2002-05-13 15:00:35 -06:00
<LI>FcGP (graphic) and FcSP (sound) are now combined in the FcMP
(media) archive.
<LI>Take the archive with the same version as the FreeCraft source.
<LI>FIXME: for final version add the direct download link.
<LI>Download FcMP from <A HREF="http://FreeCraft.Org/download.html">
FreeCraft - Download</A>
<LI>Extract it into the freecraft source directory. It overwrites the
content of data which is only needed with the original CD.
<LI>Read "readme" file that is in the archive for further
instructions on how to setup the graphics and sounds packs.
Note: The current version didn't contain it.
</UL>
2002-05-13 15:00:35 -06:00
<LI>Copy Rules.make.orig to Rules.make and edit it or run the setup
script.
<LI>Type "./setup" to configure the graphics, sound, and compression
options.
<UL>
<LI>"./setup --help" shows a list of available setup options
<LI>You have the option of running "make" from the script,
bypassing the next step.
</UL>
<LI>Enter "freecraft" to play.
<LI>If you have problems look into <A HREF="../stdout.txt">stdout.txt</A>
or <A HREF="../stderr.txt">stderr.txt</A> for more information.
<LI>That's all, I hope you have enjoyed the game.
<LI>If you find any bug, look in
<A HREF="todo.html">todo.html</A>
if it is already known, if not please mail it to
<A HREF="mailto:aleclone@FreeCraft.org">The FreeCraft Project</A>.
<LI>ADVANCED: Type "make help" for more compile options.
<P>
<LI>If you get killed everytime by the computer, let the ai sleep with
the command line option "-s n" (sleep n frames) or set the build
costs and build times of the computer with -f 110 and -t 110 higher.
</UL>
<H4>Win32 binary</H4>
<A NAME="win32-bin"></A>
Please follow the following instructions to get a working program.
<UL>
<LI>Download the binary version from the web page.
2002-03-01 18:30:59 -07:00
<LI>Unzip it into a directory of your choice (C:\games\FreeCraft).
<LI>Open a DOS shell.
<LI>Enter "cd c:\games\FreeCr~1"
<LI><B>You own the original:</B>
<UL>
<LI>Edit tools\build.bat to meet your requirements.<BR>
If your original cdrom is in drive D:\, you didn't need to edit.
<LI>Run tools\build.bat from the FreeCraft toplevel directory.<BR>
This extracts the graphics and sound from the original data files.
</UL>
2002-01-16 17:47:29 -07:00
<LI><B>With the media from the FreeCraft Media Project:</B>
<UL>
2002-05-13 15:00:35 -06:00
<LI>FcGP (graphic) and FcSP (sound) are now combined in the FcMP
(media) archive.
<LI>Take the archive with the same version as the FreeCraft source.
<LI>FIXME: for final version add the direct download link.
<LI>Download FcMP from <A HREF="http://FreeCraft.Org/download.html">
FreeCraft - Download</A>
<LI>Extract it into the freecraft source directory. It overwrites the
content of data which is only needed with the original CD.
<LI>Read "readme" file that is in the archive for further
instructions on how to setup the graphics and sounds packs.
Note: The current version didn't contain it.
</UL>
<LI>Enter "freecraft" to play.
<LI>If you have problems look into <A HREF="../stdout.txt">stdout.txt</A>
or <A HREF="../stderr.txt">stderr.txt</A> for more information.
<LI>That's all, I hope you have enjoyed the game.
<LI>If you find any bug, look in
<A HREF="todo.html">todo.html</A>
if it is already known, if not please mail it to
<A HREF="mailto:aleclone@FreeCraft.org">The FreeCraft Project</A>.
<P>
<LI>If you get killed everytime by the computer, let the ai sleep with
the command line option "-s n" (sleep n frames) or set the build
costs and build times of the computer with -f 110 and -t 110 higher.
</UL>
2000-03-25 15:38:54 -07:00
<H2>SVGALib support = console</H2>
<P>Make sure that you have installed the SVGALib development kit. The setup
script should take care of the rest.
<P>You can find more information and the source on the
<A HREF="http://www.svgalib.org/">SVGALIB home</A>
<H2>SDL (Simple DirectMedia Layer) support</H2>
<P>Make sure that you have installed the SDLlib development kit. The setup
script should take care of the rest.
<P>You can find more information and the source on the
<A HREF="http://www.devolution.com/~slouken/SDL/">
Simple DirectMedia Layer Home</A>
2002-05-13 15:00:35 -06:00
<H2>Prepare multiplayer play</H2>
2000-03-25 15:38:54 -07:00
2002-05-13 15:00:35 -06:00
You can play FreeCraft via network or internet or may run 2 or more clients on
the same computer. Install it on all computers with the above instructions.
2001-04-09 02:01:27 -06:00
You can now start it on each computer with:
2002-05-13 15:00:35 -06:00
<H3>First you need a server:</H3>
2000-03-25 15:38:54 -07:00
2002-05-13 15:00:35 -06:00
<I>freecraft -p [players] [map]</I><P>
2001-04-09 02:01:27 -06:00
freecraft -p 2 ./data/puds/multi/3vs3.pud.gz
2002-05-13 15:00:35 -06:00
<P>After the title screen, the game waits with black screen until all players
are connected.
Press ALT-'q' to quit the game.
2001-04-09 02:01:27 -06:00
2002-05-13 15:00:35 -06:00
<H3>Than you need the clients:</H3>
2001-04-09 02:01:27 -06:00
2002-05-13 15:00:35 -06:00
<I>freecraft -n [server] [map]</I><P>
2001-04-09 02:01:27 -06:00
freecraft -n localhost ./data/puds/multi/3vs3.pud.gz
2000-03-25 15:38:54 -07:00
2002-05-13 15:00:35 -06:00
<P>[server] may be the hostname (e.g. www.freecraft.org) or the IP address
(e.g. 192.168.0.1.) of the game server. The map must be the same on all
computers.
2000-03-25 15:38:54 -07:00
<H2>Hints</H2>
2001-06-29 08:04:25 -06:00
<UL>
2001-09-27 17:25:50 -06:00
<LI>To run setup, if bash isn't in /bin installed use
"bash -c ". ./setup" .
2002-05-13 15:00:35 -06:00
<P><LI>To run make, if gmake isn't called make, use
2001-09-27 17:25:50 -06:00
"gmake MAKE=gmake" .
2002-05-13 15:00:35 -06:00
<P><LI>You can get support on our forums, mailing lists and IRC channel.
<P><LI>You find the FreeCraft Media Project here:<BR>
2002-01-16 17:47:29 -07:00
<A HREF="http://FreeCraft.Net/fcmp/">The FreeCraft Media Project</A>
2000-03-25 15:38:54 -07:00
2002-03-01 18:30:59 -07:00
<P><LI>You'll get libpng and libz here:<BR>
2000-03-25 15:38:54 -07:00
<A HREF="ftp://ftp.uu.net/graphics/png">
ftp://ftp.uu.net/graphics/png
</A>
<P>Alternative: <A HREF="ftp://swrinde.nde.swri.edu/pub/png/src/">
ftp://swrinde.nde.swri.edu/pub/png/src/
</A>
<P>Please see the PNG homepage for more information:<BR>
2001-06-29 15:38:22 -06:00
<A HREF="http://www.libpng.org/pub/png/">
http://www.libpng.org/pub/png/
</A>
or
<A HREF="ftp://ftp.freesoftware.com/pub/png">
ftp://ftp.freesoftware.com/pub/png
2000-03-25 15:38:54 -07:00
</A>
2002-03-01 18:30:59 -07:00
<P>You can also look at the zlib homepage for more information:<BR>
2001-06-29 15:38:22 -06:00
<A HREF="http://www.freesoftware.com/pub/infozip/zlib/zlib.html">
http://www.freesoftware.com/pub/infozip/zlib/zlib.html
2000-03-25 15:38:54 -07:00
</A>
2001-06-29 15:38:22 -06:00
or
<A HREF="http://www.gzip.org/zlib/">http://www.gzip.org/zlib/</A>
2000-03-25 15:38:54 -07:00
2002-03-01 18:30:59 -07:00
<P><LI>You'll get pthread here:<BR>
2000-03-25 15:38:54 -07:00
Please see the LinuxThreads homepage for more information:<BR>
<A HREF="http://pauillac.inria.fr/~xleroy/linuxthreads">
http://pauillac.inria.fr/~xleroy/linuxthreads
</A>
2001-06-29 08:04:25 -06:00
<P><LI>You can get SVGALIB here:<BR>
2000-03-25 15:38:54 -07:00
<A HREF="http://www.svgalib.org/">
http://www.svgalib.org/</A>
2001-06-29 08:04:25 -06:00
<P><LI>You can get SDL here:<BR>
2000-03-25 15:38:54 -07:00
<A HREF="http://www.devolution.com/~slouken/SDL/">
http://www.devolution.com/~slouken/SDL/</A>
<P>Or you can get SDL here:<BR>
<A HREF="http://www.libsdl.org/">
http://www.libsdl.org/</A>
2001-06-29 08:04:25 -06:00
<P><LI>SIOD: Scheme in One Day<BR>
Not needed included in the source distribution.
2000-03-25 15:38:54 -07:00
The most recent release is available from
2002-05-13 15:00:35 -06:00
<A HREF="http://people.delphiforums.com/gjc/siod.html">this web page</a>,
2000-03-25 15:38:54 -07:00
and also from <A HREF="ftp://ftp.std.com/pub/gjc/">
ftp://ftp.std.com/pub/gjc/</A>
2001-06-29 08:04:25 -06:00
<P><LI>BZIP2: Freely available, patent free, high-quality data
compressor.<BR>
You can get it here <A HREF="http://sources.redhat.com/bzip2/">
http://sources.redhat.com/bzip2/</A>
<P><LI>ZZIP: Read access on ZIP-archives<BR>
2002-03-01 18:30:59 -07:00
You can get it here <A HREF="http://sourceforge.net/projects/zziplib">
2001-06-29 08:04:25 -06:00
http://sourceforge.net/projects/zziplib</A>
</UL>
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="mailto:aleclone@FreeCraft.org">The FreeCraft Project</A>
</ADDRESS></BODY></HTML>