CustomMenu

Create beautiful menus for both Bedrock and Java players!

CustomMenu is a powerful Paper plugin that lets you create custom menus using simple YAML files. It automatically shows the right UI for each player - Bedrock players see native forms, Java players see the new Dialog API.

---

✨ Features

| Feature | Description |
|---------|-------------|
| 🎮 Cross-Platform | Works for both Bedrock (via Floodgate) and Java players |
| 📋 Easy YAML Config | Simple, readable menu configuration files |
| 🔄 Hot Reload | Reload menus without restarting the server |
| 🖼️ Button Images | Add icons to buttons (Bedrock only) |
| 📝 Input Forms | Text fields, dropdowns, toggles, sliders |
| 🔐 Permissions | Per-menu permission control |
| ⚡ Lightweight | No dependencies required |

---

📦 Installation

1. Download the JAR file
2. Place it in your /plugins/ folder
3. Restart your server
4. Edit menus in /plugins/CustomMenu/menu/

---

🎮 Commands

| Command | Permission | Description |
|---------|------------|-------------|
| /cmenu open <menu> | custommenu.open | Open a menu |
| /cmenu reload | custommenu.reload | Reload all menus |
| /cmenu list | custommenu.list | List available menus |

Permissions

• custommenu.open - Use the open command
• custommenu.open.<menu> - Open specific menu
• custommenu.reload - Reload menus (default: op)
• custommenu.list - List menus (default: true)

---

📝 Menu Configuration

Create .yml files in /plugins/CustomMenu/menu/

Simple Button Menu

title: "Server Menu"
content: "Welcome! Choose an option:"

buttons:
  - text: "Spawn"
    action: command
    value: spawn

  - text: "Shop"
    action: command
    value: shop

  - text: "Close"
    action: close

Button with Image (Bedrock)

buttons:
  - text: "Spawn"
    action: command
    value: spawn
    image: "https://example.com/icon.png"
    image_type: url

Form with Inputs

title: "Player Report"
content: "Fill out the form:"

inputs:
  - type: input
    id: player
    label: "Player Name"
    placeholder: "Enter name..."

  - type: dropdown
    id: reason
    label: "Reason"
    options:
      - Cheating
      - Griefing
      - Spam

  - type: toggle
    id: urgent
    label: "Urgent"
    default: "false"

submit:
  text: "Submit Report"
  action: console
  value: "report {player} {reason} {urgent}"

---

🔧 Actions

| Action | Description | Example |
|--------|-------------|---------|
| command | Run as player | spawn |
| console | Run as console | give {player} diamond 1 |
| message | Send message | Hello {player}! |
| menu | Open menu | settings |
| close | Close menu | - |

---

📌 Placeholders

| Placeholder | Description |
|-------------|-------------|
| {player} | Player name |
| {uuid} | Player UUID |
| {input_id} | Value from input |

---

🎨 Input Types

| Type | Description | Platform |
|------|-------------|----------|
| input / text | Text field | Both |
| dropdown | Select list | Both |
| toggle / bool | On/Off switch | Both |
| slider | Number range | Both |
| label | Display text | Both |

---

🔗 Platform-Specific Settings

title: "Menu"
content: "Select option:"

buttons:
  - text: "Option"
    action: command
    value: test

# Override for Bedrock players
form:
  title: "Bedrock Menu"
  content: "Tap to select!"

# Override for Java players
dialog:
  title: "Java Menu"
  content: "Click to select!"

---

📋 Requirements

• Paper 1.21.7+ (required for Dialog API)
• Floodgate (optional, for Bedrock support)