Document need for curses.
[empserver] / README
1 Welcome to Empire 4, code-named Wolfpack.
2
3 Empire is a multi-player, client/server Internet based war game.
4 Copyright (C) 1986-2006, Dave Pare, Jeff Bailey, Thomas Ruschak, Ken
5 Stevens, Steve McClure
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License (in file
10 `COPYING'), or (at your option) any later version.
11
12 See file `CREDITS' for a list of contributors.
13
14 Directory `doc' has additional information.  File `doc/README'
15 describes the files there and what they talk about.
16
17 To build the server and set up a game, follow the steps below.
18
19 (1) Unpacking the source tree
20
21     If you downloaded a tarball, unpack it.
22
23     If you're pulling from CVS, check out and run bootstrap.  This
24     requires Autoconf and Automake to be installed.
25
26 (2) Building a server
27
28     Requirements: GNU make and GNU troff (`groff'), ANSI C, a curses
29     library, Perl, Bourne Shell and the common utilities.
30
31     See file `INSTALL' for detailed compilation and installation
32     instructions.  Quick guide for the impatient: run configure; make;
33     make install.  The last step is optional; everything runs fine
34     right from the build tree.
35
36     If make fails without doing anything, you're probably not using
37     GNU make.  Some systems have it installed as `gmake'.
38
39 (3) Creating a game
40
41     * Create a configuration for your game.  make install installs one
42       in $prefix/etc/empire/econfig ($prefix is /usr/local unless you
43       chose something else with configure).  You can use pconfig to
44       create another one.
45
46     * Edit your configuration file.  See doc/econfig for more
47       information.
48
49       Unless you put your configuration file in the default location
50       (where make install installs it), you have to use -e with all
51       programs to make them use your configuration.
52
53     * Run files to set up your data directory.
54
55     * Run fairland to create a world.  For a sample world, try
56       `fairland 10 30'.  This creates file ./newcap_script, which will
57       be used below.  You can edit it to change country names and
58       passwords.
59
60       Check out fairland's manual page for more information.
61
62     * Start the server.  For development, you want to run it with -d
63       in a debugger, see doc/debugging.  Do not use -d for a real
64       game!
65
66     * Log in as deity POGO with password peter.  This guide assumes
67       you use the included client `empire', but other clients should
68       work as well.
69
70       For help, try `info'.
71
72       To change the deity password, use `change re <password>'.
73
74       FIXME auth
75
76     * Create countries with `exec newcap_script'.
77
78     Your game is now up!
79
80 Naturally, there's more to running a real game than that, but that's
81 beyond the scope of this file.
82
83 Please report bugs to <wolfpack@wolfpackempire.com> or via SourceForge
84 http://sourceforge.net/projects/empserver (registration required).
85
86 For more information or help, try rec.games.empire on Usenet, or send
87 e-mail to <wolfpack@wolfpackempire.com> and we'll try to answer if we
88 can.  Also check out our web site at "http://www.wolfpackempire.com".
89
90 Have fun!
91
92 Wolfpack!