Menus

---

Quick Start

New to the menu system? Start here:

1

Read Menu Configuration

Learn the YAML structure and basic properties

Menu Configuration

2

Understand Variables

Understand how variables work.

Menu Variables

3

Explore Actions

Discover what players can do when clicking items

4

Look at examples

More will be added soon.

Menu Examples

---

Core Concepts

The menu system is built around three pillars:

Variables

Dynamic data that flows between menus and persists during navigation

Menu Variables

Actions

Commands that execute when players interact with menu items

Menus

Conditions

Requirements that control visibility and clickability of items

Menu Conditions

---

How It Works

The Context System

Every menu creates a context, a data container that travels with the player:

Data Flow

1

Menu Opens

A context is created with default variables and any passed parameters

2

Item Rendering

Variables and PlaceholderAPI are resolved in item names, lore, and materials

3

Player Interacts

Actions execute with access to the current context

4

Navigation

If opening another menu, the context is passed along (child context inherits parent variables)

---