#
# ===== How to use auto-picker/destroyer ========
#
-# Create a file named "pickpref.prf" or "pickpref-<<name>>.prf"
-# (or move and rename this file) in the same directory as your
-# user preference files. This will be ~/.angband/Hengband/
-# for UNIX, or hengband\lib\user\ for other operating systems.
-#
-# The game will read the file "pickpref-<<current character
-# name>>.prf" first and then read the file "pickpref.prf". The
-# first-read file takes priority.
-#
-# You may use the '$' command within the game to reread auto-
-# picker files.
+# Press the _ in a game to enter editor mode for preference of
+# auto-picker/destroyer. Basic usage of the editor is almost same
+# as vi, and also have emacs like commands. Most commands is
+# always displayed on the first line and the right half of the
+# screen.
+#
+# Important commands
+# 'a', 'i' or ^Q : Enter insert mode from command mode
+# ESC or ^Q : Return to command mode from insert mode
+# 'q' : Quit the editor (command mode only)
+# 'hjkl2468' : Move cursor (command mode only)
+# ^B ^N ^P ^F : Move cursor (always)
+# ^I : Choose an item from inventry/equipment, then insert its name
+# ^S : Rotates action (pick up / destroy / leave on floor)
+# ^U : Rotates identify state (identified / unidentified / ...)
+# ^L : Insert name of the last auto-destroyed item.
+# '/' : Search string, or search an item specified by ^I or ^L.
+# 'n' : Search next
+# 'N' : Search previous
+#
+# The preference will be saved in a file named
+# "pickpref-<<name>>.prf" in your user directory; This will be
+# ~/.angband/Hengband/ for UNIX, or hengband\lib\user\ for other
+# operating systems. You may edit this file using any text
+# editor, and may use the '$' command within the game to reread
+# this file. When you don't use the in-game editor, you may use
+# "pickpref.prf" as preference file.
+#
+# When there are both files, the game will read the file
+# "pickpref-<<current character name>>.prf" first and then read
+# the file "pickpref.prf". The first-read file takes priority.
#
# Notes:
# Maximum number of active lines is 1009.
# ---------
#
# Command letter:
-# Each line determines the actions taken when you step over a kind
-# of object. Starting a line with '!' indicates that you wish to destroy
-# this kind of object. Starting a line with '~' indicates that you wish
-# to leave this kind of object on the floor. Otherwise, your character
-# will automatically attempt to pick up the object.
+# Each line determines the actions taken when you step over
+# a kind of object. Starting a line with '!' indicates that you
+# wish to destroy this kind of object. Starting a line with '~'
+# indicates that you wish to leave this kind of object on the
+# floor. Starting a line with ';' indicates that you wish to
+# force the game to ask you if you want to pick the item up or
+# not. Otherwise, your character will automatically attempt to
+# pick up the object.
# There is an additional command letter '('. It indicates that
# you don't wish this item to be displayed in full map. see below.
#
#
# all : All items match.
# collecting : Matches if you already have that same item.
+# unaware : Items with unknown effects match.
# unidentified : Unidentified items match.
# identified : Identified items match.
# *identified* : *Identified* items match.
-# nameless : Non ego/non artifact items match.
-# unaware : Items with unknown effects match.
-# worthless : Items which you cannot sell match.
# dice boosted : Weapons with boosted damage dice match.
-# more than nn dice : Weapons with dice (dd * ds) better than nn match.
+# more than N dice : Weapons with dice (dd * ds) better than +N match.
+# more bonus than N : Items which has more magical bonus than (+N) match.
+# worthless : Items which you cannot sell match.
+# artifacts : Artifact items match.
+# ego : Ego items match.
+# good : {good} items match.
+# nameless : Non ego/non artifact items match.
+# average : {average} items match.
+# rare : Rare equipment such as Dragon armors etc. match.
+# common : Any equipments except 'rare' equipment match.
# wanted : Wanted monster's corpses or skeletons match.
# unique monster's : Unique monster's corpses, skeletons or statues match.
# human : Human corpses or skeletons match.
#
# items : All items match. Use it with an adjective for
# readability (i.e. "unaware items").
-# artifacts : All artifacts match.
# weapons : All weapons including missile weapons match.
# armors : All armors match.
# missiles : Arrows, bolts, and shots match.
-# magical devices : Wands, staffs and rods match.
+# magical devices : Wands, staffs, rods and scrolls match.
# lights : Light sources match.
# junks : Junk items like Shard of Pottery or etc. match.
+# corpses or skeletons : Corpses or skeletons of monsters match.
# spellbooks : All books match.
-# hafted weapons : Hafted weapons match. For priests.
+# favorite weapons : Weapons suitable for your class (for Priest, Monk,
+# BeastMaster, ForceTrainer, Cavalry, and Ninja)
#
# You may also use keywords which match specified kinds of equipment:
# weapons, armors, missiles, magical devices, lights, junks, spellbooks,
#
# Strict syntax of each line is below.
#
-# [[all] [collecting] [unidentified] [identified] [*identified*]
-# [nameless] [unaware] [worthless] [dice boosted] [more than nn dice]
+# [! ~ ; (]
+# [[all] [collecting]
+# [unaware] [unidentified] [identified] [*identified*]
+# [artifact] [ego] [good] [nameless] [average]
+# [worthless] [rare] [common]
+# [dice boosted] [more than N dice] [more bonus than N]
# [wanted] [unique monster's] [human] [unreadable]
# [first realm's] [second realm's] [first] [second] [third] [fourth]
-# [items | artifacts | weapons | armors | missiles | magical devices |
-# lights | junks | spellbooks | hafted weapons | shields | bows |
-# rings | amulets | suits | cloaks | helms | gloves | boots] :]
+# [items | weapons | favorite weapons | armors | missiles |
+# magical devices | lights | junks | corpses or skeletons | spellbooks |
+# hafted weapons | shields | bows | rings | amulets | suits | cloaks |
+# helms | gloves | boots] :]
# [[^]part-of-item-name] [#auto-inscription-string]
#
#
# %:filename
# Read a file named 'filename' as a new pick-pref file. The file
# must be in the user directory.
-# Caution: Avoid naming the parent file, or the game might freeze up.
#
# - usage of operators
# [EQU arg1 arg2 ...]
-# If all args are same, returns "1", or else returns "0".
+# If all args are the same as arg1, returns "1", or else returns "0".
# [IOR arg1 arg2 ...]
# [AND arg1 arg2 ...]
-# IOR evaluates and returns all args' logical OR. IAND is logical AND.
+# IOR evaluates and returns all args' logical OR. AND is logical AND.
# [NOT arg]
# Returns "0" if arg is "1", or else returns "1"
# [LEQ arg1 arg2 ...]
# Tourist, Imitator, BeastMaster, Sorcerer, Archer,
# Magic-Eater, Bard, Red-Mage, Samurai, ForceTrainer,
# Blue-Mage, Cavalry, Berserker, Weaponsmith, Mirror-Master,
-# Ninja
+# Ninja, Sniper
#
# $PLAYER
# Returns player name.
# $REALM1
# Returns player's first magic realm
-# none, Life, Sorcery, Nature, Chaos, Death, Trump Arcane,
-# Craft, Daemon, Music, Kendo
+# none, Life, Sorcery, Nature, Chaos, Death, Trump, Arcane,
+# Craft, Daemon, Crusade, Music, Kendo, Hex
# $REALM2
# Returns player's second magic realm
# $LEVEL
# Returns player level as two-character string.
# Ex. "01","09","10","50" etc.
+# $MONEY
+# Returns player money as 9 character string.
+# Ex. "000012345" etc.
#
#------------------------------------------------------------------
#
#Artifact lights
unidentified lights:^Jewel#!!
-unidentified lights:^levitatioin stone#!!
+unidentified lights:^levitation stone#!!
unidentified lights:^Palantir#!!
unidentified lights:^stone#@A0
unidentified lights:^star#!!
unidentified lights:^Incandescent Light
unidentified lights:^Phial#!!
-# auto inscribe resistances...
-~*identified* artifacts#%
+# auto inscribe resistances (see lib/help/objects.txt#Inscriptions)
+~*identified* artifacts#%all
#
-# pick all items which can stack your inventry without inscription.
+# pick all items which can stack your inventory without inscription.
#
collecting rod
collecting potion
staff of
wand of
?:[EQU $CLASS Archer]
-skeleton of
+worthless skeleton
?:[EQU $CLASS Ninja]
~lights:darkness
Iron Spike#@v0
?:1
# complex example; destroy needless food items.
-?:[AND [GEQ $LEVEL 20] [IOR [EQU $REALM1 Life] [EQU $REALM2 Life] [EQU $REALM1 Nature] [EQU $REALM2 Nature] [EQU $REALM1 Craft] [EQU $REALM2 Craft]]]
-(!Satisfy Hunger
+?:[AND [GEQ $LEVEL 20] [IOR [EQU $REALM1 Life Nature Craft] [EQU $REALM2 Life Nature Craft]]]
(!food
(!Slime Mold
(!of Elvish Waybread
?:1
# pick up for experience
-?:[IOR [EQU $CLASS Warrior] [EQU $CLASS Berserker] [AND [EQU $CLASS Paladin] [EQU $REALM1 Life]]]
+?:[EQU $CLASS Warrior Berserker]
+(~unreadable fourth spellbooks:arcane
+unreadable fourth spellbooks
(~unreadable third spellbooks:arcane
+unreadable third spellbooks
+?:1
+?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Crusade] [GEQ $LEVEL 30]]
+(~unreadable fourth spellbooks:life
+(~unreadable third spellbooks:life
+?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Crusade]]
(~unreadable fourth spellbooks:arcane
unreadable fourth spellbooks
+(~unreadable third spellbooks:arcane
unreadable third spellbooks
?:1
?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Death]]
unreadable fourth spellbooks:life
+unreadable fourth spellbooks:crusade
unreadable third spellbooks:life
+unreadable third spellbooks:crusade
?:1
# pick up for money