DGeyserMenuFlux

# 🌟 DGeyserMenuFlux - The Next-Gen Multi-Version Menu Plugin

> 🚀 A revolutionary Minecraft menu plugin with seamless Java & Bedrock Edition support

## ✨ Core Features

### 🎯 Game-Changing Multi-Version Support - Java Edition: Native chest menus with traditional Minecraft UI - Bedrock Edition: Native form menus optimized for mobile & console - Smart Detection: Automatically serves the right menu for each player's version

### ⚡ Blazing Performance & UX - Lightweight Design: Core features only, zero performance overhead - Hot-Reload Configs: Changes apply instantly, no server restart needed - Massive Capacity: Supports up to 6 rows (54 slots) for Java menus - Seamless Migration: Perfect compatibility with DeluxeMenus configs

### 🛠 Developer Friendly - PAPI Support: Full PlaceholderAPI variable integration - Beginner Friendly: Simple setup, quick to master - Rich Examples: Complete, ready-to-use sample menus included

### 🎁 Smart Item System - Auto Clock Management: Detects missing menu clocks in inventory and auto-replaces - Death Protection: Clocks never drop on death - Unique Identification: NBT tags ensure clock uniqueness - Quick Access: Right-click clock to instantly open main menu

## 🚀 Quick Start

### Installation Steps 1. Drop the plugin into your `plugins` folder 2. Restart your server 3. Check generated sample menus in `plugins/DGeyserMenuFlux/` 4. Modify configs to fit your needs

### 🕰️ Smart Clock System Automatically provides every player with a Menu Clock: - ✅ Auto-Detection: Checks inventory on login, replaces if missing - ✅ Death Protection: Never drops on death, auto-restores on respawn - ✅ Quick Access: Right-click to instantly open main menu - ✅ Permission Control: Requires `dgeysermenu.use` permission

Admin Commands: ```bash /getmenuclock # Manually get a menu clock ```

### 📋 Base Commands ```bash # Open specific menu /dgeysermenu open

# Reload plugin configs /dgeysermenu reload

# List available menus /dgeysermenu list

# Get menu clock (admin) /getmenuclock ```

### 📋 Shortcut Commands ```bash # Open specific menu /dgm open

# Reload plugin configs /dgm reload

# List available menus /dgm list ```

### 🔐 Permission Nodes ```yaml # Basic usage permission dgeysermenu.use

# Admin permissions dgeysermenu.admin

# Specific menu access dgeysermenu.menu.

# Reload permission dgeysermenu.reload ```

## 📖 Configuration Guide

### Java Edition Menus (java_menus/) ```yaml # Basic settings menu_title: "&6&lMain Menu" # Menu title (supports color codes) rows: 6 # Menu rows (1-6)

# Item configuration example items: info_item: # Unique item ID slot: 11 # Slot (0-53) or range "0-8" material: PAPER # Material name display_name: "&e&lInfo" # Display name lore: # Description text - "&7Click to view server info" - "&fOnline: &a%server_online%"

# Command configuration left_click_commands: # Left-click commands - " &aWelcome to the menu!" - " spawn" right_click_commands: # Right-click commands - "" ```

### Bedrock Edition Menus (bedrock_menus/) ```yaml menu: title: "Main Menu" # Form title subtitle: "Welcome" # Subtitle footer: "Server Name" # Footer text

items: - text: "Server Info" # Button text icon: "textures/items/paper" # Icon path icon_type: "path" # Icon type (path/url) command: "dgeysermenu open info" # Command to execute execute_as: "player" # Execution identity (player/console) ```

```yaml # Configuration example - config.yml settings: menu-clock: enabled: true # Enable clock system auto-give: true # Auto-give clocks death-protection: true # Death protection ```

## 🎨 Sample Menu Breakdown

### 🏠 Main Menu Configuration

#### Java Edition Main Menu (main.yml) ```yaml menu_title: "&6&lMain Menu &7| &fServer Name" rows: 6

items: # Server info section server_info: slot: 10 material: KNOWLEDGE_BOOK # Knowledge book material for info display_name: "&e&lServer Info" # Yellow highlight lore: # Dynamic server data display - "&7Click to view server info" - "" - "&fOnline Players: &a%server_online%&f/&a%server_max_players%" - "&fTPS: &a%server_tps%" left_click_commands: - " &6=== Server Info ===" - " &fOnline Players: &a%server_online%&f/&a%server_max_players%"

# Teleport functionality teleport_spawn: slot: 12 material: COMPASS # Compass material for navigation display_name: "&a&lTeleport to Spawn" # Green for safe teleport lore: - "&7Click to telepor