» Contents
» (0) Quickstart
» (1) Introduction
» (2) Installation & setup
» (3) Creating a character & starting to play
» (4) The world
» (5) Item and monster details
» (6) Character details
» (7) Tactics & strategy
» (8) Miscellanous

Search
  Next
(0.1) Start & play
(2) Installation & setup                                                        
========================

(2.1) Installing/updating TomeNET                                               
---------------------------------

Updating:
---------
Starting with version 4.5.7a, TomeNET comes with an updater tool that should
work on most platforms. If it doesn't on yours, please contact us and provide
details about which operating system you are using.

To update your TomeNET client or the sound pack or music pack, just run the
'TomeNET-Updater' and click on the according button.
The only prerequisite is that you must have '7-Zip' installed, a great, free,
open source archiver that beats WinRAR and WinZIP easily. You can get it from
www.7-zip.org.
Important: You should exit the game before attempting to update it!
Note for LINUX:
The Linux version of the TomeNET-Updater no longer requires 7zG (the graphical
user interface of 7-zip), so you do not need to compile it yourself if your
repository packages don't provide it. If you want to compile it anyway then see
(2.1a) and there "a) Automatic audio pack installation - LINUX". That paragraph
has short instructions on how to compile 7-zip from source in Linux.


Installation from scratch:
--------------------------
(Covered are Windows, Linux, OSX, FreeBSD.)

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

(Note: If you decide to download the 'test client' instead of the client of the
latest stable version number, be aware that it might stop working correctly
unexpectedly because it's undergoing development, possibly forcing you to
redownload it.)


Windows:
--------
To extract the TomeNET zip package you downloaded, 7-zip is recommended.
It's a free and open source zip-tool of outstanding performance that works on
all platforms. Grab it from http://www.7-zip.org/ .

After extracting, you're good to go. If you're already tired of reading, just
double-click TomeNET.exe, pick the first official server in the list, make up
an account and character and start to play.

