# Event Square Wizard

Event Squares can be used for a variety of purposes, such as displaying story information, npc interaction (conversations, trading, recruiting), quests, and more. Events have some initial properties, along with a list of Choices.

Direction Party Must Face To Trigger

- Determines what direction the party must be facing in order for the event to be triggered. Events with a direction specified are triggered either when first stepping onto the square (if already facing the correct direction), or when turning in place on the square results in the party facing the correct direction. Events without a restriction on direction are only triggered when first stepped on, and not when turning.

Initial Picture

- Optionally, a filename of a picture (gif, png, or jpg) to display initially (when first triggered) for the event.
- Vertical alignment can be chosen from the drop-down list. (The picture will always be centered horizontally.) Note that the picture will be displayed beneath any Choice buttons (described later).
- Black Background, if selected, will fill the display with solid black before drawing the picture and text. If unselected, the dungeon view will be used as a background.

Initial Sound

- Optionally, a filename of a sound to play (wav format) when the event is first triggered.
- If the Loop button is selected, the sound will loop continuously (with no delay between plays) until the event ends. This is useful for ambient sounds or music.

Initial Message

- Optionally (but likely), an event can display a text message. Be careful not to use too many words on a single line, as the text may not fit.

Choice List

- The list displays all the currently defined Choices for this event, along with an indication of how many Actions each has.
- Use the Add/Edit Choice button to create new choices or modify the existing selected one. Use Delete Choice to remove a choice from the event. Use the Move Choice Up/Down buttons to change the order of the choices in the events (which only affects the placement of the buttons -- top to bottom corresponds to top-left to bottom-right in the event window during the game).

Text Color and Alignment

- The intial color and vertical alignment of text messages can be set. Click the Set Text Color to bring up a color chooser dialog.
- This color and alignment affects all subsequent text (created with Choices), unless/until it is changed by a Choice.

## Choices

Choices are used to provide interaction with the event. They are displayed as buttons in the game (if they are visible and are not set to Auto-Trigger). Each Choice is made up of a collection of Actions (described later below).

Choice Name

- The choice name is displayed on the button that represents the choice (if there is one).

Choice Visible

- If selected, the button will be displayed and can be used. Make sure you have at least one choice visible (typically at least a choice that ends the event), or the player will be stuck in the event (though this could be used to create an ending, either victory or defeat).
- The visiblity of one choice can be affected by the execution of another (see Set Choice Visible and Set Choice Invisible Actions below).

Auto-Trigger

- If selected, the Choice will be automatically executed when the event is triggered (if all necessary requirements are met - see below).
- Note that a Choice that has Auto-Trigger selected is not usually displayed as a button, unless its requirements are met after the event has started or it is set visible by another Choice.

Actions List

- The list displays all the currently defined Actions for this Choice, along with some indication of what the Action does.
- Use the Add/Edit Action button to create new actions or modify the existing selected one. Use Delete Action to remove an action from the Choice. Use the Move Action Up/Down buttons to change the order of the actions in the Choice. Order is only important when the Choice has an End Event, End Choice, or Question Action (see below).

The rest of the fields determine when a Choice button should be displayed (or when an Auto-Trigger Choice should trigger). All specified requirements must be met.

Item Required

- If selected, the Choice requires that the party have an item of the specified type in their possession. (Deselect, then select again to change the item.)
- Currently, the item must either be in the "player" hand or in any champion's left or right hand.
- Item Taken, if selected, will cause the item to be taken from the party if the choice is used. The item can never be recovered (though this can sort of be circumvented if the choice sets visible another choice that grants a new instance of the item. This trick could be used to "recharge" magic items, for example).

Skill Required

- Can be used to require that some champion in the party have at least the specified level, stat, or average level or stat.
- Currently, any one champion in the party is sufficient to satisfy the requirement.
- Only living champions are considered.

Requires Monsters Dead or Alive

- Can be used to require that all monsters of the selected type on the selected level are dead (if Need Them Dead is selected) or at least one is alive (if Need Them Dead is not selected).
- Useful for "Kill the Monster" type quests.
- The requirement searches the entire specified level for the monster type. Any previously defined custom monsters can also be used (tip: if, for example, you want only certain mummies on the specified level to count, simply make them custom mummies).
- It is probably a good idea not to allow these monsters to go up or down stairs, fall into pits, or be teleported to other levels, as this only searches the specified dungeon level!

## Actions

