git.pond.sub.org Git - empserver/blob - 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-2020, Dave Pare, Jeff Bailey, Thomas Ruschak,
   5 Ken Stevens, Steve McClure, Markus Armbruster
   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 3 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 cloned a git repository, run bootstrap.  This requires
  24     recent versions of Autoconf and Automake to be installed.  See
  25     also doc/contributing.
  26
  27 (2) Building a server
  28
  29     Prerequisites: IEEE Std 1003.1-2001 (POSIX.1-2001) with the X/Open
  30     System Interfaces Extension, GNU make, Perl, and either nroff or
  31     GNU troff (`groff').
  32
  33     See file `INSTALL' for detailed compilation and installation
  34     instructions.  Quick guide for the impatient: run configure; make;
  35     make install.  The last step is optional; everything runs fine
  36     right from the build tree.
  37
  38     If configure reports "readline: no" in its configuration summary,
  39     fancy line editing doesn't work in the client.  Commonly caused by
  40     not having development libraries installed.  On Linux, try
  41     installing readline-devel.
  42
  43     If configure reports "terminfo: no" in its configuration summary,
  44     highlighting doesn't work in the client.  Commonly caused by not
  45     having development libraries installed.  On Linux, try installing
  46     ncurses-devel.
  47
  48     If make fails without doing anything, you're probably not using
  49     GNU make.  Some systems have it installed as `gmake'.
  50
  51     Solaris supports POSIX.1-2001, but you need to set up your
  52     environment for that.  Try
  53
  54         SHELL=/usr/xpg4/bin/sh
  55         PATH=/usr/xpg6/bin:/usr/xpg4/bin:/usr/ccs/bin:$PATH
  56
  57     See standards(5) for details.
  58
  59     Likewise, AIX needs XPG_SUS_ENV=ON.
  60
  61 (3) Creating a game
  62
  63     * Create a configuration for your game.  make install installs one
  64       in $prefix/etc/empire/econfig ($prefix is /usr/local unless you
  65       chose something else with configure).  You can use pconfig to
  66       create another one.
  67
  68     * Edit your configuration file.  See doc/econfig for more
  69       information.
  70
  71       Unless you put your configuration file in the default location
  72       (where make install installs it), you have to use -e with all
  73       programs to make them use your configuration.
  74
  75     * Run files to set up your data directory.
  76
  77     * Run fairland to create a world.  For a sample world, try
  78       `fairland 10 30'.  This creates file ./newcap_script, which will
  79       be used below.  You can edit it to change country names and
  80       passwords.
  81
  82       Check out fairland's manual page for more information.
  83
  84     * Start the server.  For development, you want to run it with -d
  85       in a debugger, see doc/debugging.  Do not use -d for a real
  86       game!
  87
  88     * Log in as deity POGO with password peter.  This guide assumes
  89       you use the included client `empire', but other clients should
  90       work as well.
  91
  92       For help, try `info'.
  93
  94       To change the deity password, use `change re <password>'.
  95
  96     * Create countries with `exec newcap_script'.
  97
  98     Your game is now up!
  99
 100 Naturally, there's more to running a real game than that, but that's
 101 beyond the scope of this file.
 102
 103 Please report bugs to <wolfpack@wolfpackempire.com> or via SourceForge
 104 <http://sourceforge.net/projects/empserver/> (registration required).
 105
 106 For more information or help, try rec.games.empire on Usenet, or send
 107 e-mail to <wolfpack@wolfpackempire.com> and we'll try to answer if we
 108 can.  Also check out our web site at <http://www.wolfpackempire.com/>.
 109
 110 Have fun!
 111
 112 Wolfpack!