DGeyserMenuFlux

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9

平台： folia

标签： utility

? 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:

/getmenuclock  # Manually get a menu clock

? Base Commands

# Open specific menu
/dgeysermenu open <menu-name>

# Reload plugin configs
/dgeysermenu reload [all|java|bedrock]

# List available menus
/dgeysermenu list

# Get menu clock (admin)
/getmenuclock

? Shortcut Commands

# Open specific menu
/dgm open <menu-name>

# Reload plugin configs
/dgm reload [all|java|bedrock]

# List available menus
/dgm list

? Permission Nodes

# Basic usage permission
dgeysermenu.use

# Admin permissions
dgeysermenu.admin

# Specific menu access
dgeysermenu.menu.<menu-name>

# Reload permission
dgeysermenu.reload

? Configuration Guide

Java Edition Menus (java_menus/)

# 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
      - "[message] &aWelcome to the menu!"
      - "[player] spawn"
    right_click_commands:     # Right-click commands
      - "[close]"

Bedrock Edition Menus (bedrock_menus/)

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)

# 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)

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:
      - "[message] &6=== Server Info ==="
      - "[message] &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 teleport to spawn"
      - ""
      - "&fInstantly teleport to safe spawn area"
    left_click_commands:
      - "[player] spawn"            # Execute teleport command
      - "[message] &aTeleported to spawn!"  # Feedback message

  # Decorative border system
  border_top:
    slot: 0-8                      # Range slots, top border
    material: BLACK_STAINED_GLASS_PANE  # Black stained glass pane
    display_name: " "               # Empty name, pure decoration

Bedrock Edition Main Menu (bedrock_main.yml)

menu:
  title: "§6§lMain Menu"
  subtitle: "§7Welcome to our server!"
  footer: "§8Server Version 1.21.x"

  items:
    - text: "§e§lServer Info\n§7Click to view server status"
      icon: "textures/items/book_enchanted"  # Enchanted book icon
      icon_type: "path"
      command: "dgeysermenu open info"

    - text: "§a§lTeleport\n§7Quick travel to locations"
      icon: "textures/items/compass_item"    # Compass icon
      icon_type: "path"
      command: "dgeysermenu open warps"

? Migrating from DeluxeMenus

Configuration Comparison

? Feature Comparison

Migration Steps

1. Copy Config Files: Copy DeluxeMenus YAML files to java_menus/ folder
2. Adjust Paths: Ensure file paths are correct
3. Test Functionality: Use /dgeysermenu open <menu-name> to test
4. Bedrock Adaptation: Create corresponding Bedrock menus as needed

Migration Example

DeluxeMenus Config:

menu-title: "&cMain Menu"
menu-rows: 3
items:
  test_item:
    slot: 13
    material: DIAMOND
    display-name: "&bTest Item"
    left-click-commands:
      - "[player] say Test command"

DGeyserMenuFlux Config:

menu_title: "&cMain Menu"
rows: 3
items:
  test_item:
    slot: 13
    material: DIAMOND
    display_name: "&bTest Item"
    left_click_commands:
      - "[player] say Test command"

? Pro Tips

PAPI Variable Usage

items:
  player_stats:
    slot: 22
    material: PLAYER_HEAD
    display_name: "&b%player_name%"
    lore:
      - "&fLevel: &e%player_level%"
      - "&fBalance: &6%vault_eco_balance%"
      - "&fPlaytime: &b%player_time_hours% hours"

Conditional Command Execution

left_click_commands:
  - "[message] &6=== Conditional Test ==="
  - "[console] effect give %player_name% speed 30 1"
  - "[message] &aSpeed effect applied!"

Nested Menu System

left_click_commands:
  - "[menu] shop"          # Open shop menu
  - "[message] &2Welcome to the shop!"

? Troubleshooting

Common Issues

Q: Menus won't open

• ✅ Check permission settings dgeysermenu.use
• ✅ Confirm menu files are in correct folders
• ✅ Verify YAML syntax is correct

Q: Commands not executing

• ✅ Ensure correct command format
• ✅ Check if player has permission to execute commands
• ✅ Review console error messages

Q: Bedrock players can't see menus

• ✅ Confirm Floodgate is properly installed
• ✅ Check Bedrock menu config paths

Q: PAPI variables not displaying

• ✅ Verify PlaceholderAPI is installed
• ✅ Check variable name spelling

Debug Mode

Enable debug mode in config.yml:

settings:
  debug: true
  hot-reload:
    enabled: true

? Get Started

Download DGeyserMenuFlux now and bring revolutionary menu experiences to your server!

# Quick command tests
/dgeysermenu open main
/getmenuclock
/dgeysermenu reload

? Perfect multi-version support, blazing performance - every player gets the best interaction experience!