TomeNET

(0.3) Important inscriptions, Word of Recall                                    
--------------------------------------------
To inscribe an item, press the { key. To uninscribe, press }.
You can also mass-inscribe/uninscribe items by using the commands /tag or /t
and /untag or /ut respectively (see (0.2b) for command details).
Brackets [ ] are not to be typed in actually, but just indicate that the
parameter inside them is optional, meaning you may or may not specify it, as
you prefer.

The ! inscriptions:
    Inscribing an item with an '!' followed by a key will - for most keys -
    cause that key to cease working on the item anymore. There are also some
    special !-combinations that do different things (eg !B on magic devices)
    which are all listed below. You may also specify several keys after a '!'.

    A space ' ', '@' symbol, '#' hashtag or '-' minus sign will end parsing the
    !-sequence.
    Example: You inscribe a 'Scroll of Artifact Creation' this way: "!kd rawr".
    Now you cannot destroy or drop the scroll anymore (keys to destroy and
    to drop an item are 'k' respectively 'd').
    However, you can still 'r'ead the scroll, because the 'r' in the "rawr"
    part is not parsed as it is separated by a space from the "!..." sequence.
    You can inscribe an item by pressing '{' and uninscribe it with '}'.

    !* inscription, this is a "combo" shortcut inscription.
        *       is a 'wild card' which stands for multiple inscriptions at,
                once inscribing an item '!*' will do ALL of these checks:
        !d      Prevent dropping an item.
                If on a bag this will also prevent storing it in a list house.
        !k      Prevent killing (destroying) an item. (Note that '!k' on a
                torch also prevents using that torch to refuel another one.)
        !s      Prevent selling an item to shop (!s).
                If on a bag this will also prevent storing it in a list house.
        !v      Prevent throwing an item away.
        !=      Automatically pick the item up from the floor.
        !h      (Prevent selling a house key. Keys usually aren't used anymore
                though.)

    For example, if you found a great item and you want to avoid accidentally..
    (d)ropping it, (s)elling it, (v) throwing it or (k)illing it, you could
    either inscribe it   !dsvk   or just   !*   (implies != too, but whatever).

    !+ inscription:
        Implies !k, !s, !=, !h.
        So it does the same as !* except that it does not prevent dropping or
        throwing an item. This can be useful for throwing weapons for example.

A very useful inscription for (heavily) cursed items:
    !w          Prevent wielding/wearing an item. This is very useful if you
                carry a cursed item in your inventory that you really don't
                want to equip by accident.

    !W[n]       Give a warning (message colour and sfx) when the stack size aka
                amount of this item reaches or goes lower than n.
                Also, the inventory slot letter will change to orange colour.
                If n isn't specified it will use the default value '10'.
                This is useful for consumables such as healing potions, to
                draw your attention to them when you're running low.
                Eg: !W15
                (This warning can only get triggered when the count of the item
                stack is reduced, eg when an item is consumed.)
                WARNING: Don't confuse this inscription with !w. It does NOT
                prevent wielding an item!

Useful for characters who wield a boomerang not for throwing it, but rather
because it provides magical boni:
    !f          Prevent firing an item (ie your equipped ranged weapon).

Other ! inscriptions:
    !T          Prevent taking off a secondary item.
    !F          Prevent using up this light source or fuel item to fuel your
                currently equipped light source. (Note that !k inscription
                implies this too.)
    !Fn         If the server has the (experimental) Demolitionist perk enabled
                this inscription can be used on blast charges to customize the
                fuse length to n seconds, where nn must be within 0 to 15.
                Eg: !F15
    !E          Prevent eating this food item.
    !q          Prevent quaffing this potion.
    !r          Prevent reading this scroll.
    !u          Prevent using a staff.
    !a          Prevent aiming a wand.
    !z          Prevent zapping a rod.
    !A          Prevent activating an activatable item.
    !L          Can be used on a scroll of Artifact Creation. The resulting
                randart will not gain +LIFE ('it affects your hit points') mod.
                So this is an inscription that only makes sense for winners to
                use, since non-winners cannot generate +LIFE on randarts
                anyway.
    !U          This item will be displayed in dark grey colour in your
                inventory or equipment. Can be useful for sorting loot.
                (A warning: You cannot visually distinguish this colour for
                items that are greyed out because they are unusable to you.)
    !S          Prevents auto-stowing this item into any bags.

