1 | WHAT IS CROSSFIRE? |
1 | WHAT IS DELIANTRA? |
2 | |
2 | |
3 | This is a multiplayer graphical arcade and adventure game, that runs on |
3 | This is a multiplayer graphical arcade and adventure game, that runs on |
4 | a client/server model. There are clients for Microsoft(R) Windows(TM) |
4 | a client/server model. There are clients for Microsoft(R) Windows(TM) |
5 | and POSIX systems such as Linux and *BSD. To get the most joyful |
5 | and POSIX systems such as Linux and *BSD. To get the most joyful |
6 | experience, the Crossfire+ client should be used. This client is written |
6 | experience, the Deliantra client should be used. This client is written |
7 | in Perl and utilises SDL with OpenGL to provide you with the most |
7 | in Perl and utilises SDL with OpenGL to provide you with the most |
8 | immersive gameplay. |
8 | immersive gameplay. |
9 | |
9 | |
10 | Crossfire has certain flavours from other games, especially Gauntlet (TM) |
10 | Deliantra has certain flavours from other games, especially Gauntlet (TM) |
11 | and Nethack/Moria. |
11 | and Nethack/Moria. |
12 | |
12 | |
13 | Any number of players can move around in their own window on the |
13 | Any number of players can move around in their own window on the |
14 | world, finding and using items and battle monsters. They can choose to |
14 | world, finding and using items and battle monsters. They can choose to |
15 | cooperate or compete in the same "world". |
15 | cooperate or compete in the same "world". |
… | |
… | |
18 | REQUIREMENTS |
18 | REQUIREMENTS |
19 | |
19 | |
20 | 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 |
21 | compile this game (g++ 4.x works). In addition, you will need the Perl |
21 | compile this game (g++ 4.x works). In addition, you will need the Perl |
22 | development libraries along with the following Perl modules (the server |
22 | development libraries along with the following Perl modules (the server |
23 | is tested with perl 5.8.8 and 5.8-maint) and their dependencies. (the |
23 | requires perl 5.10). A perl configured for 64 bit integer support is |
24 | minimum versions below may not be up-to-date, the configure script will |
24 | highly recommended to avoid overflows, but 32 bit perls are supported) |
25 | check them all, though). |
25 | and their dependencies. In general, the newest version from CPAN will |
|
|
26 | do. The configure script will complain when it detects an unsuitable |
|
|
27 | version. |
26 | |
28 | |
|
|
29 | - common::sense |
27 | - AnyEvent >= 2.52 |
30 | - AnyEvent |
28 | - BDB >= v0.1 |
31 | - AnyEvent::AIO |
|
|
32 | - AnyEvent::BDB |
|
|
33 | - BDB **compiled against libdb4.[567] (libdb4.4 *might* work)** |
29 | - Compress::LZF >= v1.8 |
34 | - Compress::LZF |
30 | - Coro >= v3.62 **SEE IMPORTANT NOTICE BELOW** |
35 | - Coro **SEE IMPORTANT NOTICE BELOW** |
31 | - Coro::Event >= v2.1 |
36 | - Coro::EV |
32 | - Crossfire >= v0.99 |
37 | - Deliantra |
33 | - Digest::MD5 >= v2.0 |
38 | - Digest::MD5 |
34 | - Event >= v1.08 |
39 | - EV |
|
|
40 | - Guard |
35 | - IO::AIO >= 2.4 |
41 | - IO::AIO |
36 | - JSON::XS => 1.21 |
42 | - JSON::XS |
|
|
43 | - AnyEvent::IRC |
37 | - Pod::POM >= v0.17 |
44 | - Pod::POM |
38 | - Safe::Hole >= v0.10 |
45 | - Safe::Hole |
39 | - Storable >= v2.0 |
46 | - Storable |
40 | - Time::HiRes >= v1.0 |
47 | - Time::HiRes |
41 | - YAML::Syck >= v0.71 |
48 | - URI |
|
|
49 | - YAML::XS |
42 | |
50 | |
43 | **NOTICE**: Crossfire uses an alternative signal stack, so you have to |
51 | **NOTICE**: Deliantra uses an alternative signal stack, so you have to |
44 | use either the "u"context method (slow) or "a"ssembly when configuring Coro. |
52 | use either the "u"context method (slow) or "a"ssembly when configuring |
|
|
53 | Coro. |
45 | |
54 | |
46 | Furthermore, you will need the following programs and libraries: |
55 | Furthermore, you will need the following programs and libraries: |
47 | |
56 | |
48 | - gperf, the GNU perfect hash generator >= v3.0 |
57 | - gperf, the GNU perfect hash generator >= v3.0 |
49 | - glib-2.0 >= v2.10 |
58 | - glib-2.0 >= v2.10 |
50 | - libpng >= v1.2 |
59 | - libpng >= v1.2 |
51 | - ImageMagick >= v6.0 (possibly higher, depending on its bugs) |
60 | - ImageMagick >= v6.0 (possibly higher, depending on its bugs) |
52 | - optipng => v0.5.5 (http://optipng.sf.net) |
61 | - optipng => v0.5.5 (http://optipng.sf.net) |
53 | - pngnq >= 0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html) |
62 | - pngnq >= v0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html) |
54 | - rsync >= 2.6 (a must have anyways) |
63 | - rsync >= v2.6 (a must have anyways) |
55 | |
64 | |
56 | Your compiler must support the Library Technical Report 1 extensions and |
65 | Your compiler must support the Library Technical Report 1 extensions and |
57 | the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does |
66 | the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does |
58 | support all these. |
67 | support all these. |
59 | |
68 | |
… | |
… | |
68 | binutils) in your PATH. |
77 | binutils) in your PATH. |
69 | |
78 | |
70 | |
79 | |
71 | COMPILING |
80 | COMPILING |
72 | |
81 | |
73 | Crossfire has been known to compile on a wide variety of systems. It should |
82 | Deliantra has been known to compile on a wide variety of systems. It should |
74 | compile and run on most ISO C++ 200x and POSIX compliant systems. |
83 | compile and run on most ISO C++ 200x and POSIX compliant systems. |
75 | |
84 | |
76 | To get generic directions on compilation, read the INSTALL file. |
85 | To get generic directions on compilation, read the INSTALL file. |
77 | |
86 | |
78 | |
87 | |
79 | INSTALLATION/USAGE |
88 | INSTALLATION/USAGE |
80 | |
89 | |
81 | Crossfire runs on a client/server model. You will also a client to |
90 | Deliantra runs on a client/server model. You will also a client to |
82 | play. You can either connect to a server someone else has set up, or |
91 | play. You can either connect to a server someone else has set up, or |
83 | run your own server and connect to that. There are a number of clients |
92 | run your own server and connect to that. There are a number of clients |
84 | available, but the recommended one is CFPlus (see below for URL). |
93 | available, but the recommended one is CFPlus (see below for URL). |
85 | |
94 | |
86 | To run your own server, you need to build the crossfire server binaries |
95 | To run your own server, you need to build the deliantra server binaries |
87 | and install them, then you will have to download and install map and |
96 | and install them, then you will have to download and install map and |
88 | archetype packs: |
97 | archetype packs: |
89 | |
98 | |
90 | Download both the cfmaps-<version> and cfarch-<version> archives, then |
99 | Download both the cfmaps-<version> and cfarch-<version> archives, then |
91 | use cfutil to install both (the source directories must be writable for |
100 | use cfutil to install both (the source directories must be writable for |
… | |
… | |
94 | cfutil --install-maps path/to/cfmaps-<version>/ |
103 | cfutil --install-maps path/to/cfmaps-<version>/ |
95 | cfutil --install-arch path/to/cfarch-<version>/ |
104 | cfutil --install-arch path/to/cfarch-<version>/ |
96 | |
105 | |
97 | Both processes can take some time, depending on your resources :) If you |
106 | Both processes can take some time, depending on your resources :) If you |
98 | plan to repeat the installation you should specify the --cache option |
107 | plan to repeat the installation you should specify the --cache option |
99 | which will keep costly-to-generate files around for further runs of |
108 | first, which will keep costly-to-generate files around for further runs |
100 | cfutil. |
109 | of cfutil: |
101 | |
110 | |
|
|
111 | cfutil --cache --install-maps path/to/cfmaps-<version>/ |
|
|
112 | cfutil --cache --install-arch path/to/cfarch-<version>/ |
|
|
113 | |
102 | Atfer this you can then run the crossfire executable. This starts a |
114 | Atfer this you can then run the deliantra executable. This starts a |
103 | server which you/other people can connect to. |
115 | server which you/other people can connect to. |
104 | |
116 | |
105 | |
117 | |
106 | WEB SITES |
118 | WEB SITES |
107 | |
119 | |
108 | The following web addresses have crossfire information that you may find |
120 | The following web addresses have deliantra information that you may find |
109 | useful: |
121 | useful: |
110 | |
122 | |
111 | http://crossfire.schmorp.de/ (The main site) |
123 | http://www.deliantra.net/ (The main site) |
112 | |
|
|
113 | http://crossfire.real-time.com/ (The website for the old Crossfire game) |
|
|
114 | |
124 | |
115 | |
125 | |
116 | REPORTING BUGS |
126 | REPORTING BUGS |
117 | |
127 | |
118 | First, check the INSTALL file for common problems, and see if yours is |
128 | First, check the INSTALL file for common problems, and see if yours is |
119 | mentioned. |
129 | mentioned. |
120 | |
130 | |
121 | Bugs should be filed using the following email address: |
131 | Bugs should be filed using the following email address: |
122 | crossfire@schmorp.de |
132 | support@deliantra.net |
123 | |
133 | |
124 | When reporting bugs, make sure you include the following: |
134 | When reporting bugs, make sure you include the following: |
125 | |
135 | |
126 | * What version of crossfire did you use? |
136 | * What version of deliantra did you use? |
127 | * What type of computer did you use (CPU type) |
137 | * What type of computer did you use (CPU type) |
128 | * What is the version of the OS? |
138 | * What is the version of the OS? |
129 | * What windowing system are you using (e.g. openwindows, X.org, XFree86) |
139 | * What windowing system are you using (e.g. openwindows, X.org, XFree86) |
130 | * What compiler (and its version) did you use (e.g. gcc, acc)? |
140 | * What compiler (and its version) did you use (e.g. gcc, acc)? |
131 | * Which flags did you give it? |
141 | * Which flags did you give it? |
132 | * If the bug happens when compiling crossfire, send an EXACT copy of the |
142 | * If the bug happens when compiling deliantra, send an EXACT copy of the |
133 | compiler line, as well as the errors it puts out. Sending bugs of the |
143 | compiler line, as well as the errors it puts out. Sending bugs of the |
134 | sort 'it failed with a line like ...' doesn't help any. |
144 | sort 'it failed with a line like ...' doesn't help any. |
135 | * If the bug happened while running crossfire: |
145 | * If the bug happened while running deliantra: |
136 | - Include any output before to the bug. |
146 | - Include any output before to the bug. |
137 | - Give a description of what you did before the bug occured. The better |
147 | - Give a description of what you did before the bug occured. The better |
138 | detailed the description, the better chance we have of figuring |
148 | detailed the description, the better chance we have of figuring |
139 | out where the bug happened, or how we can recreate the bug. |
149 | out where the bug happened, or how we can recreate the bug. |
140 | - If possible, a stack trace from gdb (or other debugger) is very |
150 | - If possible, a stack trace from gdb (or other debugger) is very |
… | |
… | |
145 | |
155 | |
146 | |
156 | |
147 | SUBMITTING PATCHES |
157 | SUBMITTING PATCHES |
148 | |
158 | |
149 | Patches should be submitted to email address: |
159 | Patches should be submitted to email address: |
150 | crossfire@schmorp.de |
160 | support@deliantra.net |
151 | |
161 | |
152 | |
162 | |
153 | PUBLIC SERVERS |
163 | PUBLIC SERVERS |
154 | |
164 | |
155 | The best way to find a server to play is to run the client |
165 | The best way to find a server to play is to run the client |
156 | and hit "Server List" in the setup dialog (this varies |
166 | and hit "Server List" in the setup dialog (this varies |
157 | depending on your client). You can also see a list at |
167 | depending on your client). |
158 | http://crossfire.real-time.com/metaserver/. |
|
|
159 | |
168 | |
160 | The canonical server for use with Crossfire and CFPlus is |
169 | The canonical server for use with Deliantra and CFPlus is |
161 | crossfire.schmorp.de, port 13327 (default). |
170 | gameserver.deliantra.net, port 13327 (the default). |
162 | |
171 | |
163 | |
172 | |
164 | COPYRIGHT |
173 | COPYRIGHT |
165 | |
174 | |
166 | Most files in this distribution are covered by the GNU General Public |
175 | Most files in this distribution are covered by the GNU General Public |
… | |
… | |
172 | given in ext/affero.ext. |
181 | given in ext/affero.ext. |
173 | |
182 | |
174 | |
183 | |
175 | CONTACT |
184 | CONTACT |
176 | |
185 | |
177 | The authors can be reached via e-mail to crossfire@schmorp.de |
186 | The authors can be reached via e-mail to support@deliantra.net |
178 | |
187 | |