TomeNET

(2) Installation & setup                                                        
========================

(2.1) Installing TomeNET                                                        
------------------------
Go to http://www.tomenet.net/ (or one of our personal pages) to download the
latest client. Extract it to a new directory, preserving the pathnames.


Windows:
--------
You may edit the file "TomeNET.ini" and do some changes to your likings, like
setting up window positions (note that the game will remember window positions
changed via dragging the windows around, which is an easier way), or choosing
font size (look into lib/xtra/font directory to see available fonts).
If it's not already disabled by default, it is recommended to turn off
graphics ("GRAPHICS=0"). Further you can specify an account name and password
of your own choice. That will relieve you from entering them every time
you join a TomeNET internet server.

Last but not least, you may use the following command-line options:
-p<Port>                for example -p19348
-l<Account> <Password>  for example -lGandalf geheim
-N<character name>      for example -NDruidor
<ip address>            for example 85.118.45.235


Linux:
------
How to compile the game binary:
Go into '/tomenet/src' where the file 'makefile' is located.

Make sure you have the C-devel, X11-devel, ncurses, ncurses-devel and crypt
libraries installed. The package names are usually:
xorg-dev, libncurses5, libncurses5-dev, libgcrypt11, libc6-dev.

Since version 4.4.5 which supports music and sound via SDL, you also need
libsdl-mixer-devel, libsdl, libsmpeg. Usual package names (SDL version 1.2):
libsdl-mixer1.2, libsdl-mixer1.2-dev, libsdl1.2debian, libsdl1.2-dev,
(preferably libsdl1.2debian-pulseaudio, eg under Ubuntu), libsmpeg0,
libsmpeg-dev.

Enter these two lines:
        make clean
        make tomenet
and the binary 'tomenet' will be created in this folder 'tomenet/src'.
IMPORTANT NOW: If your makefile is an older version, you need to move the
binary one level upwards, ie into '/tomenet' ! If your makefile is newer,
it might already have done that for you automatically.
Go up one level into your '/tomenet' folder. There type:
        ./tomenet
to start the game.

If you don't want 6 windows or if you want MORE (up to 8), just edit the file
'main-x11.c' and comment out/uncomment the lines starting on
        #define GRAPHICS_TERM_...
near the beginning of the file as you like, then compile the binary again.

You can use environment variables to set font sizes and window sizes for each
of the up to 8 windows separately:
TOMENET_X11_FONT_SCREEN (height and width of main window cannot be changed)
TOMENET_X11_WID_MIRROR, TOMENET_X11_HGT_MIRROR, TOMENET_X11_FONT_MIRROR
TOMENET_X11_WID_CHOICE, TOMENET_X11_HGT_CHOICE, TOMENET_X11_FONT_CHOICE
TOMENET_X11_WID_RECALL, TOMENET_X11_HGT_RECALL, TOMENET_X11_FONT_RECALL
TOMENET_X11_WID_TERM_4, TOMENET_X11_HGT_TERM_4, TOMENET_X11_FONT_TERM_4
TOMENET_X11_WID_TERM_5, TOMENET_X11_HGT_TERM_5, TOMENET_X11_FONT_TERM_5
TOMENET_X11_WID_TERM_6, TOMENET_X11_HGT_TERM_6, TOMENET_X11_FONT_TERM_6
TOMENET_X11_WID_TERM_7, TOMENET_X11_HGT_TERM_7, TOMENET_X11_FONT_TERM_7
Use the 'export' command to set them, eg:
        export TOMENET_X11_FONT_SCREEN=8x13
        export TOMENET_X11_WID_TERM_4=80
        export TOMENET_X11_HGT_TERM_4=24
It's a good idea to make a little script file for this.
Some possible font sizes are:
4x6, 5x7, 5x8, 6x9, 6x10, 6x12, 7x13, 7x14, 8x13, 9x15, 10x20, 12x24
depending on your system.
TOMENET_X11_FONT sets one font globally for all windows. It's overridden by
the window-specific font variables listed above though.

Last but not least, you may use the following command-line options:
-f<config file>         use a different config file than ~/.tomenetrc
-i                      ignore the ~/.tomenetrc config file
-p<Port>                for example -p19348
-l<Account> <Password>  for example -lGandalf geheim
-N<character name>      for example -NDruidor
<ip address>            for example 85.118.45.235

Full command-line example:
        ./tomenet -p19348 -lGandalf geheim -NGandalf 85.118.45.235

If your name contains spaces, it is neccessary to put a '\' in front of each.
Example:
        ./tomenet -p18348 -lIron\ Man geheimer 85.118.45.235
..if your account name is 'Iron Man'.


To automatically position your TomeNET windows in a certain manner on Linux,
on KDE this can be done natively by right-clicking the windows and modifying
the "special window settings" or "special application settings", while on Gnome
you can use a helper tool such as Devilspie to achieve the same.