--- deliantra/server/README 2007/05/27 02:26:17 1.14 +++ deliantra/server/README 2007/12/17 06:36:34 1.39 @@ -1,13 +1,13 @@ -WHAT IS CROSSFIRE? +WHAT IS DELIANTRA? This is a multiplayer graphical arcade and adventure game, that runs on a client/server model. There are clients for Microsoft(R) Windows(TM) and POSIX systems such as Linux and *BSD. To get the most joyful - experience, the Crossfire+ client should be used. This client is written + experience, the Deliantra client should be used. This client is written in Perl and utilises SDL with OpenGL to provide you with the most immersive gameplay. - Crossfire has certain flavours from other games, especially Gauntlet (TM) + Deliantra has certain flavours from other games, especially Gauntlet (TM) and Nethack/Moria. Any number of players can move around in their own window on the @@ -24,23 +24,26 @@ minimum versions below may not be up-to-date, the configure script will check them all, though). - - AnyEvent >= 2.52 - - BDB >= v0.1 + - AnyEvent >= v2.6 + - BDB >= v1.3 **libdb4.5, libdb4.4 might work** - Compress::LZF >= v1.8 - - Coro >= v3.62 **SEE IMPORTANT NOTICE BELOW** - - Coro::Event >= v2.1 - - Crossfire >= v0.98 + - Coro >= v4.32 **SEE IMPORTANT NOTICE BELOW** + - Coro::EV >= v2.1 + - Crossfire >= v1.13 - Digest::MD5 >= v2.0 - - Event >= v1.08 - - IO::AIO >= 2.32 - - JSON::XS => 1.21 + - EV >= v1.72 + - IO::AIO >= v2.51 + - JSON::XS >= v2.01 + - Net::IRC3 => v0.5 - Pod::POM >= v0.17 - Safe::Hole >= v0.10 - Storable >= v2.0 - Time::HiRes >= v1.0 + - URI >= 1.35 + - YAML >= v0.62 - YAML::Syck >= v0.71 - **NOTICE**: Crossfire uses an alternative signal stack, so you have to + **NOTICE**: Deliantra 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: @@ -50,8 +53,8 @@ - libpng >= v1.2 - 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 @@ -63,14 +66,14 @@ 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 gte sensible backtraces for error conditions at runtime + 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 - Crossfire has been known to compile on a wide variety of systems. It should + Deliantra has been known to compile on a wide variety of systems. It should compile and run on most ISO C++ 200x and POSIX compliant systems. To get generic directions on compilation, read the INSTALL file. @@ -78,12 +81,12 @@ INSTALLATION/USAGE - Crossfire runs on a client/server model. You will also a client to + Deliantra runs on a client/server model. You will also a client to play. You can either connect to a server someone else has set up, or 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 build the crossfire server binaries + To run your own server, you need to build the deliantra server binaries and install them, then you will have to download and install map and archetype packs: @@ -96,21 +99,22 @@ Both processes can take some time, depending on your resources :) If you plan to repeat the installation you should specify the --cache option - which will keep costly-to-generate files around for further runs of - cfutil. + first, which will keep costly-to-generate files around for further runs + of cfutil: - Atfer this you can then run the crossfire executable. This starts a + cfutil --cache --install-maps path/to/cfmaps-/ + cfutil --cache --install-arch path/to/cfarch-/ + + Atfer this you can then run the deliantra executable. This starts a server which you/other people can connect to. -WEB SITES: +WEB SITES - The following web addresses have crossfire information that you may find + The following web addresses have deliantra information that you may find useful: - http://crossfire.schmorp.de/ (The main site) - - http://crossfire.real-time.com/ (The website for the old Crossfire game) + http://www.deliantra.net/ (The main site) REPORTING BUGS @@ -119,20 +123,20 @@ mentioned. Bugs should be filed using the following email address: - crossfire@schmorp.de + support@deliantra.net When reporting bugs, make sure you include the following: - * What version of crossfire did you use? + * What version of deliantra 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 + * If the bug happens when compiling deliantra, 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. - * If the bug happened while running crossfire: + * If the bug happened while running deliantra: - 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 we have of figuring @@ -143,39 +147,35 @@ The more information provided, the better chance of the bug being fixed in a timely fashion. -SUBMITTING PATCHES: + +SUBMITTING PATCHES Patches should be submitted to email address: - crossfire@schmorp.de + support@deliantra.net + -PUBLIC SERVERS: +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/. + depending on your client). + + The canonical server for use with Deliantra and CFPlus is + gameserver.deliantra.net, port 13327 (the default). - The canonical server for use with Crossfire and CFPlus is - crossfire.schmorp.de, port 13327 (default). COPYRIGHT - Copyright (C) 2006,2007 Crossfire TRT 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 support@deliantra.net - The authors can be reached via e-mail to crossfire@schmorp.de