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

Search
Previous
(3.5) Preparing the first time for fighting enemies
Next
(3.7) Creating macros for ranged attacks & abilities (spells)
(3.6) Creating basic macros & inscribing items                                  
----------------------------------------------
Macros are absolutely obligatory, you _will_ need them, so read this
carefully and if something isn't explained well, ask your fellow players to
clarify.

In turn-based single-player rogue-like games you always have enough time to
press "q" (quaff a potion) followed by the according inventory slot, for
example b) (if there is a potion of cure critical wounds in the second
inventory slot).

However, TomeNET is multiplayer and real-time. This means you don't have
enough time to look at your inventory and search the correct letters for items
which you might need *this instance* to avoid certain death. Often situations
get hectic, for example if all of a sudden dark-elven warlocks come around
the corner while you are engaging a pack of wolves, then you need kind of a
panic button that quickly transports you out of trouble.

To comply with this need, a macro system has been implemented, allowing you to
program freely choosable keys of your keyboard to perform a series of other
keypresses or commands when pressed. These macros can also interact with
certain items of your inventory by using "item inscriptions". You can inscribe
items (usually with the '{' key) as often as you like to, the inscription is
for example useful if an item has special abilities that you want to remember
by looking at it. To remove an inscription, use the } key.
You would for example inscribe an Elven Cord Armor that you know helps you to
resist the effects of poison. Then it might look like this in your inventory:
Before: d) an Elven Cord Armor [6,+20] (+1) {+,10}
After:  d) an Elven Cord Armor [6,+20] (+1) {+,10} {resists poison!}
Inscriptions don't just help you to remember the abilities of certain items,
they can also interact with the macro system and other aspects of the game.

Usually if you want to quaff your potion of Heroism or read a scroll of Phase
Door, you would press keys 'q' 'c', q for quaff, then c for third inventory
slot for example, or 'r' 'd' (r for read, then d for the fourth inventory
slot, if your scroll resides here).
However, if you just picked up another potion, your inventory order might be
changed and you had to remember the new positions of your vital potion and
scroll.

Now we are going to create three macros that will instantly quaff the potions
or read a scroll of recall, no matter where in the inventory they exactly are,
on a single keypress! Inscribe the potion of Heroism "@q1", the scroll of
Phase Door "@r1" and the potion of Cure Light Wounds "@q2".
It should look like this now:
b) a potion of Heroism {+,1} {@q1}
c) a potion of Cure Light Wounds {+,1} {@q2}
d) a scroll of Phase Door {+,1} {@r1}

Now we will create macros that make use of these items. Invoke the macro menu
by pressing '%' key. Then choose "(a) Enter a new action" and enter the
following two characters and press Enter:
q1
Now choose "(h) Create a hybrid macro", then press the F1 key.
Now enter a new action, this time q2 instead of q1. Create another macro, this
time hit F2. Then Enter the third macro, r1, and choose F3 key.
Have your TomeNET client save the macros to a file on your hard disk, in your
TomeNET directory at \lib\user by choosing "(s) Save macros" and entering a
filename, or simply confirming the shown default file name which is the same
as your character (recommended!).

Now if you press F1 you will automatically quaff the potion of Heroism, F2 for
Cure Light Wounds and F3 to read the scroll. You are ready to enter the
dungeon now. If you still have some spare money, buy a flask of oil to fuel
your lantern if it runs out, as well as some rations of food in case you get
hungry.
The next time you log on, you may load your previously saved macro file by
invoking the macro menu again ('%'), choosing "(l) Load macros" and
entering the filename. If you saved the macros to the same name as your
character, they will be automatically loaded, saving you that hassle.

An even simpler way to create macros is the 'macro wizard' described in (3.7c).


The macro recorder:
-------------------
Note that instead of entering an action string (such as 'q1' or 'r5'), the
macro menu also provides a 'macro recorder', which when invoked will record
all your key presses until you enter the macro menu again. Then the keys
you pressed will be the default action that you can directly bind to a trigger
key by choosing normal, command, or hybrid macro.


