View source for IgnoreItem

{{command header|client}}
{{body|ignoreItem <nowiki>{{</nowiki>id} <nowiki>|</nowiki> {id-list} <nowiki>|</nowiki> {type} <nowiki>|</nowiki> {type-list} <nowiki>|</nowiki> {"reset"<nowiki>}}</nowiki> [list]|:The ignoreItem command removes specific items from the list of items searched by [[findItem]]. If the option ''reset'' is given, all previously ignored items will be removed from the ignore list.
:There are different lists of ignored items. If no list number is given, it is the global list. The idea behind this, is the ability to reset one list, while still keeping some other items ignored.
:If an items id is added to any list, it will not be returned from subsequent calls to findItem. If reset is given with a list number, only the specific list is cleared.
:Using ignoreitem on an item that is already ignored will un-ignore it, ie: it will remove it from the ignore list thereby making it visible to [[findItem]] again.
:Multiple items can be ignored at one time if the list of items is separated with underscores "_".}}


=== Example ===
<pre>
; IgnoreItem.txt
;
; This script will demonstrate how ignoreItem can be used.
;
; Press start, go to a shop and follow the instructions.

msg #SMC Use a dagger and target an NPC$
wait 3s
msg #SMC (Press play to continue)
pause

set %npc1 #lTargetID

msg #SMC Use a dagger and target another NPC$
wait 3s
msg #SMC (Press play to continue)
pause

set %npc2 #lTargetID

ignoreItem %npc1 1
ignoreItem %npc2 2

; Nothing will be found
findItem %npc1
msg #SMC 1: #findID $
findItem %npc2
msg #SMC 2: #findID $

ignoreItem reset 1

; NPC 1 will be found
findItem %npc1
msg #SMC 1: #findID $
findItem %npc2
msg #SMC 2: #findID $

ignoreItem %npc1 1
ignoreItem reset 2

; NPC 2 will be found
findItem %npc1
msg #SMC 1: #findID $
findItem %npc2
msg #SMC 2: #findID $
halt
</pre>

== Related Commands ==
{| style="background:gainsboro; color:black; border: 2px #aaa solid;"
| width=250px align=center | [[ignoreItem]]               || width=250px align=center | [[findItem]]                   || width=250px align=center | [[findCnt|&#0035;findCnt]]
|-
| width=250px align=center | [[findID|&#0035;findID]]     || width=250px align=center | [[findType|&#0035;findType]]   || width=250px align=center | [[findX|&#0035;findX]]
|-
| width=250px align=center | [[findY|&#0035;findY]]       || width=250px align=center | [[findZ|&#0035;findZ]]         || width=250px align=center | [[findDist|&#0035;findDist]] 
|-
| width=250px align=center | [[findKind|&#0035;findKind]] || width=250px align=center | [[findStack|&#0035;findStack]] || width=250px align=center | [[findBagID|&#0035;findBagID]] 
|-
| width=250px align=center | [[findMod|&#0035;findMod]]   || width=250px align=center | [[findRep|&#0035;findRep]]     || width=250px align=center | [[findCol|&#0035;findCol]] 
|-
| width=250px align=center | [[findIndex|&#0035;findIndex]]
|}
=See Also=
{{Client}}