ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/README
(Generate patch)

Comparing deliantra/server/README (file contents):
Revision 1.7 by root, Wed Mar 7 01:23:37 2007 UTC vs.
Revision 1.10 by root, Fri Apr 27 19:53:04 2007 UTC

1WHAT IS CROSSFIRE? 1WHAT IS CROSSFIRE?
2 2
3 This is a multiplayer graphical arcade and adventure game, that runs on a 3 This is a multiplayer graphical arcade and adventure game, that runs on
4 client/server model. There are clients for Microsoft(R) Windows(TM) and 4 a client/server model. There are clients for Microsoft(R) Windows(TM)
5 POSIX systems such as Linux and *BSD. To get the most joyful experience, 5 and POSIX systems such as Linux and *BSD. To get the most joyful
6 the Crossfire+ client should be used. This client is written in Perl and 6 experience, the Crossfire+ client should be used. This client is written
7 utilises SDL with OpenGL. 7 in Perl and utilises SDL with OpenGL to provide you with the most
8 immersive gameplay.
8 9
9 Crossfire has certain flavours from other games, especially Gauntlet (TM) 10 Crossfire has certain flavours from other games, especially Gauntlet (TM)
10 and Nethack/Moria. 11 and Nethack/Moria.
11 12
12 Any number of players can move around in their own window, finding 13 Any number of players can move around in their own window on the
13 and using items and battle monsters. They can choose to cooperate 14 world, finding and using items and battle monsters. They can choose to
14 or compete in the same "world". 15 cooperate or compete in the same "world".
16
15 17
16REQUIREMENTS 18REQUIREMENTS
17 19
18 For UNIX, a modern C++ compiler with some extensions is required to 20 For UNIX, a modern C++ compiler with some extensions is required to
19 compile this game. In addition, you will need the Perl development 21 compile this game. In addition, you will need the Perl development
20 libraries along with the following Perl modules (the server is tested 22 libraries along with the following Perl modules (the server is tested
21 with perl 5.8.8 and 5.8-maint). 23 with perl 5.8.8 and 5.8-maint).
22 24
25 - BDB >= v0.1
26 - Compress::LZF >= v1.71
27 - Coro >= v3.62
28 - Coro::Event >= v2.1
23 - Crossfire >= v0.97 29 - Crossfire >= v0.97
24 - Coro >= v3.5 30 - Digest::MD5 >= v2.0
25 - Coro::Event >= v2.1
26 - Event >= v1.08 31 - Event >= v1.08
27 - IO::AIO >= 2.32 32 - IO::AIO >= 2.32
28 - BDB >= v0.1 33 - JSON::XS => 1.11
34 - Pod::POM >= v0.17
35 - Safe::Hole >= v0.10
29 - Storable >= v2.0 36 - Storable >= v2.0
30 - Time::HiRes >= v1.0 37 - Time::HiRes >= v1.0
31 - YAML::Syck >= v0.71 38 - YAML::Syck >= v0.71
32 - Digest::MD5 >= v2.0
33 - Compress::LZF >= v1.71
34 - Safe::Hole >= v0.10
35 - Pod::POM >= v0.17
36 39
37 Furthermore, you will need the following programs and libraries: 40 Furthermore, you will need the following programs and libraries:
38 41
39 - gperf, the GNU perfect hash generator >= v3.0 42 - gperf, the GNU perfect hash generator >= v3.0
40 - glib-2.0 >= v2.10 43 - glib-2.0 >= v2.10
41 - libpng >= v1.2 44 - libpng >= v1.2
42 - ImageMagick >= v6.0 45 - ImageMagick >= v6.0
43 - optipng => v0.5.5 (http://optipng.sf.net) 46 - optipng => v0.5.5 (http://optipng.sf.net)
47 - pngnq >= 0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html)
44 - rsync >= 2.6 (a must have anyways) 48 - rsync >= 2.6 (a must have anyways)
45 49
46 Your compiler must support the Library Technical Report 1 extensions and 50 Your compiler must support the Library Technical Report 1 extensions and
47 the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does 51 the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does
48 support all these. 52 support all these.
49 53
54 On Debian GNU/Linux, you might get away with something like this for many of the
55 above dependencies:
56
57 apt-get install gperf optipng pngnq rsync imagemagick libglib2.0-dev libpng12-dev
58 apt-get install libpod-pom-perl libsafe-hole-perl libevent-perl
59
60
50COMPILING 61COMPILING
51 62
52 Crossfire has been known to compile on a wide variety of systems. It should 63 Crossfire has been known to compile on a wide variety of systems. It should
53 compile and most all ISO C++ 200x and POSIX compliant systems. 64 compile and run on most ISO C++ 200x and POSIX compliant systems.
54 65
55 To get directions on compilation for UNIX/LINUX, read the INSTALL file. 66 To get generic directions on compilation, read the INSTALL file.
56 67
57USAGE
58 68
59 Crossfire runs on a client/server model. You will also need the client 69INSTALLATION/USAGE
60 to play. You can either connect to a server someone else has set up,
61 or run your own server and connect to that. The client package has
62 information for connecting to servers.
63 70
64 To run your own server, you need to make the crossfire binaries 71 Crossfire runs on a client/server model. You will also a client to
65 and install them, and then run the crossfire program. This now 72 play. You can either connect to a server someone else has set up, or
66 creates a server which you/other people can connect to. The map 73 run your own server and connect to that. There are a number of clients
67 files will need to get downloaded and installed for the server to run 74 available, but the recommended one is CFPlus (see below for URL).
68 properly. The map pack is released together with the server and can be
69 downloaded form the same location. The maps should be copied into the
70 $(TARGET)/share/crossfire/maps directory - after unpacking, you should
71 have a $(TARGET)/share/crossfire/maps/scorn directory.
72 75
73 If you plan to run a long term server, you should use one of the scripts 76 To run your own server, you need to make the crossfire binaries and
74 provided that will re-run crossfire if it dies for some reason. 77 install them, and then run the crossfire program. This now creates a
78 server which you/other people can connect to. First you have to download
79 and install maps and archetype packs, though.
80
81 Download both the cfmaps-<version> and cfarch-<version> archives, then use cfutil
82 to install both:
83
84 cfutil --install-maps path/to/cfmaps-<version>/
85 cfutil --install-arch path/to/cfarch-<version>/
86
87 Both processes can take some time, depending on your resources :)
88
75 89
76WEB SITES: 90WEB SITES:
77 91
78 The following web addresses have crossfire information that you may find 92 The following web addresses have crossfire information that you may find
79 useful: 93 useful:
… …
110 helpful. 124 helpful.
111 125
112The more information provided, the better chance of the bug being fixed in 126The more information provided, the better chance of the bug being fixed in
113a timely fashion. 127a timely fashion.
114 128
115------------------------------------------------------------------------------
116SUBMITTING PATCHES: 129SUBMITTING PATCHES:
130
117Patches should be submitted to email address: 131 Patches should be submitted to email address:
118 crossfire@schmorp.de 132 crossfire@schmorp.de
119 133
120PUBLIC SERVERS: 134PUBLIC SERVERS:
121 135
122The best way to find a server to play is to run the client. It will contact 136 The best way to find a server to play is to run the client
123the metaserver and present a list to choose from. You can also see 137 and hit "Server List" in the setup dialog (this varies
138 depending on your client). You can also see a list at
124a list at http://crossfire.real-time.com/metaserver/ 139 http://crossfire.real-time.com/metaserver/.
125 140
141 The canonical server for use with Crossfire and CFPlus is
142 crossfire.schmorp.de, port 13327 (default).
126 143
127COPYRIGHT 144COPYRIGHT
128 145
129 Copyright (C) 2007 Crossfire Development Team 146 Copyright (C) 2007 Crossfire Development Team
130 Copyright (C) 2000, 2006 Mark Wedel 147 Copyright (C) 2000, 2006 Mark Wedel

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines