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 # Create a file named "pickpref.prf" or "pickpref-<<name>>.prf"
12 # (or move and rename this file) in the same directory as your
13 # user preference files. This will be ~/.angband/Hengband/
14 # for UNIX, or hengband/lib/user/ for other operating systems.
16 # The game will read the file "pickpref-<<current character
17 # name>>.prf" first and then read the file "pickpref.prf". The
18 # first-read file takes priority.
20 # You may use the '$' command within the game to reread auto-
24 # Maximum number of active lines is 1009.
25 # A line with a header '#' is a comment.
32 # Each line determines the actions taken when you step over a kind
33 # of object. Starting a line with '!' indicates that you wish to destroy
34 # this kind of object. Starting a line with '~' indicates that you wish
35 # to leave this kind of object on the floor. Otherwise, your character
36 # will automatically attempt to pick up the object.
37 # There is an additional command letter '('. It indicates that
38 # you don't wish this item to be displayed in full map. see below.
41 # If you want to disable the effect of the '!' indicator temporally,
42 # use 'always_pickup' option.
46 # After the command letter may come one or more keywords. They are:
48 # all : All items match.
49 # collecting : Matches if you already have that same item.
50 # unidentified : Unidentified items match.
51 # identified : Identified items match.
52 # *identified* : *Identified* items match.
53 # nameless : Non ego/non artifact items match.
54 # unaware : Items with unknown effects match.
55 # worthless : Items which you cannot sell match.
56 # dice boosted : Weapons with boosted damage dice match.
57 # more than nn dice : Weapons with dice (dd * ds) better than nn match.
58 # wanted : Wanted monster's corpses or skeletons match.
59 # unique monster's : Unique monster's corpses, skeletons or statues match.
60 # human : Human corpses or skeletons match.
61 # unreadable : Spellbooks other than those you can read match.
62 # first realm's : Your first magic realm's spellbooks match.
63 # second realm's : Your second magic realm's spellbooks match.
64 # first : First one of four spellbooks in each realm match.
65 # second : Second one of four spellbooks in each realm match.
66 # third : Third one of four spellbooks in each realm match.
67 # fourth : Fourth one of four spellbooks in each realm match.
69 # items : All items match. Use it with an adjective for
70 # readability (i.e. "unaware items").
71 # artifacts : All artifacts match.
72 # weapons : All weapons including missile weapons match.
73 # armors : All armors match.
74 # missiles : Arrows, bolts, and shots match.
75 # magical devices : Wands, staffs and rods match.
76 # lights : Light sources match.
77 # junks : Junk items like Shard of Pottery or etc. match.
78 # spellbooks : All books match.
79 # hafted weapons : Hafted weapons match. For priests.
81 # You may also use keywords which match specified kinds of equipment:
82 # weapons, armors, missiles, magical devices, lights, junks, spellbooks,
83 # hafted weapons, shields, bows, rings, amulets, suits, cloaks, helms,
88 # After the keywords, you may write a character string. Only items
89 # whose name contains this character string as part of their name match.
90 # Upper or lower case makes no difference.
91 # You must insert a ':' between your special keywords and character
92 # string, if both exist in one line.
94 # Force start-of-line matching:
95 # If the first character in a character string is '^', then the
96 # character string must match the beginning of a line.
98 # !Mace // Destroy Maces and Lead-Filled Maces.
99 # !^Mace // Destroy only Maces.
105 # Meaning: "destroy all items that are worthless"
108 # Meaning: "pick up all unaware potions"
110 # ~unidentified lites
111 # Meaning: "leave all unidentified light sources on the ground"
113 # unidentified more than 25 dice weapons
114 # Meaning: "pick up all weapons with dice that total more than 25. A
115 # weapon that is 2d13 qualifies, a weapon that is 5d5 does not."
118 # Meaning: "pick up anything that includes in its name the word
121 # potion of Experience
122 # Meaning: "pick up anything named 'potion of experience'"
125 # Meaning: "Pick up light sources named stone"
128 # Meaning: "Pick up gauntlets of slaying. Not rings of slaying."
133 # Lines will be evaluated in order, and first matched line will be
134 # applied. So you can write names of specific excellent items to pick
135 # up, followed by a general item name with '!' to destroy useless items.
138 # ! In full map command ('M'), you can press M, N, K, or D to
139 # ! display locations of items for auto-pickup, leaving, auto-destroy
140 # ! or both auto-pickup and leaving.
141 # ! Additional command letter '(' prevents this display.
144 # If you begin the last string in a line with '#', this string will
145 # be automatically inscribed on the item.
148 # Strict syntax of each line is below.
150 # [[all] [collecting] [unidentified] [identified] [*identified*]
151 # [nameless] [unaware] [worthless] [dice boosted] [more than nn dice]
152 # [wanted] [unique monster's] [human] [unreadable]
153 # [first realm's] [second realm's] [first] [second] [third] [fourth]
154 # [items | artifacts | weapons | armors | missiles | magical devices |
155 # lights | junks | spellbooks | hafted weapons | shields | bows |
156 # rings | amulets | suits | cloaks | helms | gloves | boots] :]
157 # [[^]part-of-item-name] [#auto-inscription-string]
160 # ======= How to use Conditional Expressions ========
162 # The lines of pickpref.prf can be disabled/enabled using
163 # conditional expressions.
164 # The syntax is the same as that of other preference files.
166 # - usage of condition expressions
168 # If result of expr is "0", all lines below are disabled.
169 # If result of expr is "1", all lines below are enabled.
170 # Caution:It cannot be nested.
172 # - usage to include other file
174 # Read a file named 'filename' as a new pick-pref file. The file
175 # must be in the user directory.
176 # Caution: Avoid naming the parent file, or the game might freeze up.
178 # - usage of operators
179 # [EQU arg1 arg2 ...]
180 # If all args are same, returns "1", or else returns "0".
181 # [IOR arg1 arg2 ...]
182 # [AND arg1 arg2 ...]
183 # IOR evaluates and returns all args' logical OR. IAND is logical AND.
185 # Returns "0" if arg is "1", or else returns "1"
186 # [LEQ arg1 arg2 ...]
187 # [GEQ arg1 arg2 ...]
188 # Compare args as string. LEQ returns "1" if (arg1 <= arg2 <= ...) ,
189 # GEQ returns "1" if (arg1 >= arg2 >= ...) otherwise returns "0".
191 # - Special variables
193 # Returns name of player race. One of below:
194 # Human, Half-Elf, Elf, Hobbit, Gnome, Dwarf, Half-Orc, Half-Troll,
195 # Amberite, High-Elf, Barbarian, Half-Ogre, Half-Giant, Half-Titan,
196 # Cyclops, Yeek, Klackon, Kobold, Nibelung, Dark-Elf, Draconian,
197 # Mindflayer, Imp, Golem, Skeleton, Zombie, Vampire, Spectre, Sprite,
198 # Beastman, Ent, Archon, Balrog, Dunadan, Shadow-Fairy, Kutar, Android,
201 # Returns name of player class. One of below:
202 # Warrior, Mage, Priest, Rogue, Ranger, Paladin, Warrior-Mage,
203 # Chaos-Warrior, Monk, Mindcrafter, High-Mage, Tourist, Imitator,
204 # BeastMaster, Sorcerer, Archer, Magic-Eater, Bard, Red-Mage, Samurai,
205 # ForceTrainer, Blue-Mage, Cavalry, Berserker, Weaponsmith,
206 # Mirror-Master, Ninja
209 # Returns player name.
211 # Returns player's first magic realm
212 # Life, Sorcery, Nature, Chaos, Death, Trump
213 # Arcane, Craft, Daemon, Music, Kendo
215 # Returns player's second magic realm
217 # Returns player level as two-character string.
218 # Ex. "01","09","10","50" etc.
220 #------------------------------------------------------------------
222 # Below is an example 'pickpref.prf' file.
223 # You can copy this file to lib/user/ or ~/.angband/Hengband/.
224 # (UNIX user must copy to ~/.angband/Hengband/. Others must copy
227 #------------------------------------------------------------------
232 # Berserker cannot use magical devices; rods, wands, and scrolls.
233 ?:[EQU $CLASS Berserker]
240 unidentified lights:^Jewel#!!
241 unidentified lights:^levitatioin stone#!!
242 unidentified lights:^Palantir#!!
243 unidentified lights:^stone#@A0
244 unidentified lights:^star#!!
245 unidentified lights:^Incandescent Light
246 unidentified lights:^Phial#!!
248 # auto inscribe resistances...
249 ~*identified* artifacts#%
252 # pick all items which can stack your inventry without inscription.
263 ~rod of Perception#@z0!k!!
266 ~rod of Enlightenment#k!!
267 ~rod of Detection#!k!!
269 potion of Invulnerability#!k
272 potion of Augmentation
279 potion of constitution
280 potion of intelligence
287 # Magic-Eaters pick up all magical device to absorb.
288 # Skeletons is material of missiles for Archers.
289 # Ninja needs lights of darkness.
290 # Vampire needs darkness.
292 ?:[EQU $CLASS Magic-Eater]
296 ?:[EQU $CLASS Archer]
301 ?:[EQU $RACE Vampire]
306 # Destroy unless very early stage.
308 (!amulet of Adornment
309 (!potion of Apple Juice
314 # These worthless potions have some use at very early stage.
315 # Command letter '(' means, 'Don't display its location in full map command.'
322 # complex example; destroy needless food items.
323 ?:[AND [GEQ $LEVEL 20] [IOR [EQU $REALM1 Life] [EQU $REALM2 Life] [EQU $REALM1 Nature] [EQU $REALM2 Nature] [EQU $REALM1 Craft] [EQU $REALM2 Craft]]]
332 # Destroy useless equipment at high level.
335 # The line '!nameless armors' destroy all dragon armour!
336 # '~identified armors:dragon' will prevent this dangerous behavior.
340 ~identified armors:dragon
341 ~nameless armors:Elven Cloak
342 ~nameless armors:Shadow Cloak
343 ~nameless weapons:Diamond Edge
344 ~nameless weapons:Mace of Disruption
345 ~nameless weapons:Shield of Deflection
350 !nameless weapons:) (+0,+0)
351 !nameless armors:,+0]
354 # higher rank of your spellbooks
355 first realm's fourth Book of Kendo#!k
356 first realm's third Book of Kendo#!k
357 first realm's fourth spellbooks#@md!k
358 first realm's third spellbooks#@mc!k
359 second realm's fourth spellbooks#@mh!k
360 second realm's third spellbooks#@mg!k
362 # unidentified equipment
363 unidentified dice boosted weapons
364 unidentified more than 25 dice weapons
367 ~unidentified missiles
369 # lower rank of your spellbooks
370 collecting spellbooks
371 ~first realm's second spellbooks#@mb!k
372 ~first realm's first spellbooks#@ma!k
373 ~second realm's second spellbooks#@mf!k
374 ~second realm's first spellbooks#@me!k
379 (!unreadable first spellbooks
380 (!unreadable second spellbooks
381 (!unreadable third spellbooks:arcane
382 (!unreadable fourth spellbooks:arcane
385 # pick up for experience
386 ?:[IOR [EQU $CLASS Warrior] [EQU $CLASS Berserker] [AND [EQU $CLASS Paladin] [EQU $REALM1 Life]]]
387 (~unreadable third spellbooks:arcane
388 (~unreadable fourth spellbooks:arcane
389 unreadable fourth spellbooks
390 unreadable third spellbooks
392 ?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Death]]
393 unreadable fourth spellbooks:life
394 unreadable third spellbooks:life
399 (~unreadable third spellbooks:arcane
400 (~unreadable fourth spellbooks:arcane
401 unreadable fourth spellbooks
402 unreadable third spellbooks