summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichal Zima <xhire@mujmalysvet.cz>2010-06-18 16:31:14 +0200
committerMichal Zima <xhire@mujmalysvet.cz>2010-06-18 16:31:14 +0200
commit1a20fd03149cca2fc520e7e43db05629485eb2f7 (patch)
treed06797b5e9b2971d0ff6c3a15767534f8b481826
parent2f57e5a73b635b450459f9afa6c03d0e8d71b727 (diff)
Small update of README; Separation of INSTALL file
-rw-r--r--INSTALL99
-rw-r--r--README53
2 files changed, 111 insertions, 41 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..99078aa
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,99 @@
+HOW TO INSTALL TUXANCI
+======================
+
+Client
+------
+Requirements: cmake >= 2.6.0, SDL, SDL_image, SDL_ttf, (SDL_mixer), (OpenGL),
+ (Gettext), libzip
+(Those in brackets are optional and can be omitted if you choose appropriate
+switches while building the game. But we recommend to have all of them.)
+
+Note: you'll also need "-devel" versions of library packages.
+
+The following how-to is written for GNU/Linux, but we are working on ports and
+how-tos for other platforms too. If you want to help us, feel free to contact
+us! We will really appreciate it.
+
+Note: if you don't know all available cmake switches which can be used, you can
+run `ccmake` command (it seems to be ncurses based) instead of `cmake`. And
+please do enable the debug -- it helps us when you find a bug.
+
+$ mkdir build
+$ cmake .. -DENABLE_DEBUG=1
+$ make
+# make install
+
+Now it is installed in your system. And that's all. :c) You can run the game
+simply by running `tuxanci` command in the console (you'll see much of debug
+output, but that's ok).
+
+Tip: please think about running this command too (before the game itself):
+
+$ ulimit -c unlimited
+
+It enables generating of coredumps which are very helpful when the game crashes
+as it contains much information about the crash which happend. You also need to
+have debug enabled when compiling -- otherwise the coredump won't contain any
+useful information for us.
+
+Note: if you want to uninstall the game, run this command:
+
+# make uninstall
+
+
+Server
+------
+Requirements: cmake >= 2.6.0, libzip
+
+Note: you'll also need "-devel" version of libzip library package.
+
+The server is written for GNU/Linux and is not planned to be ported to other
+platforms (may be to BSD yes, but surely not to Windows ;c)).
+Note: if you don't know all available cmake switches which can be used, you can
+run `ccmake` command (it seems to be ncurses based) instead of `cmake`. And
+please do enable the debug -- it helps us when you find a bug.
+
+$ mkdir build
+$ cmake .. -DBUILD_SERVER=1 -DENABLE_DEBUG=1
+$ make
+# make install
+
+Now it is installed in your system. You should configure it before running. The
+configuration file is situated in /etc/tuxanci-server/server.conf. It contains
+some kind of example configuration which is usable but you'll probably prefer
+your own one. Have a look to /etc/tuxanci-server/arena.conf -- there are listed
+all available arenas and at the end of each line is "network name" of each
+arena. This network name is to be used in server.conf file within "ARENA"
+property.
+
+When you set IP6 property to ::, it will also accept IPv4 connections and IP4
+property won't be taken into account. LAN_ONLY means that the server will not
+register at MasterServer. You can let be the SUPPORT_CLIENTS property as it is
+going to be removed soon (default value is OK).
+
+If you want to run more than one Tuxanci game server, you need to have more
+configuration files (one for each game server). Specify which one to use by
+--config-file switch (e.g. --config-file=/etc/tuxanci-server/server-2.conf)
+when running the server.
+
+Note: RC script is not prepared yet. You have to write your own one.
+
+The game server itself can be started with following:
+
+$ tuxanci-server
+
+(If you have set appropriate paths and port, you don't need to have root
+privileges to start the server. Note: droping privileges is not implemented
+yet.)
+
+Tip: if you have enabled debug when compiling, please think about running this
+command before starting the game server:
+
+$ ulimit -c unlimited
+
+It enables generating of coredumps which are very helpful when the game server
+crashes as it contains much information about the crash which happend.
+
+Note: if you want to uninstall the game server, run this command:
+
+# make uninstall
diff --git a/README b/README
index 9f4624d..321da39 100644
--- a/README
+++ b/README
@@ -1,13 +1,15 @@
-ABOUT
-=====
- Tuxanci is first tux shooter ere while inspired by well-known Czech
- game Bulanci. But it goes its own way now and it is much better.
-
- Game supports 1 player and multiplayer game on one computer and also
- supports gameplay over network (LAN/Internet [IPv4 and IPv6]).
-
- Goal in this game is to shoot enemy penguin before he does so. Penguin
- can shoot only in X and Y axes so no diagonal shooting is available yet.
+ABOUT TUXANCI
+=============
+Tuxanci is first tux shooter. In the absolute beginning it was inspired by
+a well-known Czech game Bulanci. Today Tuxanci goes its own way and is much
+better then Bulanci (except the graphics though).
+
+Game supports 1 player and 2 players game on one computer and also supports
+gameplay over network (LAN/Internet [IPv4 and IPv6]).
+
+Goal in this game is to shoot enemy Tux before he does so. Tux can shoot only
+in X and Y axes so no diagonal shooting is available yet (in fact it is even
+not being planned at the moment).
Weapon list
-----------
@@ -46,37 +48,6 @@ ABOUT
Bonuses last only few seconds and if tux take another bonus then
first one looses its effects.
-HOWTO COMPILE
-=============
- This howto is written for linux. For other platforms please think about
- rather using binary modules.
- First of all we need some libraries:
- (g)libc, SDL, SDL_image, SDL_ttf, optionally SDL_mixer,
- optionally opengl, gettext, libzip
-
- And some applications:
- cmake version 2.6.0 and above
-
- Now we have two options what we can do:
- (all commands are supposed to be written in tuxanci/build directory;
- If such does not exist just create it :])
-
- NOTE: if you want to see all variable options definable by cmake just
- run ccmake instead of cmake.
- Building Client
- ---------------
- $ cmake ..
- $ make
- # make install
- Building Server
- --------------
- $ cmake .. -DBUILD_SERVER=1
- $ make
- # make install
- Removing current install
- -----------------------
- Same for both client and server
- # make uninstall
GAME USAGE
==========
Starting game is simple tuxanci-VERSION or tuxanci-server-V. based on what we