1 | WHAT IS CROSSFIRE? |
1 | WHAT 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 | |
16 | REQUIREMENTS |
18 | REQUIREMENTS |
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 **SEE IMPORTANT NOTICE BELOW** |
|
|
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 |
39 | |
33 | - Compress::LZF >= v1.71 |
40 | **NOTICE**: Crossfire uses an alternative signal stack, so you have to |
34 | - Safe::Hole >= v0.10 |
41 | use either the "u"context method or "a"ssembly when configuring Coro. |
35 | - Pod::POM >= v0.17 |
|
|
36 | |
42 | |
37 | Furthermore, you will need the following programs and libraries: |
43 | Furthermore, you will need the following programs and libraries: |
38 | |
44 | |
39 | - gperf, the GNU perfect hash generator >= v3.0 |
45 | - gperf, the GNU perfect hash generator >= v3.0 |
40 | - glib-2.0 >= v2.10 |
46 | - glib-2.0 >= v2.10 |
41 | - libpng >= v1.2 |
47 | - libpng >= v1.2 |
42 | - ImageMagick >= v6.0 |
48 | - ImageMagick >= v6.0 |
43 | - optipng => v0.5.5 (http://optipng.sf.net) |
49 | - optipng => v0.5.5 (http://optipng.sf.net) |
|
|
50 | - pngnq >= 0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html) |
44 | - rsync >= 2.6 (a must have anyways) |
51 | - rsync >= 2.6 (a must have anyways) |
45 | |
52 | |
46 | Your compiler must support the Library Technical Report 1 extensions and |
53 | Your compiler must support the Library Technical Report 1 extensions and |
47 | the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does |
54 | the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does |
48 | support all these. |
55 | support all these. |
49 | |
56 | |
|
|
57 | On Debian GNU/Linux, you might get away with something like this for many of the |
|
|
58 | above dependencies: |
|
|
59 | |
|
|
60 | apt-get install gperf optipng pngnq rsync imagemagick libglib2.0-dev libpng12-dev |
|
|
61 | apt-get install libpod-pom-perl libsafe-hole-perl libevent-perl |
|
|
62 | |
|
|
63 | |
50 | COMPILING |
64 | COMPILING |
51 | |
65 | |
52 | Crossfire has been known to compile on a wide variety of systems. It should |
66 | 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. |
67 | compile and run on most ISO C++ 200x and POSIX compliant systems. |
54 | |
68 | |
55 | To get directions on compilation for UNIX/LINUX, read the INSTALL file. |
69 | To get generic directions on compilation, read the INSTALL file. |
56 | |
70 | |
57 | USAGE |
|
|
58 | |
71 | |
59 | Crossfire runs on a client/server model. You will also need the client |
72 | INSTALLATION/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 | |
73 | |
64 | To run your own server, you need to make the crossfire binaries |
74 | 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 |
75 | 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 |
76 | 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 |
77 | 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 | |
78 | |
73 | If you plan to run a long term server, you should use one of the scripts |
79 | 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. |
80 | install them, and then run the crossfire program. This now creates a |
|
|
81 | server which you/other people can connect to. First you have to download |
|
|
82 | and install maps and archetype packs, though. |
|
|
83 | |
|
|
84 | Download both the cfmaps-<version> and cfarch-<version> archives, then use cfutil |
|
|
85 | to install both: |
|
|
86 | |
|
|
87 | cfutil --install-maps path/to/cfmaps-<version>/ |
|
|
88 | cfutil --install-arch path/to/cfarch-<version>/ |
|
|
89 | |
|
|
90 | Both processes can take some time, depending on your resources :) |
|
|
91 | |
75 | |
92 | |
76 | WEB SITES: |
93 | WEB SITES: |
77 | |
94 | |
78 | The following web addresses have crossfire information that you may find |
95 | The following web addresses have crossfire information that you may find |
79 | useful: |
96 | useful: |
… | |
… | |
110 | helpful. |
127 | helpful. |
111 | |
128 | |
112 | The more information provided, the better chance of the bug being fixed in |
129 | The more information provided, the better chance of the bug being fixed in |
113 | a timely fashion. |
130 | a timely fashion. |
114 | |
131 | |
115 | ------------------------------------------------------------------------------ |
|
|
116 | SUBMITTING PATCHES: |
132 | SUBMITTING PATCHES: |
|
|
133 | |
117 | Patches should be submitted to email address: |
134 | Patches should be submitted to email address: |
118 | crossfire@schmorp.de |
135 | crossfire@schmorp.de |
119 | |
136 | |
120 | PUBLIC SERVERS: |
137 | PUBLIC SERVERS: |
121 | |
138 | |
122 | The best way to find a server to play is to run the client. It will contact |
139 | The best way to find a server to play is to run the client |
123 | the metaserver and present a list to choose from. You can also see |
140 | and hit "Server List" in the setup dialog (this varies |
|
|
141 | depending on your client). You can also see a list at |
124 | a list at http://crossfire.real-time.com/metaserver/ |
142 | http://crossfire.real-time.com/metaserver/. |
125 | |
143 | |
|
|
144 | The canonical server for use with Crossfire and CFPlus is |
|
|
145 | crossfire.schmorp.de, port 13327 (default). |
126 | |
146 | |
127 | COPYRIGHT |
147 | COPYRIGHT |
128 | |
148 | |
129 | Copyright (C) 2007 Crossfire Development Team |
149 | Copyright (C) 2007 Crossfire Development Team |
130 | Copyright (C) 2000, 2006 Mark Wedel |
150 | Copyright (C) 2000, 2006 Mark Wedel |