Note that while it is probably overkill to create macro hotkeys for items
which aren't as important as healing or teleportation, inscribing them can
still be helpful because it allows you to easily access them.

Example: You inscribed your flasks of oil @F1 . Now if your lantern is running
low on oil you just type the keys 'F' (to fill) and '1' instead of having to
search your inventory for the correct slot letter the oil flasks reside at.
Same goes for other items that aren't used in time-critical situations during
combat but nevertheless regularly, like scrolls of identify.

If two items have the same inscription, for example Potions of Cure Critical
Wounds @q1 and Potions of Healing @q1, the item which is above the others in
your inventory is chosen. So in this example you'd first use up all CCW
potions, then use the healing potions because CCW are located above healing
potions in your inventory. You can uninscribe items with the '}' key.


Loading macros automatically:
-----------------------------
If you save your macros to a filename that is the same as your character's
name and add a '.prf' at the end, it will be automatically loaded as you
join a game with your character, which is very helpful!
Example: If your character is named 'Kinkan', save the macros to Kinkan.prf
to have them loaded automatically.
Note: If you're using a Linux version, remember that the file system is
case-sensitive, so don't save your macros to 'kinkan.prf' since your character
actually starts with a capital 'K' or the file won't be loaded. Make sure
the filename and character-, class-, race- or trait-name are exactly the same
('Dwarf.prf', 'High-Elf.prf', 'Ranger.prf', 'Enlightened.prf'..).
Another option is to save the macros to a file named 'global.prf' (all lower
case letters). This is a special macro file that will always be loaded, for
all characters of yours.
You can also save macros to <racename>.prf, to <classname>.prf and to
<traitname>.prf, like Warrior.prf to have them being auto-loaded on all
characters of that class/race/trait.
Priority order (latter one overrides prior one):

These files are meant to store client options and configuration,
you should NOT use them for macros:
-----------------------------------
pref.prf (global for all OS and users on the system)
*.opt files (client options configuration files, ending on ".opt")
pref-<operating system>.prf (loaded if under the specific operating system)
graf-<operating system>.prf OR font-<operating system>.prf
                            (loaded if using graphics / ascii font on the
                             specified system)
user-<operating system>.prf (loaded if under the specific operating system)

These files can be used for saving your macros to without problems:
-------------------------------------------------------------------
'global.prf' (is always loaded for any character the player logs in with.
               be sure to use all lower-case letters, not 'Global.prf'!)
<race>.prf (for the specific race)
<trait>.prf (for the specific trait, particularly useful for Maiar)
<class>.prf (for the specific class)
<character name>.prf (for the specific character the player logged in with)

It is recommended to use only race/trait/class/character preference files
for storing your macros.


Command macros:
---------------
Command macros are only executed if the game isn't currently waiting for a
specific input, for example "quaff which potion?" or while you're typing chat
messages. That means they won't "disrupt" any other command which is currently
being run. This is convenient for keys which you use in chat, but can be
dangerous if you define vital macros as command macros.
It is recommended to make your most important macros normal macros or at least
hybrid macros (for example a "panic key" macro). Command macros don't work
in shops.


Hybrid macros:
--------------
Use 'create hybrid macro' instead of 'create normal macro' in case you don't
want the macro to appear on hitting the corresponding key in a normal chat
message (for example useful for '-' key so it won't prevent you from
inscribing your Word of Recall scrolls).
Hybrid macros still work within input requests such as "quaff which potion?",
just not in STRING INPUT such as chat lines, polymorph-codes or money amounts.
Hybrid macros don't work in shops.


Delete macros:
----------------
If you accidentally bound a macro to a key which wasn't free, for example
the key 'r' which is used to read a scroll, you can reset the key by
-pressing % to invoke the macro menu
-choosing '(d) - delete macro'
-pressing the key wich you want to reset.
Previous
(3.5) Preparing the first time for fighting enemies
Next
(3.7) Creating macros for ranged attacks & abilities (spells)