-=== Auto-Picker/Destroyer Editor ===
-
-The "auto-picker/destroyer editor" is a special text editor to write
-preferences for auto-picker/destroyer.
+[[[[G|=== Auto-Picker/Destroyer Editor ===
+
+Please choose one of the following online help files:
+
+ (a) The Basics of Auto-picker Editor (#Editor)
+ (b) Cur and Paste (#CutAndPaste)
+ (c) Register to Auto-picker (#RegisterName)
+ (d) Insert Name from your Inventory (#InsertObjectName)
+ (e) Insert Fixed Keyword (#InsertKeyword)
+ (f) Change Multiple Lines at Once (#MultiLines)
+ (g) Conditionals (#Conditionals)
+ (h) Auto Register an Item without Editor (#AutoRegister)
+
+ (i) Format of Auto-picker/destroyer (#AutopickFormat)
+ (j) Format of Conditionals (#ConditionFormat)
+ (k) Sample Preference File (lib/pref/pickpref.prf)
+
+***** [a] editor.txt#Editor
+***** [b] editor.txt#CutAndPaste
+***** [c] editor.txt#RegisterName
+***** [d] editor.txt#InsertObjectName
+***** [e] editor.txt#InsertKeyword
+***** [f] editor.txt#MultiLines
+***** [g] editor.txt#Conditionals
+***** [h] editor.txt#AutoRegister
+***** [i] editor.txt#AutopickFormat
+***** [j] editor.txt#ConditionFormat
+***** [k] ../pref/pickpref.prf
+
+***** <Editor>
+[[[[G|--- The Basics of Auto-picker Editor ---
+
+The "auto-picker editor" is a special text editor to write preferences
+for auto-picker/destroyer.
To open the editor, you can press the _ key in the game or choose
"(P) Auto-picker/destroyer editor" in the options panel (=).
-Press ^Q to quit the editor. All changes will be saved automatically.
+Like normal text editor, you can move the cursor by Left, Right, Up,
+Down arrow keys, and Home, End, PageUp, and PageDown keys. And any
+letter keys pressed are written as a text.
+
+Press ^W to finish the edito. All changes will be saved automatically.
+Or press ^Q to quit and discard all changes.
Press ESC to open a command menu.
-+----------------------------+
-| a) Save & Quit ^Q |
-| b) Revert all changes ^Z |
-| c) Help |
-| d) Move cursor > |
-| e) Edit > |
-| f) Search > |
-| g) Insert... > |
-| h) Command letter > |
-| i) Identify states > |
-| j) Keywords (noun) > |
-| k) Keywords (adjective) > |
-+----------------------------+
-Press a-k to choose a command or open a sub-menu. Also you can press
++---------------------------+
+| a) Help |
+| b) Quit without save ^Q |
+| c) Save & Quit ^W |
+| d) Revert all changes ^Z |
+| e) Edit > |
+| f) Search > |
+| g) Move cursor > |
+| h) Insert... > |
+| i) Adjective (general) > |
+| j) Adjective (special) > |
+| k) Keywords (noun) > |
+| l) Command letter > |
++---------------------------+
+Press a-l to choose a command or open a sub-menu. Also you can press
^Q, ^Z, etc. to use commands without opening this menu.
-***** <Autopick>
-==== Object Auto-picker/Destroyer ====
+***** <CutAndPaste>
+[[[[G|--- Cur and Paste
+
+Cut and Paste are useful when you want to write many similer lines, or
+want to swap lines.
+Open submenu "e) Edit >",
++-------------------------+
+| a) Cut ^X |
+| b) Copy ^C |
+| c) Paste ^V |
+| d) Select block ^G |
+| e) Kill rest of line ^K |
+| f) Delete character ^D |
+| g) Backspace ^H |
+| h) Return ^J |
+| i) Return ^M |
++-------------------------+
+
+You can select a segment of the text using shift key + arrow keys.
+Selected text will be displayed in yellow. You can press ^X to cut
+the selected text, or press ^C to copy the selected text to the
+clipboard. Contents of the clipboard will be pasted on pressing ^V.
+
+Note that it's possible that Hengband cannot recognize shift+arrow
+keys on a minor environment. In that case, you can press ^G and then
+move cursor to select text.
+
+
+***** <RegisterName>
+[[[[G|--- Register to Auto-picker ---
+
+***** <InsertObjectName>
+[[[[G|--- Insert Name from your Inventory ---
+
+***** <InsertKeyword>
+[[[[G|--- Insert Fixed Keyword ---
+
+***** <MultiLines>
+[[[[G|--- Change Multiple Lines at Once ---
+
+***** <Conditionals>
+[[[[G|--- Conditionals ---
+
+***** <AutoRegister>
+[[[[G|--- Auto Register an Item without Editor ---
+
+***** <AutopickFormat>
+[[[[G|--- Format of Auto-picker/destroyer ---
Hengband can automatically pick up or destroy specified objects when
you write objects name in the file "pickpref.prf" or
worthless : Items which you cannot sell match.
artifact : Artifacts 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.
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.
favorite weapons : Weapons suitable for your class (for Priest, Monk,
BeastMaster, ForceTrainer, Cavalry, and Ninja)
[! ~ ; (]
[[all] [collecting]
[unaware] [unidentified] [identified] [*identified*]
+ [artifact] [ego] [good] [nameless] [average]
+ [worthless] [rare] [common]
[dice boosted] [more than N dice] [more bonus than N]
- [worthless] [artifact] [ego] [nameless]
[wanted] [unique monster's] [human] [unreadable]
[first realm's] [second realm's] [first] [second] [third] [fourth]
- [items | 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]
-======= How to use Conditional Expressions ========
+***** <ConditionFormat>
+[[[[G|--- Format of Conditionals ---
The lines of pickpref.prf can be disabled/enabled using
conditional expressions.
%: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.
$LEVEL
Returns player level as two-character string.
Ex. "01","09","10","50" etc.
-
-###############################################################
-###############################################################
----------------------------------------------------------------
-
- There is an example 'pickpref.prf' file below.
- You can copy this file to lib\user\ or ~/.angband/Hengband/.
- (UNIX user must copy to ~/.angband/Hengband/. Others must copy
- to lib\user\ .)
-
----------------------------------------------------------------
-###############################################################
-###############################################################
-
-wanted corpse
-wanted Skeleton
-
-# Berserker cannot use magical devices; rods, wands, and scrolls.
-?:[EQU $CLASS Berserker]
-!magical devices
-?:1
-
-unaware items
-
-#Artifact lights
-unidentified lights:^Jewel#!!
-unidentified lights:^levitation stone#!!
-unidentified lights:^Palantir#!!
-unidentified lights:^stone#@A0
-unidentified lights:^star#!!
-unidentified lights:^Incandescent Light
-unidentified lights:^Phial#!!
-
-# auto inscribe resistances (see lib/help/objects.txt#Inscriptions)
-~*identified* artifacts#%all
-
-#
-# pick all items which can stack your inventory without inscription.
-#
-collecting rod
-collecting potion
-collecting scroll
-collecting missiles
-(collecting items
-
-#
-# good items
-#
-~rod of Perception#@z0!k!!
-~rod of speed#!k!!
-~rod of Healing#!k!!
-~rod of Enlightenment#k!!
-~rod of Detection#!k!!
-
-potion of Invulnerability#!k
-Acquirement#!k
-potion of Experience
-potion of Augmentation
-*Destruction*
-Genocide
-
-potion of strength
-potion of wisdom
-potion of dexterity
-potion of constitution
-potion of intelligence
-potion of Charisma
-
-potion of life#!k
-healing#!k
-
-#
-# Magic-Eaters pick up all magical device to absorb.
-# Skeletons is material of missiles for Archers.
-# Ninja needs lights of darkness.
-# Vampire needs darkness.
-#
-?:[EQU $CLASS Magic-Eater]
-rod of
-staff of
-wand of
-?:[EQU $CLASS Archer]
-skeleton of
-?:[EQU $CLASS Ninja]
-~lights:darkness
-Iron Spike#@v0
-?:[EQU $RACE Vampire]
-(~scroll of darkness
-(~staff of darkness
-?:1
-
-# Destroy unless very early stage.
-?:[GEQ $LEVEL 10]
-(!amulet of Adornment
-(!potion of Apple Juice
-(!Empty Bottle
-(!potion of water
-?:1
-
-# These worthless potions have some use at very early stage.
-# Command letter '(' means, 'Don't display its location in full map command.'
-?:[LEQ $LEVEL 20]
-(~potion of booze
-(~potion of Slowness
-(~potion of Sleep
-?: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
-(!food
-(!Slime Mold
-(!of Elvish Waybread
-?:1
-
-
-#
-# Destroy useless equipment at high level.
-#
-# Beware!!!!
-# The line '!nameless armors' destroy all dragon armour!
-# '~identified armors:dragon' will prevent this dangerous behavior.
-#
-
-?:[GEQ $LEVEL 40]
-~identified armors:dragon
-~nameless armors:Elven Cloak
-~nameless armors:Shadow Cloak
-~nameless weapons:Diamond Edge
-~nameless weapons:Mace of Disruption
-~nameless weapons:Shield of Deflection
-!nameless weapons
-!nameless armors
-
-?:[GEQ $LEVEL 20]
-!nameless weapons:) (+0,+0)
-!nameless armors:,+0]
-?:1
-
-# higher rank of your spellbooks
-first realm's fourth Book of Kendo#!k
-first realm's third Book of Kendo#!k
-first realm's fourth spellbooks#@md!k
-first realm's third spellbooks#@mc!k
-second realm's fourth spellbooks#@mh!k
-second realm's third spellbooks#@mg!k
-
-# unidentified equipment
-unidentified dice boosted weapons
-unidentified more than 25 dice weapons
-unidentified weapons
-unidentified armors
-~unidentified missiles
-
-# lower rank of your spellbooks
-collecting spellbooks
-~first realm's second spellbooks#@mb!k
-~first realm's first spellbooks#@ma!k
-~second realm's second spellbooks#@mf!k
-~second realm's first spellbooks#@me!k
-
-# other spellbooks
-
-?:[GEQ $LEVEL 30]
-(!unreadable first spellbooks
-(!unreadable second spellbooks
-(!unreadable third spellbooks:arcane
-(!unreadable fourth spellbooks:arcane
-?:1
-
-# pick up for experience
-?:[IOR [EQU $CLASS Warrior] [EQU $CLASS Berserker] [AND [EQU $CLASS Paladin] [EQU $REALM1 Life]]]
-(~unreadable third spellbooks:arcane
-(~unreadable fourth spellbooks:arcane
-unreadable fourth spellbooks
-unreadable third spellbooks
-?:1
-?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Death]]
-unreadable fourth spellbooks:life
-unreadable third spellbooks:life
-?:1
-
-# pick up for money
-?:[LEQ $LEVEL 29]
-(~unreadable third spellbooks:arcane
-(~unreadable fourth spellbooks:arcane
-unreadable fourth spellbooks
-unreadable third spellbooks
-?:1
-