Event Triggers

🧭 Overview

Most menu items in the plugin have triggers. Triggers act as instructions that tell the plugin what to do when someone clicks an item. Some triggers also work as conditions, determining whether an item should be visible or not.

It’s generally safe to change non-conditional triggers, but be careful when modifying conditional triggers. Doing it incorrectly might break menus — for example, an item that unlocks or selects something may not appear.

---

🛠 How to Set

1. Open the menu file you want to edit.

2. Find the item in the file and look for the trigger setting.

   • If the trigger is missing, you can add it.

3. Use this format to assign a trigger:

trigger: [TRIGGER ID]

1. Replace [TRIGGER ID] with the actual trigger ID you want to assign to that item.

---

💡 Examples

🔹 Go Back Button

go-back:
  item-settings:
    slot: 49
    trigger: OPEN_GAME_PREVIEW
    require-previous: GAME_PREVIEW
    commands:
  meta-builder:
    name: "&aGo Back"
    lore:
    type: RED_BED
    amount: 1
    glint: false
    model: 0
    head: ""

🔹 Reroll Available Choice

reroll-available-2:
  item-settings:
    slot: 42
    trigger: REROLL_AVAILABLE_2,IGNORE_BUILD
    commands:
  meta-builder:
    name: "&a🗘 Reroll Choice"
    type: PAPER
    amount: 1
    glint: false
    model: 11205108
    head: ""

---

📝 Trigger List

Trigger ID	Type	Action
OPEN_[MENU ID]	Free to use	Opens a menu.
IGNORE_BUILD	Free to use	Ignores the item.
IGNORE_EVENT	Free to use	Ignores the click event.
CLOSE_MENU	Free to use	Closes a menu.
GO_BACK	Free to use	Opens a previous menu.
PREVIOUS_PAGE	Conditional	Goes to the next page.
NEXT_PAGE	Conditional	Goes to the previous page.
FILTER_ALL	Conditional	Sets the filter to ALL.
FILTER_OWNED	Conditional	Sets the filter to OWNED.
FILTER_UNOWNED	Conditional	Sets the filter to UNOWNED.