Import of Empire 4.2.12
[empserver] / README
1 Welcome to Empire 4, codenamed Wolfpack.  Congratulations on your choice!
2
3 See the "LEGAL", "LICENSE", "CREDITS" and "README" files for all the
4 related information and legal notices. It is expected that any future
5 projects/authors will amend these files as needed.
6
7 For questions and comments, please contact "wolfpack@wolfpackempire.com".
8
9 If you want to build the server, follow the few simple steps below.  If
10 you are looking for more information on the files here, options for
11 the server, etc. take a look in the "doc" directory, then follow the steps
12 below to build and start the server.
13
14 (1) Unpacking the server
15   To unpack the server, simply gunzip and untar the source.
16
17 (2) Building a server
18   Note that you may not have to build a server.  If you received the
19   server in binary format, go to the next step, "Creating the world."
20
21   To build the server, you need to do the following steps:
22
23   1) Get a copy of the source.  Since you're reading this, we assume
24      you have done that. 
25   2) Gunzip the source.  Again, since you're reading this . . . ;-)
26   3) edit the build.conf file in this directory, and answer the questions
27      it asks you.
28   4) type "make" to see what architectures are currently supported.
29   5) choose the architecture that best suits you, and type "make <arch>"
30      where <arch> is the architecture you want to build.
31   6) type "make depend" to build the dependencies (not required, but
32       helps a lot when you want to recompile something again.)
33      Note: "make depend" doesn't work under NT yet.
34
35 (3) Creating the world
36   (NOTE: If you received a binary, you must edit the included data/econfig
37    file to represent the paths where your data and info directories are.)
38   1) First, pick the world size you want to use.  Once you have chosen
39      a world size, edit the "data/econfig" file (it was either created
40      at build time, or shipped with the binary) and change the WORLD_X
41      and WORLD_Y to be the sizes you want. The default world size is 64x32.
42      IMPORTANT: WORLD_X *MUST* be divisible by 2.  In addition, if you
43      change the world size later, you *MUST* re-create the world by
44      running "bin/files" again.
45   2) Go into the "bin" directory, and run "./files".
46   3) If you want to create a new world, run "./fairland 10 30" to create
47      a sample world (read the documentation for fairland for more info on
48      it's arguments.)
49   Note that "files" and "fairland" use the world size in the econfig file
50   if it exists in the data directory.  If this file doesn't exist, and you
51   don't specify one, it will use the default world size the server was
52   compiled with (Wolfpack binaries ship with a 64x32 world size)  You can
53   create an econfig file with default values using the "bin/pconfig"
54   executable.
55
56 (4) Running the server
57   1) Run the bin/emp_server executable to start the server.
58
59 That's it.  Once running, you can log on to the server using the emp_client
60 program found in the "bin" directory.  The initial deity country name/password
61 is POGO/peter.
62
63 If you get a "You're not a deity!" message and logged off, check the
64 "data/server.log" file and look at the end for a "NON-AUTH" entry.
65 There should be a "user@host" message in there that failed to log in.
66 The user and host that your system is using may be different than the
67 one you put in your build.conf file.  So, enter this new user and host
68 in the auth file, and you should be able to log into the server as a
69 deity now.  Note that if you rebuild the server again, the auth file
70 will be overwritten.
71
72 For more information on options, programs, files and other general hints
73 look in the "doc" directory.  The README there describes the files there and
74 what they talk about.
75
76 For more information or help, send e-mail to "wolfpack@wolfpackempire.com" and
77 we'll try to answer if we can.  Also check out our web site at
78 "http://www.wolfpackempire.com"
79
80 Have fun!
81
82  -- The Wolfpack development team...