Mainly for consumable items:
    !Q          will not print a message how many you have left after consuming
                one (like if 'taciturn_messages' were enabled). For example use
                on ID scrolls in combination:  !XQ
Mainly for consumable items stored in piles:
    !g          trying to pick up this pile will only grab 1 item, as if the
                player pressed CTRL+G (or CTRL+Z with rogue-like key set).

The # inscription:
    This one makes all following inscription be appended directly behind the
    actual item name, instead of at the end of the item's full description.
    It can be especially convenient if the item has a very long name.
    Sometimes you can also use this to confuse your fellow players :-p

Player-store inscription:
    @S          This inscription has a variety of different usages and is used
                for displaying items in your own shop that you can set up in
                any of your houses. For more information see (4.10a).

Items that 'can cause Earthquakes':
    !Q          Prevents the item from causing an earthquake. This usually
                only works on the artifact "The Mighty Hammer 'Grond'".
                (Press keys  ~i  in the game to check server settings.)
                See (5.11) for more information about earthquakes.

Weapons/ammo, devices and spells:
    @O          This and its variants control the 'auto-retaliator' which is a
                mechanism designed to make your character automatically attack
                targets that are standing directly adjacent to you.
                For details about auto-retaliation and the different types of
                @O... inscriptions, see (4.1a)!

Items that can recharge magic devices (eg Scrolls of Recharging):
    @I<partial item name>
                Will not prompt for a target item but try to find the target
                item matching the partial item name specified after '@I'.
                Only magic devices will be considered as target items.
                Example:
                "A Scroll of Recharging {{1} {@r4 @IWond}"
                If this scroll were read, it would try to enchant a magic
                device which name partially matches "Wond". So if you carry
                a Wand of Wonder in your inventory, the scroll would try to
                recharge that one.
                You can also specify (parts of) an inscription of a target
                item, for example "@Imydev" or whatever you like.

For magic devices:
    !B          Will play a beep sound if you either fail the activation roll
                to use the device or if the device is out of charges or still
                not charged up respectively, depending on the type of device.
                For all other cases of activation failure this inscription has
                no effect.

Rods only:
    !C          Will notify you when the rod finished recharging.

Wands and directional rods:
    !F          Will enable fire-till-kill mode for this item, provided that
                you have turned on fire-till-kill mode the usual way ('m' key).

Wands and staves:
    !D          Will automatically discharge the device first when a recharge
                attempt is made (to minimize the risk of blowing up at the
                tradeoff of discarding the extra charges).

Ammunition:
    !=          Will make your character auto-pickup the ammo from the floor.
    !b          Will make your ammunition break. Rather disadvantageous but
                maybe useful if you use rather worthless ammo that you don't
                want to pick up again and don't like littering the floor with
                it.
    !M          Makes ammunition stacks of same base type and same ego power
                stack even if +hit or +dam enchantments are not equal. Those
                will be averaged and rounded downwards. (Doesn't work for
                cursed or artifact ammo.) Wield the !M stack first, then also
                wield the stack you want to merge with the equipped ammo.

Ammunition, boomerangs, (throwing) weapons:
    !L          Inscribe stacks of ammo in your inventory !L to make them be
                automatically reloaded into your quiver as soon as the ammo
                you're currently using runs out.
                Note that you can place ammo in your inventory in the desired
                order for reloading by dropping it/picking it up again!

                The !L inscription also works for boomerangs (eg in case your
                boomerang drops to the floor instead of returning to you).

                Last but not least it also works on any kind of weapons,
                specifically useful for throwing weapons, but also to recover
                faster from disarming attacks if your weapon dropped to the
                ground. Just inscribe it !L= for auto-pickup and auto-equip.
                Note that !L only works when picking up an item from the floor!

Slings/sling ammunition and boomerangs:
    !R          Prevents ricochetting.
    !O          Allows ricochetting against sleeping/charmed monsters.
                Has no effect if 'Sling-mastery' is lower than 25.000 or
                respectively if 'Boomerang-mastery' is lower than 30.000,
                as the character is not able to control ricochetting well
                enough at lower skill levels to actually have a choice.

