For regular visible items lying around in maps, see Item balls.

This page describes how the Itemfinder item works in Essentials.

The Itemfinder

The Itemfinder, also known as the Dowsing Machine, is a Key Item that can be used to find hidden items in maps. It has a range of 7 tiles in the east/west directions and 5 tiles in the north/south directions, which covers all the whole tiles visible on-screen at the default screen size (it doesn't cover the half-tiles visible at the edges of the screen).

When the Itemfinder detects a hidden item, it will turn the player to face towards it. If the player is standing on it, the player will spin around instead.

Hidden items

A hidden item is an event with a name of "HiddenItem". This name is case-sensitive and cannot have anything else in it. You can name an event "HiddenItem:POTION" (or some other item name), and the hidden item's event will be properly generated and renamed by the Compiler. In addition, the event's Self Switch A must be OFF for it to be detectable, because turning this ON is used to indicate that the item has already been picked up.

While the event can technically do anything (the only requirement is that it has a specific name), events detectable by the Itemfinder are item balls.

Itemfinder's code

The code for the Itemfinder's effect is in an ItemHandlers proc in the script section PItem_ItemEffects. It makes use of def pbClosestHiddenItem which is in the script section PItem_Items.


Community content is available under CC-BY-SA unless otherwise noted.