1 # autopick.txt for Hengband
3 # The last part of this file is an example of 'pickpref.prf'.
4 # You can copy this file to lib\user\ or ~/.angband/Hengband/
5 # to use as preference of auto-picker.
6 # (UNIX user must copy to ~/.angband/Hengband/. Others must
9 # ===== How to use auto-picker/destroyer ========
11 # Press the _ in a game to enter editor mode for preference of
12 # auto-picker/destroyer. Basic usage of the editor is almost same
13 # as vi, and also have emacs like commands. Most commands is
14 # always displayed on the first line and the right half of the
18 # 'a', 'i' or ^Q : Enter insert mode from command mode
19 # ESC or ^Q : Return to command mode from insert mode
20 # 'q' : Quit the editor (command mode only)
21 # 'hjkl2468' : Move cursor (command mode only)
22 # ^B ^N ^P ^F : Move cursor (always)
23 # ^I : Choose an item from inventry/equipment, then insert its name
24 # ^S : Rotates action (pick up / destroy / leave on floor)
25 # ^U : Rotates identify state (identified / unidentified / ...)
26 # ^L : Insert name of the last auto-destroyed item.
27 # '/' : Search string, or search an item specified by ^I or ^L.
29 # 'N' : Search previous
31 # The preference will be saved in a file named
32 # "pickpref-<<name>>.prf" in your user directory; This will be
33 # ~/.angband/Hengband/ for UNIX, or hengband\lib\user\ for other
34 # operating systems. You may edit this file using any text
35 # editor, and may use the '$' command within the game to reread
36 # this file. When you don't use the in-game editor, you may use
37 # "pickpref.prf" as preference file.
39 # When there are both files, the game will read the file
40 # "pickpref-<<current character name>>.prf" first and then read
41 # the file "pickpref.prf". The first-read file takes priority.
44 # Maximum number of active lines is 1009.
45 # A line with a header '#' is a comment.
52 # Each line determines the actions taken when you step over
53 # a kind of object. Starting a line with '!' indicates that you
54 # wish to destroy this kind of object. Starting a line with '~'
55 # indicates that you wish to leave this kind of object on the
56 # floor. Starting a line with ';' indicates that you wish to
57 # force the game to ask you if you want to pick the item up or
58 # not. Otherwise, your character will automatically attempt to
60 # There is an additional command letter '('. It indicates that
61 # you don't wish this item to be displayed in full map. see below.
64 # If you want to disable the effect of the '!' indicator temporally,
65 # use 'always_pickup' option.
69 # After the command letter may come one or more keywords. They are:
71 # all : All items match.
72 # collecting : Matches if you already have that same item.
73 # unaware : Items with unknown effects match.
74 # unidentified : Unidentified items match.
75 # identified : Identified items match.
76 # *identified* : *Identified* items match.
77 # dice boosted : Weapons with boosted damage dice match.
78 # more than N dice : Weapons with dice (dd * ds) better than +N match.
79 # more bonus than N : Items which has more magical bonus than (+N) match.
80 # worthless : Items which you cannot sell match.
81 # artifacts : Artifact items match.
82 # ego : Ego items match.
83 # good : {good} items match.
84 # nameless : Non ego/non artifact items match.
85 # average : {average} items match.
86 # rare : Rare equipment such as Dragon armors etc. match.
87 # common : Any equipments except 'rare' equipment match.
88 # wanted : Wanted monster's corpses or skeletons match.
89 # unique monster's : Unique monster's corpses, skeletons or statues match.
90 # human : Human corpses or skeletons match.
91 # unreadable : Spellbooks other than those you can read match.
92 # first realm's : Your first magic realm's spellbooks match.
93 # second realm's : Your second magic realm's spellbooks match.
94 # first : First one of four spellbooks in each realm match.
95 # second : Second one of four spellbooks in each realm match.
96 # third : Third one of four spellbooks in each realm match.
97 # fourth : Fourth one of four spellbooks in each realm match.
99 # items : All items match. Use it with an adjective for
100 # readability (i.e. "unaware items").
101 # weapons : All weapons including missile weapons match.
102 # armors : All armors match.
103 # missiles : Arrows, bolts, and shots match.
104 # magical devices : Wands, staffs, rods and scrolls match.
105 # lights : Light sources match.
106 # junks : Junk items like Shard of Pottery or etc. match.
107 # corpses or skeletons : Corpses or skeletons of monsters match.
108 # spellbooks : All books match.
109 # favorite weapons : Weapons suitable for your class (for Priest, Monk,
110 # BeastMaster, ForceTrainer, Cavalry, and Ninja)
112 # You may also use keywords which match specified kinds of equipment:
113 # weapons, armors, missiles, magical devices, lights, junks, spellbooks,
114 # hafted weapons, shields, bows, rings, amulets, suits, cloaks, helms,
119 # After the keywords, you may write a character string. Only items
120 # whose name contains this character string as part of their name match.
121 # Upper or lower case makes no difference.
122 # You must insert a ':' between your special keywords and character
123 # string, if both exist in one line.
125 # Force start-of-line matching:
126 # If the first character in a character string is '^', then the
127 # character string must match the beginning of a line.
129 # !Mace // Destroy Maces and Lead-Filled Maces.
130 # !^Mace // Destroy only Maces.
136 # Meaning: "destroy all items that are worthless"
139 # Meaning: "pick up all unaware potions"
141 # ~unidentified lites
142 # Meaning: "leave all unidentified light sources on the ground"
144 # unidentified more than 25 dice weapons
145 # Meaning: "pick up all weapons with dice that total more than 25. A
146 # weapon that is 2d13 qualifies, a weapon that is 5d5 does not."
149 # Meaning: "pick up anything that includes in its name the word
152 # potion of Experience
153 # Meaning: "pick up anything named 'potion of experience'"
156 # Meaning: "Pick up light sources named stone"
159 # Meaning: "Pick up gauntlets of slaying. Not rings of slaying."
164 # Lines will be evaluated in order, and first matched line will be
165 # applied. So you can write names of specific excellent items to pick
166 # up, followed by a general item name with '!' to destroy useless items.
169 # ! In full map command ('M'), you can press M, N, K, or D to
170 # ! display locations of items for auto-pickup, leaving, auto-destroy
171 # ! or both auto-pickup and leaving.
172 # ! Additional command letter '(' prevents this display.
175 # If you begin the last string in a line with '#', this string will
176 # be automatically inscribed on the item.
179 # Strict syntax of each line is below.
182 # [[all] [collecting]
183 # [unaware] [unidentified] [identified] [*identified*]
184 # [artifact] [ego] [good] [nameless] [average]
185 # [worthless] [rare] [common]
186 # [dice boosted] [more than N dice] [more bonus than N]
187 # [wanted] [unique monster's] [human] [unreadable]
188 # [first realm's] [second realm's] [first] [second] [third] [fourth]
189 # [items | weapons | favorite weapons | armors | missiles |
190 # magical devices | lights | junks | corpses or skeletons | spellbooks |
191 # hafted weapons | shields | bows | rings | amulets | suits | cloaks |
192 # helms | gloves | boots] :]
193 # [[^]part-of-item-name] [#auto-inscription-string]
196 # ======= How to use Conditional Expressions ========
198 # The lines of pickpref.prf can be disabled/enabled using
199 # conditional expressions.
200 # The syntax is the same as that of other preference files.
202 # - usage of condition expressions
204 # If result of expr is "0", all lines below are disabled.
205 # If result of expr is "1", all lines below are enabled.
206 # Caution:It cannot be nested.
208 # - usage to include other file
210 # Read a file named 'filename' as a new pick-pref file. The file
211 # must be in the user directory.
213 # - usage of operators
214 # [EQU arg1 arg2 ...]
215 # If all args are the same as arg1, returns "1", or else returns "0".
216 # [IOR arg1 arg2 ...]
217 # [AND arg1 arg2 ...]
218 # IOR evaluates and returns all args' logical OR. AND is logical AND.
220 # Returns "0" if arg is "1", or else returns "1"
221 # [LEQ arg1 arg2 ...]
222 # [GEQ arg1 arg2 ...]
223 # Compare args as string. LEQ returns "1" if (arg1 <= arg2 <= ...) ,
224 # GEQ returns "1" if (arg1 >= arg2 >= ...) otherwise returns "0".
226 # - Special variables
228 # Returns name of player race. One of below:
229 # Human, Half-Elf, Elf, Hobbit, Gnome, Dwarf, Half-Orc,
230 # Half-Troll, Amberite, High-Elf, Barbarian, Half-Ogre,
231 # Half-Giant, Half-Titan, Cyclops, Yeek, Klackon, Kobold,
232 # Nibelung, Dark-Elf, Draconian, Mindflayer, Imp, Golem,
233 # Skeleton, Zombie, Vampire, Spectre, Sprite, Beastman, Ent,
234 # Archon, Balrog, Dunadan, Shadow-Fairy, Kutar, Android,
237 # Returns name of player class. One of below:
238 # Warrior, Mage, Priest, Rogue, Ranger, Paladin,
239 # Warrior-Mage, Chaos-Warrior, Monk, Mindcrafter, High-Mage,
240 # Tourist, Imitator, BeastMaster, Sorcerer, Archer,
241 # Magic-Eater, Bard, Red-Mage, Samurai, ForceTrainer,
242 # Blue-Mage, Cavalry, Berserker, Weaponsmith, Mirror-Master,
246 # Returns player name.
248 # Returns player's first magic realm
249 # none, Life, Sorcery, Nature, Chaos, Death, Trump, Arcane,
250 # Craft, Daemon, Crusade, Music, Kendo
252 # Returns player's second magic realm
254 # Returns player level as two-character string.
255 # Ex. "01","09","10","50" etc.
257 #------------------------------------------------------------------
259 # Below is an example 'pickpref.prf' file.
260 # You can copy this file to lib\user\ or ~/.angband/Hengband/.
261 # (UNIX user must copy to ~/.angband/Hengband/. Others must copy
264 #------------------------------------------------------------------
269 # Berserker cannot use magical devices; rods, wands, and scrolls.
270 ?:[EQU $CLASS Berserker]
277 unidentified lights:^Jewel#!!
278 unidentified lights:^levitation stone#!!
279 unidentified lights:^Palantir#!!
280 unidentified lights:^stone#@A0
281 unidentified lights:^star#!!
282 unidentified lights:^Incandescent Light
283 unidentified lights:^Phial#!!
285 # auto inscribe resistances (see lib/help/objects.txt#Inscriptions)
286 ~*identified* artifacts#%all
289 # pick all items which can stack your inventory without inscription.
300 ~rod of Perception#@z0!k!!
303 ~rod of Enlightenment#k!!
304 ~rod of Detection#!k!!
306 potion of Invulnerability#!k
309 potion of Augmentation
316 potion of constitution
317 potion of intelligence
324 # Magic-Eaters pick up all magical device to absorb.
325 # Skeletons is material of missiles for Archers.
326 # Ninja needs lights of darkness.
327 # Vampire needs darkness.
329 ?:[EQU $CLASS Magic-Eater]
333 ?:[EQU $CLASS Archer]
338 ?:[EQU $RACE Vampire]
343 # Destroy unless very early stage.
345 (!amulet of Adornment
346 (!potion of Apple Juice
351 # These worthless potions have some use at very early stage.
352 # Command letter '(' means, 'Don't display its location in full map command.'
359 # complex example; destroy needless food items.
360 ?:[AND [GEQ $LEVEL 20] [IOR [EQU $REALM1 Life Nature Craft] [EQU $REALM2 Life Nature Craft]]]
368 # Destroy useless equipment at high level.
371 # The line '!nameless armors' destroy all dragon armour!
372 # '~identified armors:dragon' will prevent this dangerous behavior.
376 ~identified armors:dragon
377 ~nameless armors:Elven Cloak
378 ~nameless armors:Shadow Cloak
379 ~nameless weapons:Diamond Edge
380 ~nameless weapons:Mace of Disruption
381 ~nameless weapons:Shield of Deflection
386 !nameless weapons:) (+0,+0)
387 !nameless armors:,+0]
390 # higher rank of your spellbooks
391 first realm's fourth Book of Kendo#!k
392 first realm's third Book of Kendo#!k
393 first realm's fourth spellbooks#@md!k
394 first realm's third spellbooks#@mc!k
395 second realm's fourth spellbooks#@mh!k
396 second realm's third spellbooks#@mg!k
398 # unidentified equipment
399 unidentified dice boosted weapons
400 unidentified more than 25 dice weapons
403 ~unidentified missiles
405 # lower rank of your spellbooks
406 collecting spellbooks
407 ~first realm's second spellbooks#@mb!k
408 ~first realm's first spellbooks#@ma!k
409 ~second realm's second spellbooks#@mf!k
410 ~second realm's first spellbooks#@me!k
415 (!unreadable first spellbooks
416 (!unreadable second spellbooks
417 (!unreadable third spellbooks:arcane
418 (!unreadable fourth spellbooks:arcane
421 # pick up for experience
422 ?:[EQU $CLASS Warrior Berserker]
423 (~unreadable fourth spellbooks:arcane
424 unreadable fourth spellbooks
425 (~unreadable third spellbooks:arcane
426 unreadable third spellbooks
428 ?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Crusade] [GEQ $LEVEL 30]]
429 (~unreadable fourth spellbooks:life
430 (~unreadable third spellbooks:life
431 ?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Crusade]]
432 (~unreadable fourth spellbooks:arcane
433 unreadable fourth spellbooks
434 (~unreadable third spellbooks:arcane
435 unreadable third spellbooks
437 ?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Death]]
438 unreadable fourth spellbooks:life
439 unreadable fourth spellbooks:crusade
440 unreadable third spellbooks:life
441 unreadable third spellbooks:crusade
446 (~unreadable third spellbooks:arcane
447 (~unreadable fourth spellbooks:arcane
448 unreadable fourth spellbooks
449 unreadable third spellbooks