Scrolls/spell books of Identify (except for bag-ID), Rods/Staves of Perception:
    !X[n]       If you pick up an unidentified item, you will automatically
                read a scroll to identify it.
                This inscription also works on 'The Stone of Lore'.
                It does not work for Arcane Lore, since that is purely a bag ID
                spell.
                Note that the !X inscription only makes one attempt each time
                you pick up an item. That means if you use means that can fail,
                such as spells or magic devices, and you do fail, there will be
                no automatic retry, you will have to ID it manually.
                An optional number can be specified after the "!X" to restrict
                which items will be identified:
                 0: Only ID flavoured items.
                 1: Never ID flavoured items.
                Eg: !X0
                See (5.7) for more information about identification.

Gift wrappings:
    !$<amount>  Wraps an amount of gold pieces instead of an item, when
                you activate the gift wrapping. Eg: '!$100'.

Bags (subinventory):
    !A[0|1]     Do not auto-stow items into this bag.
                0: Except if they stack with existing items.
                1: Except if they are at least similar(*) to existing items.

    !O[0|1]     Do not auto-stow unowned items (ie new loot) into this bag.
                0: Except if they stack with existing items.
                1: Except if they are at least similar(*) to existing items.

    !S[0|1]     Only auto-stow items into this bag when buying from store.
                0: And only if they stack with existing items.
                1: And only if they are at least similar(*) to existing items.

    (*) 'Similar' just means they can stack with the item, but there might not
        be enough space to get fully absorbed into the existing stack.
        So only part of the items may stack and the rest or even all of it has
        to be placed into a fresh, empty bag slot.

    Also see !S inscription for items, which prevents auto-stowing an item.

Any item in your inventory:
    !G[n]       Prevents an item from stacking with other items in any case.
                If an optional number n is given, it will stack items up to
                this stack size, at most 99. Usage examples: !G  or  !G34  .
                If 'n' s specified, the inventory slot letter will change to
                yellow colour if the current stack size is lower than 'n'.
                If picking up items that are inscribed !Gn and matching items
                in your inventory are also inscribed !Gn then the lower n value
                of the two is used. n must be at least 1 or it is same as !G.
                If picking up a pile of items that exceeds the n value of a
                matching stack in your inventory, then only the fitting amount
                to saturate your inventory stack is picked up and the rest of
                the pile will remain on the ground. So after that if you press
                'g' again to pick up the rest...
                If you pick up a pile of items when a matching stack in your
                inventory is already fully saturated, then the pile (or single
                item, whatever) is placed into a new inventory slot.
                This inscription works with picking up items from the floor,
                purchasing items from a store, stealing items from a store and
                taking items from a list house (shop-style house).

                QoL effects:
                You can use force-stack to combine !G stacks, overriding the
                inscription.
                When dropping/selling items from a !G stack which exceeds its
                nominal capacity, the suggested default amount will be exactly
                the difference between actual stack size and inscription-based
                capacity.

    !K[n]       Inscribed on an inventory item, will auto-destroy any further
                items you acquire beyond the amount of n.
                If n is omitted, the default value of 15 will be used.
                Use this mainly for empty bottles, especially in conjunction
                with the 'keep_bottle' option enabled, to prevent uncontrolled
                amassment of empty bottles. Example:  !K10
                (This inscription does not work on artifacts or ego items.)

    !%          This will not actually be inscribed. The item will keep
                its current inscription (or remain uninscribed if it was).
                Instead, the item's discount will be set to 100%, making
                it unsalable to NPC stores permanently.

Some examples for inscriptions to use with macros:
  An item that can be activated:
  Eg:  @A1      Pressing the keys 'A' and then '1' will activate that item.

  A potion:
  Eg:  @q3      Pressing 'q' then '3' will quaff that potion.

  A magic scroll:
  Eg:  @r0      Pressing the keys 'r' and '0' will read that scroll.

etc.. you get the idea. :)


There is also a special variant of the tag-macro inscription, when you have
only one type of item you want to use for a specific action, for example
refilling your torch from a stack of spare torches in your inventory:
  @<commandkey>%

