--- deliantra/server/README 2006/03/15 14:04:31 1.1.1.2 +++ deliantra/server/README 2016/11/23 06:05:38 1.61 @@ -1,84 +1,128 @@ -WHAT IS CROSSFIRE? +WHAT IS DELIANTRA? - This is a multiplayer graphical arcade and adventure game made for - the X-Windows environment. It runs on a client/server model. - The client runs with X11, GTK, or SDL within a gtk window. A - windows client is available, and a java client is under development. + 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 Deliantra client should be used. This client is written + in Perl and utilises SDL with OpenGL to provide you with the most + immersive gameplay. - It 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, finding - and using items and battle monsters. They can choose to cooperate - or compete in the same "world". + Any number of players can move around in their own window on the + world, finding and using items and battle monsters. They can choose to + cooperate or compete in the same "world". -REQUIREMENTS - For UNIX, X-windows and an ANSI C compiler to compile this game. - A window system is not needed if you don't want to compile the - map editor. - - For Windows 9x, you need Visual C++ (or some other ANSI C - compiler that can read ".dsw"-files). - -COMPILING +REQUIREMENTS - Crossfire has been known to compile on a wide variety of - systems. It should compile and most all ANSI C and Posix - compliant systems. + For UNIX, a modern C++ compiler with some extensions is required to + compile this game (g++ 4.x works). In addition, you will need the Perl + development libraries along with the following Perl modules (the server + requires perl 5.10.1). A perl configured for 64 bit integer support is + highly recommended to avoid overflows, but 32 bit perls are supported) + and their dependencies. In general, the newest version from CPAN will + do. The configure script will complain when it detects an unsuitable + version. + + - common::sense + - AnyEvent + - AnyEvent::AIO + - AnyEvent::BDB + - BDB **compiled against libdb4.[567] (libdb4.4 *might* work)** + - Compress::LZF + - Coro **SEE IMPORTANT NOTICE BELOW** + - Coro::EV + - Deliantra + - Digest::MD5 + - EV + - Guard + - IO::AIO + - JSON::XS + - AnyEvent::IRC + - Pod::POM + - Safe::Hole + - Storable + - URI + - YAML::XS + - CBOR::XS + + **NOTICE**: Deliantra uses an alternative signal stack, so you cannot + use the sigaltstack method (== setjmp on unrecognised platforms) for + Coro. Try "a"ssembly, "u"context or "p"threads as backend instead on + those platforms. + + Furthermore, you will need the following programs and libraries: + + - gperf, the GNU perfect hash generator >= v3.0 + - blitz++ >= 0.10 + - glib-2.0 >= v2.32 + - libpng >= v1.2 + - ImageMagick >= v6.6.9 (possibly higher, depending on its bugs) + - optipng => v0.5.5 (http://optipng.sf.net) + - 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 + support all these. + + On Debian GNU/Linux, you might get away with something like this for many of the + above dependencies: + + apt-get install gperf optipng pngnq rsync imagemagick libglib2.0-dev libpng12-dev + apt-get install libpod-pom-perl libsafe-hole-perl libevent-perl libblitz0-dev + + 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. - To get directions on compilation for UNIX/LINUX, read the INSTALL file. - For Win9x, read INSTALL_WIN32.txt. -USAGE +COMPILING - Crossfire runs on a client/server model. You will also need the - client to play. You can either connect to a server someone else - has set up, or run your own server and connect to that. The - client package has information for connecting to servers. + 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 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. The map files will need to get downloaded - and installed for the server to run properly. The maps should be - unpacked in the $(TARGET)/share/crossfire directory - after unpacking, - you should have a $(TARGET)/share/crossfire/maps directory. + To get generic directions on compilation, read the INSTALL file. - If you plan to run a long term server, you should use one of the scripts - provided that will re-run crossfire if it dies for some reason. -MAILING LIST +INSTALLATION/USAGE - For the latest subscription for crossfire mailing lists, go to: - http://crossfire.real-time.com/mailinglists/index.html + Deliantra runs on a client/server model. You will also need 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, the recommended one is the Deliantra Client (see below for URL). - From there you should be able to subscribe/unsubscribe any of the mailing - lists. Links to archives of the mailing lists can be found there, as well - as at: - http://gmane.org/find.php?list=crossfire + 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: + Download both the cfmaps- and cfarch- archives, then + use cfutil to install both (the source directories must be writable for + this to work): -FTP SITES + cfutil --install-maps path/to/cfmaps-/ + cfutil --install-arch path/to/cfarch-/ - FTP-sites where you can look for the latest versions are: + 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: - http://prdownloads.sourceforge.net/crossfire/ - ftp://ftp.real-time.com/pub/games/crossfire + cfutil --cache --install-maps path/to/cfmaps-/ + cfutil --cache --install-arch path/to/cfarch-/ - Changes made since the latest release can be found at the CVS - repository. Information on anonymous CVS access as - the download CVS snapshots and browsing the repository can be - found at: - http://sourceforge.net/cvs/?group_id=13833 + 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.real-time.com/ - real-time is the main crossfire site. + http://www.deliantra.net/ (The main site) REPORTING BUGS @@ -86,68 +130,60 @@ First, check the INSTALL file for common problems, and see if yours is mentioned. - Bugs should be filed at the sourceforge web site: - http://sourceforge.net/cvs/?group_id=13833 + Bugs should be filed using the following email address: + support@deliantra.net When reporting bugs, make sure you include the following: - o If you have a sourceforge login, make sure you are logged in. In this - way, if there are questions about the bug, you will be notified about - the request for more information. - 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 (Ie, openwindows, X11R6, etc) - o What compiler (and its version) did you use (ie, gcc, acc, etc)? - o Which flags did you give it? - o 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: + + * 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 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 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 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. + -Further debugging informatiion can be found at -http://crossfire.real-time.com/debugging_tips.html +SUBMITTING PATCHES ------------------------------------------------------------------------------- -SUBMITTING PATCHES: See the doc/programming_guide file. - The patches should be submitted to the patch tracker on sourceforge: - http://sourceforge.net/cvs/?group_id=13833 - -PUBLIC SERVERS: - -The best way to find a server to play is to run the client. It will contact -the metaserver and present a list to choose from. You can also see -a list at http://crossfire.real-time.com/metaserver/ + Patches should be submitted to email address: + support@deliantra.net + + +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). + + The canonical server for use with Deliantra and CFPlus is + gameserver.deliantra.net, port 13327 (the default). COPYRIGHT - Don't get scared by the below, it's included just for "safety" reasons 8) - (Don't want anyone to start selling the game) + 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. + - Copyright (C) 2000,2006 Mark Wedel - Copyright (C) 1992 Frank Tore Johansen +CONTACT - 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. + The authors can be reached via e-mail to support@deliantra.net - The author can be reached via e-mail to crossfire-devel@real-time.com