Event Triggers

🧭 Overview

Triggers are the backbone of interactive menus. They define what happens when an item is clicked and how it behaves in the menu system. Some triggers act as actions (e.g., open a menu), while others act as conditions (e.g., only show if player has enough gold).

---

🛠 How to Use

1. Assign Trigger: Add trigger: [TRIGGER_ID] to your item settings.

2. Combine Conditions: Some triggers can be combined or work conditionally.

Format:

item-settings:
  slot: 49
  trigger: OPEN_GAME_PREVIEW

---

📝 Trigger List

🖱️ General Actions

Trigger ID	Description
OPEN_[MENU_ID]	Opens the specified menu (e.g., OPEN_MAIN_MENU).
CLOSE_MENU	Closes the current menu.
GO_BACK	Opens the previously visited menu.
PREVIOUS_PAGE	Moves to the previous page in a paginated menu.
NEXT_PAGE	Moves to the next page in a paginated menu.

🛍️ Shop & Transaction

Trigger ID	Description
ITEM_BOUGHT	Executes purchase logic for the item.
ITEM_CLICK_TO_BUY	Shows the purchase confirmation/prompt.
ITEM_NOT_ENOUGH_GOLD	Displayed when player lacks funds.
ITEM_NO_PERMISSION	Displayed when player lacks permission.
ITEM_PREVIEW	Shows item details without purchase prompt.

🎲 Special Systems

Trigger ID	Description
ANVIL_CLICK_TO_ROLL	Initiates an anvil stat roll.
ANVIL_NOT_ENOUGH_GOLD	Fail state for anvil roll.
ANVIL_PREVIEW	Preview for anvil mechanic.
MYTHIC_CLICK_TO_ROLL	Initiates a mythic item roll.
MYTHIC_NOT_ENOUGH_GOLD	Fail state for mythic roll.
MYTHIC_PREVIEW	Preview for mythic mechanic.

🗂️ Filtering & Sorting

Trigger ID	Description
FILTER_ALL	Shows all items.
FILTER_OWNED	Shows only owned items.
FILTER_UNOWNED	Shows only unowned items.
CATEGORY_SELECTED	Highlights the currently selected category.
CATEGORY_CLICK_TO_SELECT	Switches view to the clicked category.

⚠️ Misc

Trigger ID	Description
IGNORE_BUILD	Prevents the item from being built/shown.
IGNORE_EVENT	Cancels the click event (no action taken).
SEPARATOR_ACTIVE	Visual separator (active state).
SEPARATOR_INACTIVE	Visual separator (inactive state).
DISCARD_ITEM	Action to discard an item (e.g., trash can).