When you press the <commandkey>, This macro will not prompt for an item but
immediately use the inscribed item for the action.
Example for refilling your equipped torch with torches in your inventory,
inscribe the torches in your inventory:
  @F%

Now if you press F (that is Shift+F) to refill torch, you will not get prompted
but one of the inscribed torches is automatically used for the macro.
The same macro works for oil flasks too, to refill a lantern.

Note that if you make a macro for an item inscribed with '%' shortcut that you
will end up with a pending inventory prompt if you are out of items, even if
you have safe_macros enabled, as the macro system cannot know that you intended
to not enter an actual item!
In this case as a workaround to clear the inventory prompt in case you are out
of items to use with the macro, you can add an '\e' (ESC) to the macro, eg:
 For refilling light:  \e)F\e
 For using a staff:    \e)u\e
 etc...


You can also inscribe items just to remember their abilities. For example
if you find an armour that is an artifact, and you found out it resists
fire and acid, you might inscribe it {ResFire,ResAcid} so that you will
remember what it does just by looking at it and reading the inscription.
It can make your life easier if you wear lots of items that have different
resistances or abilities. A shortcut is the...

Item power inscription (added in 4.7.1):
    @@         Will automatically inscribe an item with codes representing its
               special powers. Only works with *identified* items.
               Can also be used on custom spell books. If used on handbooks or
               tomes however, it works like @@@, shortening the spell names.
    @@@        Redux version. Omits infra-vision, searching, and mods that
               are obvious because they can only come from base item type
               (disarm, digging, luck), light radius, slays and brands except
               for kill-flags, partial ESPs, trap kits' eligible enemy type.
               Can also be used on custom spell books, will shorten the names.
               Will also shorten explosion-type names on exploding ammunition.

    Resulting inscription details:
    _S                sustain stat (S/I/W/D/C/H, where H is cHarisma)
    +S                increase stat
    ^S                increase and sustain stat
    -S                decrease stat
    Xm/Xs             extra might/extra shots (ranged weapons)
    HP/MP             +hit points/+mana
    Spd/Att/Crt/Stl   +speed/+extra attacks/+critical hits/+stealth
    Src/IV/Dsr/Dig/Lu +searching/+infra-vision/+disarm/+digging/+luck
    Eq/Cht/Va/Vo      earthquakes/chaotic/vampiric/vorpal
    *F/C/E/A/P/W/N*   immunity to an element (fire,cold,electricity,acid,
                      poison,water,nether)
    Base              resistance to the four base elements (same as 'fcea')
    f/c/e/a           resistance to a base element (fire,cold,electricity,acid)
     Resistances to high elements:
    Po/Wa/Nt/Nx/Ca/Di poison/water/nether/nexus/chaos/disenchantment
    So/Sh/Lt/Dk/Ti/Ma sound/shards/light/darkness/time/mana
     Further resistances:
    Bl/Cf/RT/FA/HL/Fe blindness/confusion/teleport/free action/hold life/fear
     Other flags:
    SI/Lv/FF/SD       see invisible/levitation/feather falling/slow digestion
    Rg/Rgm            regenerate hit points/regenerate mana
    Refl/Inv/AM/Bless reflection/invisibility/anti-magic shell/Blessed
    ID                auto-ID
    Climb/Swim/Wraith climbing/swimming/wraithform
    *Auto*/Auto       (fully) automatic trap kit
    <D>/<U>/<a>/<W>/<Evil>
                      trapkit's eligible target monster type:
                      Dragon, demon, animal, undead, evil.
    Wf                trapkit can harm wraithform (PASS_WALL) enemies
    Tt                trapkit casts teleport-to-player on enemies
    AF/C/E            aura of fire/cold/electricity
    BF/C/E/A/P        brand of fire/cold/electricity/acid/poison
    +oTPaWUDEvil      slay orc/troll/giant/animal/undead/demon/dragon/evil
    *WUD              kill undead/demon/dragon
    ~oTPaWUDEvil      ESP orc/troll/giant/animal/undead/demon/dragon/evil
     SDRAgUni          spider/dragonrider/good('A')/nonliving('g')/unique
    ESP               telepathy (full ESP)
    Tele/NT           induces random teleportation/allows no teleportation
                      Note: No-Tele always overrides teleportation (except for
                      Zu-Aon), so if you have both these flags, No-Tele will
                      "win" and you will not teleport.
    Dr/Drm/Drx/Aggr   drains hp/mana/experience / aggravates
    Exploding ammunition will have its explosion type added in parentheses.

