--- deliantra/server/README 2007/04/26 00:39:18 1.9 +++ deliantra/server/README 2007/08/18 17:33:53 1.23 @@ -18,34 +18,41 @@ REQUIREMENTS For UNIX, a modern C++ compiler with some extensions is required to - compile this game. In addition, you will need the Perl development - libraries along with the following Perl modules (the server is tested - with perl 5.8.8 and 5.8-maint). - - - BDB >= v0.1 - - Compress::LZF >= v1.71 - - Coro >= v3.5 + compile this game (g++ 4.x works). In addition, you will need the Perl + development libraries along with the following Perl modules (the server + is tested with perl 5.8.8 and 5.8-maint) and their dependencies. (the + minimum versions below may not be up-to-date, the configure script will + check them all, though). + + - AnyEvent >= v2.52 + - BDB >= v0.1 **libdb4.5, libdb4.4 might work** + - Compress::LZF >= v1.8 + - Coro >= v3.64 **SEE IMPORTANT NOTICE BELOW** - Coro::Event >= v2.1 - - Crossfire >= v0.97 + - Crossfire >= v0.99 - Digest::MD5 >= v2.0 - Event >= v1.08 - - IO::AIO >= 2.32 - - JSON::XS => 1.11 + - IO::AIO >= v2.4 + - JSON::XS => v1.41 - Pod::POM >= v0.17 - Safe::Hole >= v0.10 - Storable >= v2.0 - Time::HiRes >= v1.0 - YAML::Syck >= v0.71 + - YAML => v0.62 + + **NOTICE**: Crossfire uses an alternative signal stack, so you have to + use either the "u"context method (slow) or "a"ssembly when configuring Coro. Furthermore, you will need the following programs and libraries: - gperf, the GNU perfect hash generator >= v3.0 - glib-2.0 >= v2.10 - libpng >= v1.2 - - ImageMagick >= v6.0 + - ImageMagick >= v6.0 (possibly higher, depending on its bugs) - optipng => v0.5.5 (http://optipng.sf.net) - - pngnq >= 0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html) - - rsync >= 2.6 (a must have anyways) + - pngnq >= v0.4 (http://freshmeat.net/redir/pngnq/53146/url_homepage/pngnq.html) + - rsync >= v2.6 (a must have anyways) Your compiler must support the Library Technical Report 1 extensions and the upcoming typeof extension. The GNU C++ compiler >= version 4.0 does @@ -57,6 +64,10 @@ apt-get install gperf optipng pngnq rsync imagemagick libglib2.0-dev libpng12-dev apt-get install libpod-pom-perl libsafe-hole-perl libevent-perl + If you want to get sensible backtraces for error conditions at runtime + to be logged you also need the external addr2line program (part of GNU + binutils) in your PATH. + COMPILING @@ -73,21 +84,30 @@ run your own server and connect to that. There are a number of clients available, but the recommended one is CFPlus (see below for URL). - To run your own server, you need to make the crossfire binaries and - install them, and then run the crossfire program. This now creates a - server which you/other people can connect to. First you have to download - and install maps and archetype packs, though. - - Download both the cfmaps- and cfarch- archives, then use cfutil - to install both: + To run your own server, you need to build the crossfire server binaries + and install them, then you will have to download and install map and + archetype packs: + + Download both the cfmaps- and cfarch- archives, then + use cfutil to install both (the source directories must be writable for + this to work): cfutil --install-maps path/to/cfmaps-/ cfutil --install-arch path/to/cfarch-/ - Both processes can take some time, depending on your resources :) + Both processes can take some time, depending on your resources :) If you + plan to repeat the installation you should specify the --cache option + first, which will keep costly-to-generate files around for further runs + of cfutil: + cfutil --cache --install-maps path/to/cfmaps-/ + cfutil --cache --install-arch path/to/cfarch-/ -WEB SITES: + Atfer this you can then run the crossfire executable. This starts a + server which you/other people can connect to. + + +WEB SITES The following web addresses have crossfire information that you may find useful: @@ -106,59 +126,57 @@ crossfire@schmorp.de When reporting bugs, make sure you include the following: - o What version of crossfire did you use? - o What type of computer did you use (CPU type) - o What is the version of the OS? - o What windowing system are you using (e.g. openwindows, X.org, XFree86) - o What compiler (and its version) did you use (e.g. gcc, acc)? - o Which flags did you give it? - o If the bug happens when compiling crossfire, send an EXACT copy of the + + * What version of crossfire did you use? + * What type of computer did you use (CPU type) + * What is the version of the OS? + * What windowing system are you using (e.g. openwindows, X.org, XFree86) + * What compiler (and its version) did you use (e.g. gcc, acc)? + * Which flags did you give it? + * If the bug happens when compiling crossfire, send an EXACT copy of the compiler line, as well as the errors it puts out. Sending bugs of the sort 'it failed with a line like ...' doesn't help any. - o If the bug happened while running crossfire: + * If the bug happened while running crossfire: - Include any output before to the bug. - - Give a description of what you did before the bug occured. The better - detailed the description, the better chance I have of figuring - out where the bug happened, or how I can recreate the bug. + - Give a description of what you did before the bug occured. The better + detailed the description, the better chance we have of figuring + out where the bug happened, or how we can recreate the bug. - If possible, a stack trace from gdb (or other debugger) is very helpful. -The more information provided, the better chance of the bug being fixed in -a timely fashion. + The more information provided, the better chance of the bug being fixed + in a timely fashion. -SUBMITTING PATCHES: - Patches should be submitted to email address: - crossfire@schmorp.de +SUBMITTING PATCHES -PUBLIC SERVERS: + Patches should be submitted to email address: + crossfire@schmorp.de - The best way to find a server to play is to run the client - and hit "Server List" in the setup dialog (this varies - depending on your client). You can also see a list at - http://crossfire.real-time.com/metaserver/. - The canonical server for use with Crossfire and CFPlus is - crossfire.schmorp.de, port 13327 (default). +PUBLIC SERVERS + + The best way to find a server to play is to run the client + and hit "Server List" in the setup dialog (this varies + depending on your client). You can also see a list at + http://crossfire.real-time.com/metaserver/. + + The canonical server for use with Crossfire and CFPlus is + crossfire.schmorp.de, port 13327 (default). + COPYRIGHT - Copyright (C) 2007 Crossfire Development Team - Copyright (C) 2000, 2006 Mark Wedel - Copyright (C) 1992 Frank Tore Johansen - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + Most files in this distribution are covered by the GNU General Public + License, version 3 (COPYING.GPL), or any later version, with the + exception of ext/affero.ext, which is covered by the GNU Affero General + Public License, Version 3 (COPYING.Affero). Please take note of the + special requirements of the Affero license with respect to network + servers and configure your network server according to the instructions + given in ext/affero.ext. + + +CONTACT + + The authors can be reached via e-mail to crossfire@schmorp.de - The authors can be reached via e-mail to crossfire@schmorp.de