There is also a manual in your TomeNET folder, the file is called
"TomeNET-Guide.txt". Double-click to read it. It is recommended to not open it
in Wordpad, but either in Notepad or in any web browser of your choice, because
Wordpad tends to warp the layout badly.
Alternatively you can find the latest version of the manual online for browsing
and easy searching, on the TomeNET homepage (http://www.tomenet.eu/).

If you're tech savvy, you could decide to edit the game configuration manually,
but that is not really required. Continue reading below if you want to do that.

Otherwise, you could skip forward to (2.1a) now, where you find an explanation
on how to install the music pack.

When you're done with everything, you can continue reading at (2.1d) if you are
using Valve's Steam, and then at (2.2) to find how how to actually connect to
the TomeNET game server, create an account, create a character, and play the
game!


Windows - Manually editing the configuration file (if you're tech savvy):
-------------------------------------------------------------------------
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).
Further you can specify an account name and password to be filled in
automatically, and various other things.

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 37.187.75.24
-q                      turns off loading/initializing of audio ('quiet mode')
-w                      disables weather effects
-u                      disables automatic LUA script updating
-k                      don't disable numlock on client startup
-m                      skip motd (message of the day) on login
-v                      automatically save chat log on exit

(Skip down to (2.1a) to continue reading.)


Linux (using pre-compiled client):
----------------------------------
Make sure that ncurses and crypt libraries are installed, package names are
usually libncurses5 and libgcrypt11.
Enter the 'tomenet/' folder and type:
        ./tomenet
to start the game.

If you get a font-related error ("Font not found: 9x15") please see PROBLEM 55
in chapter Troubleshooting (8.8).


Linux (compiling from source):
------------------------------
There are additional distribution-specific information on Mikael's website at:
http://muuttuja.org/tomenet/installation-linux.php
(It's linked on www.tomenet.eu -> "Links".)

You can get the source from www.tomenet.eu, also see (1.1).

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

Dependencies, that you must make sure you have installed:
C-devel, X11-devel, ncurses, ncurses-devel and crypt libraries.
The package names are usually:
build-essential, 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.
If you don't want to use audio, edit the makefile and compare the two
paragraphs titled 'Without SDL' and 'With SDL' and edit the makefile
accordingly, to compile it without SDL audio support.
NOTE: If you are compiling the above packages yourself, make sure that you
install the specific audio format libs (smpeg, ogg..) _before_ you install
libsdl-mixer, so its configure script will recognize those formats and enable
support for the according file types.

Enter these two lines:
        make clean
        make tomenet
and the binary 'tomenet' will be created in this folder 'tomenet/src'.
IMPORTANT NOW: You need to move the binary 'tomenet' that was just created one
               level upwards, so it's placed in the 'tomenet/' folder!
Go up one level into your 'tomenet/' folder. There type:
        ./tomenet
to start the game.

If you get a font-related error ("Font not found: 9x15") please see PROBLEM 55
in chapter Troubleshooting (8.8).


Configure TomeNET on Linux by editing config files or setting environment vars:
(This is not really required. Most things can be configured by in-game menus or
by dragging/positioning the game windows with the mouse.)
-------------------------------------------------------------------------------
To configure which windows are visible and what font they use and all sorts of
other options, edit the file ".tomenetrc" which should be in your home folder
(or specify alternative location via -f command-line option, see below).

Note: If the game client's positioning of windows doesn't work on your system,
you can use other means such as KDE's native window positioning (right-click
the windows and modify the "special window settings" or "special application
settings") or the tool Devilspie (should be in your default repository) if
you're on Gnome or Xfce or anything else. 'gdevilspie' may also be available,
which is a graphical version of devilspie.

Alternatively to using the .tomenetrc file for window configuration, you can
also set environment variables. These settings will override .tomenetrc:
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
TOMENET_X11_FONT sets one font globally for all windows. It's overridden by
the window-specific font variables listed above though.
Depending on your system, some possible fonts are usually:
4x6, 5x7, 5x8, 6x9, 6x10, 6x12, 7x13, 7x14, 8x13, 9x15, 10x20, 12x24.

Last but not least, you may use the following command-line options:
-c                      force command-line interface instead of X11 etc.
                        Use it if you want to run the client within a terminal.
-e                      Create file 'tomenet.log' instead of displaying
                        error messages in the terminal
-f<config file>         use a different config file than ~/.tomenetrc
-i                      ignore the ~/.tomenetrc config file
-l<Account> <Password>  for example -lGandalf geheim
-m                      skip motd (message of the day) on login
-N<character name>      for example -NDruidor
-p<Port>                for example -p19348
<ip address>            for example 37.187.75.24
-q                      turns off loading/initializing of audio ('quiet mode')
-u                      disables automatic LUA script updating
                        (You should NOT use this option!)
-v                      automatically save chat log on exit
-w                      disables weather effects

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

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

(Skip down to (2.1a) to continue reading.)


Mac OS X (using pre-compiled binary; tested with Snow Leopard 10.6.6):
----------------------------------------------------------------------
Run the file 'TomeNET.run' to start the game.

If you're tech savvy and want to manually edit the TomeNET configuration file,
see "Configure TomeNET on Linux" further above.

Otherwise skip down to (2.1a) to continue reading.


Mac OS X (compiling from source; tested with Snow Leopard 10.6.6):
------------------------------------------------------------------
Basically use the same instructions as for Linux above. Additionally:

-To actually install gcc you will need to install the 'xcode' package, which
 contains gcc. Download the correct xcode version for your Mac OS X version
 from developer.apple.com. For this you will first need to create a developer
 account (choose the free account version of course).

-Download the required packages (tar.gz/tar.bz2 files from ftp.gnupg.org,
 ftp.gnu.org/pub/gnu and www.libsdl.org) listed in the Linux installation
 instructions above and extract, compile and install them each via the usual
   ./configure
   make clean
   make
   sudo make install
 command chain from a terminal window.
 Note: libsdl_mixer can be found on www.libsdl.org too, by clicking on the
 "Libraries" menu and searching for "mixer".

 If you have trouble installing those source packages, you could try to simply
 use MacPorts to fetch them, at http://www.macports.org/.

Dependencies:
-libgcrypt depends on libgpg-error, which you will need to install too.
-libsdl_mixer may complain about missing dependencies (at least Ogg Vorbis is
 required for TomeNET, since it's the official audio format - the rest is only
 needed if you add custom audio files in the according file formats):
  -Ogg Vorbis library (www.xiph.org -> libogg and libvorbis) for OGG file
   support, which is what the official TomeNET audio files are.
  -SMPEG library (icculus.org/smpeg) for MP3 file support. (libsdl_mixer's
   configure script May also list additional notes regarding the environment
   variable SMPEG_CONFIG, don't miss them.)
  -MikMod library (mikmod.raphnet.net) for various module music support.
  -FLAC library (flac.sourceforge.net) for FLAC file support.

-If you mess with compiler-related environment variables and paths and for
 whatever reason get a 'compiler cannot create executables' error when trying
 to ./configure packages, just close the terminal and re-open it, to reset all
 vars.

It is recommended to use the makefile called 'makefile.osx' for compiling.
If for whatever reason you try to use an unmodified Linux makefile to compile
then you might run into the following problems:

-ncurses starts hiding some internal properties at v5.7+ which causes a
 dereference error when trying to compile main-gcu.c. This seems to be a
 Mac OS X specific problem since only the ncurses shipping with Snow Leopard
 has NCURSES_OPAQUE set to 1 while the Linux version has not.
 To fix it, add
   -DNCURSES_OPAQUE=0
 to CFLAGS compiler options in the makefile.

-For preprocessing LUA files the 'cpp' variant does not work, the 'gcc' variant
 must be used instead: Edit the makefile, locate 'cpp' and comment out the two
 cpp-related lines and uncomment the two gcc-related lines, if it's not already
 like that by default.

-If the LIBS linker flags in the makefile say '-lcrypt' that will cause an
 error about library not being found. Change it to '-lgcrypt' to fix it.

-If the LDFLAGS are empty the linker will throw a not-found error 22. Fix this
 by moving (or copying) the -L... library search-folder parameters from LIBS to
 LDFLAGS so it contains all lib paths.


Configure TomeNET on Mac OS X:
------------------------------
Most things can be configured by in-game menus or by dragging/positioning the
game windows with the mouse, and do not require manual editing.

See 'Configure TomeNET on Linux' above, it's basically the same.
Mac OS X also uses the ".tomenetrc" configuration file which should be in your
home folder, same as Linux.


TomeNET on FreeBSD:
-------------------
Should be same as on Linux, except that the "8x13" standard font might not get
found, preventing TomeNET from starting. A fix according to "N der Fuenfte":
  root% cd /usr/ports/x11-fonts/xorg-fonts
  root% make install clean
  root% # restart X server, if in doubt, just reboot PC.
  Next
(0.1) Start & play