If you want an inscription starting on @ to follow a @@ inscription, add a
space or some other character as separator in between, to avoid it being
wrongly treated as @@@ inscription. For example like this:
    "@@ @S" or "@@-@x0"


Word of Recall, provided by items (scrolls and rods) or spells:
---------------------------------------------------------------
'Word of Recall' is far-distance teleportation magic that is used to either
travel into or out of a dungeon or across the world map.

When initiated, it will usually display this message in orange:
'The air about you becomes charged...' - or similar, depending on the exact way
the recall magic is initiated.
However, it will not recall you immediately. Rather it will take a short amount
of time until recall actually kicks in.
Before that happens it is possible to cancel the pending recall magic again by
initiating another recall (eg reading another scroll of 'word of recall').
Again an orange message will inform you about the recall spell being cancelled:
'A tension leaves the air around you...' - or similar.
In special circumstances recall magic cannot be used at all, resulting in an
orange message again, that goes similar to this:
'There is some static discharge in the air around you, but nothing happens.'

If you use these without inscription, they will just teleport you back into the
dungeon you came from, to the deepest possible floor. If you use them on the
world surface without inscription and there is no dungeon at your location that
you have previously visited, they will instead teleport you back to the last
town you visited.
    Travel into a dungeon/tower:
    @R500       will teleport you to depth 500ft (tower).
    @R-350      will teleport you to depth -350ft (dungeon).

    World travel:
    @RW32,32    will teleport you to sector 32,32 on the worldmap (Bree).
                World map ranges from 0,0 to 63,63.

    or even better for any kind of recalling..
    @R          This inscription makes the above versions sort of obsolete.
                If you have inscribed a Word of Recall item like this then you
                can just type the command    /rec    into chat to invoke
                the Word of Recall. Examples replacing above inscriptions:
                /rec 500
                /rec -350         <- when option depth_in_feet is 'yes'.
                /rec -7           <- when option depth_in_feet is 'no'.
                /rec 32 32        <- notice: No komma between the coordinates!

    NOTES:
    1) You must've already been at that depth or deeper in order to teleport
       there via WoR! And you must have been alive, not dead (ie a ghost).
    2) In order to recall to a place on the world map, you need to have been
       there before, not while you were dead (ghost), but while you were
       alive! Temple priests actually won't revive ghosts either who have not
       been to this place alive previously. So don't try to travel to Gondolin
       as a ghost, the priest over there will reject you and you won't remember
       the place when you return and revive in Bree.
    3) You can recall either across the world map or into/out of a dungeon, but
       not both at once. So if you want to go from Bree into the Orc Cave, you
       need two scrolls, first to go from Bree to the Orc Cave entrance located
       on the world surface, second to teleport down into the Orc Caves.
    4) Note that Word of Recall has a maximum range when used to travel across
       the world map. So if you want to recall from town A to town B you might
       require more than one recall spell depending on the distance.
    5) If you cast another Word of Recall while you're still waiting for one to
       kick in, the effect will be cancelled! That way you can change your mind
       if you suddenly spot a monster you want to go and kill after you already
       read a scroll of WoR.
    6) After being recalled the player will receive 'stair GoI' (a temporary
       extra protection from taking damage) for a short amount of time, see
       (0.4) for details.

    EXAMPLE:
    A player is in Bree (32,32) and wants to recall to Orc Cave -300ft which we
    assume is located at (31,25) and he has already been there before, so he
    can use Word of Recall to get there. He has his WoR scrolls inscribed '@R'
    and now types the following chat commands in order:
        /rec 31 25
        (he waits until that kicked in and transported him to Orc Cave surface)
        /rec -300    or    /rec -6    depending on option 'depth_in_feet'.
        (this will bring him to the desired depth, from the surface).