Tools and Actions

The Tool item describes a tool for user interactions with a mouse click. An Action item may be associated with a region or object to define the action caused by a mouse click depending on the current tool and the selected object.

Tool

Item type	Tool
Description	A tool for mouse interactions.
Action	makes the tool the selected tool (scene / inventory only); the tool must not be one of the in the toolbar as defined in Game
Condition	true, if the tool is the selected tool (scene / inventory only)

Key	Type	Default	Description
description	string		A short description of the tool.
cursor	file		The file name of the cursor of the tool.
action	Actions	<>	The default action.
move	byte	0	The behaviour of the player character for the tool. see definitions for values
object	byte	0	The usage of the object cursor for the tool. see definitions for values

Instead of a file name, cursor may be one of the following predefined images: go, look, examine, take, drop, move, open, use, usewith, combine, select, fight, talk, wait, wear (cf. tool example). Alternatively, cursors may be contained in a resource library.

Action

Item type	Action
Description	Associates an action with a tool and a selected object.
Action	-
Condition	-

Key	Type	Default	Description
tool	Tools		The tool, that has to be the selected tool.
action	Actions		The action, that will be executed.
object	Objects	<>	The object, that has to be the selected object. (optional)

Action Selection

When the player clicks on a region or object, the action to execute is the first existing in the following order:

1. the action defined for the region / object for the current tool and selected object
2. the action defined for the region / object for the current tool independent from the selected object
3. the default action of the tool

If step 1 or 2 has an Action item without an action (i.e. <> as action), no further action is searched. By this, a default action may be overwritten by no action.