Actions are used to build Choices. It is the Actions that actually do something to the dungeon or party. Actions can be reusable or not depending on the specified value of the Number of Reuses field: use -1 for unlimited uses of the action, or specify a specific number of reuses. Note that these are REuses, i.e., uses beyond the first.

### The following Actions are available:

End Event

- Causes the event to end and the view to return to the dungeon.
- Note that actions following this one will not be executed!

Toggle, Activate, or Deactivate

- Exactly like a Wall Switch or Floor Switch.
- The target coordinates can be specified, or use the From Map button.

Character Joins

- Causes the specified champion to join the party.
- When selected, a champion creation dialog will be displayed (see Edit Party or Mirror Wizard for details on creating and editing champions).
- Select the action again to edit or change the champion.
- If there is not room in the party, the player is always presented the option to have them trade places with an existing champion or to cancel the join. (Unlike the Mirror Swap, any champion, not just the leader, can be chosen to trade places.)

Receive Item

- Causes the party to receive the specified item.
- When selected, the Item Wizard will be displayed.
- Select the action again to edit or change the item.
- If the "player" hand is empty, the new item will be put there. Otherwise, it will be set on the ground.

Healing

- Causes healing of health and/or stamina and/or mana to all living champions in the party.
- The numbers in the fields represent the percentage of champion's maximum to restore.
- The healing will not cause the values to exceed maximum (and will actually drop them to maximum if they were above it).
- The values can be negative, which would of course be the opposite of healing. Note that health will not go below 1 from this action (the champions cannot be killed).

Change Text

- Causes the text displayed by the event to change.
- Only the last Change Text Action will actually execute (unless a Question Action comes first, see below).

Change Picture

- Causes the picture displayed by the event to change.
- Only the last Change Picture Action will actually execute (unless a Question Action comes first, see below).

Play Sound

- Causes the specified sound file (wav) to be played.
- This sound cannot be made to loop, and does not affect the Initial Sound (which may still be playing, especially if it is looping).

Set Choice Visible

- Causes the selected Choice to become "visible."
- Only the Choices that have been fully created are available to choose from (the list will be updated whenever another choice is created/deleted, so you must create the target Choice (at least partially) and then return to this Choice and this Action to select it).
- Note that just because a Choice has been set "visible" does not mean the button for it will be displayed: any requirements on the Choice must be met for that to happen.
- Setting an Auto-Trigger Choice visible will not trigger it, but will instead make a button for it visible (if all requirements are met).

Set Choice Invisible

- Causes the selected Choice to become "invisible."
- Only the Choices that have been fully created are available to choose from (the list will be updated whenever another choice is created/deleted, so you must create the target Choice (at least partially) and then return to this Choice and this Action to select it).

Learn Ability

- Causes a champion (selectable during game) to learn the specified special ability. (See the Mirror Wizard for information about abilities.)
- Note that currently even dead champions can learn abilities. This may change in a future update.

Question

- Causes execution of actions to stop, all choice buttons to be hidden, and a text field to be displayed.
- The Answer field is where the correct answer is specified (case does not matter).
- The "Number of Actions if Correct" field indicates the number of Actions to execute if the player enters the correct answer. This starts with the Action directly following this one in the Choice's Action List. The execution of Actions is finished once these Actions have been performed.
- If the player enters the wrong answer, the rest of the Actions in the Choice's Action List are executed, starting at [Index of current Question Action + Number of Actions if Correct]. (In other words, the "correct" Actions are skipped if the player gets the question wrong.)
- Note: To display the actual question, simply make sure a Change Text Action is in the list before the Question Action.

Change Text Color

- Causes the color of the text displayed to change.
- Only the last Change Text Color Action will actually execute (unless a Question Action comes first, see below).

Change Text Align

- Causes the vertical alignment of the text displayed to change.
- Only the last Change Text Align Action will actually execute (unless a Question Action comes first, see below).

Change Picture Align

- Causes the vertical alignment of the picture displayed to change.
- Only the last Change Picture Align Action will actually execute (unless a Question Action comes first, see below).

Receive Experience

- Grants each champion the specified amount of experience.
- Depending on the amount of experience granted, champions could gain a level (but will never gain more than one).
- Negative values are permissable to cause an experience drain. Experience is permitted to go below 0, so the drain could be made very severe.
- A champion's current levels will not be affected by an experience drain. The next level gain will simply take longer to reach.

End Choice

- Causes the current Choice to end.
- Note that actions following this one will not be executed!

| Index | Main |