Geyser-Menu

Minecraft 版本： 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 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 1.21.10 1.21.11

平台： geyser

GeyserMenu

A Geyser extension that gives Bedrock players a native form-based menu,
triggered by double-clicking their inventory button. Designed as a foundation for
building rich Bedrock-friendly UIs on any Java server — without touching the Java side directly.

How It Works

Bedrock players double-click their inventory to open the menu. Companion plugins register
buttons over a secure Netty TCP connection — each button can run a command, open a form,
or trigger custom logic. Everything is handled server-side through the
GeyserMenu Companion plugin.

Features

• Inventory double-click detection — opens the menu instantly for Bedrock players
• Button registration API — companion plugins register buttons dynamically over TCP
• Form support — send simple, modal, and custom forms to Bedrock players
• Permission-based visibility — show or hide buttons based on player permissions
• GeyserExtras compatible — detects and works alongside GeyserExtras addon buttons
• Secure TCP protocol — Netty-based communication with shared secret authentication
• Java players unaffected — detection is Bedrock-only via Floodgate

Requirements

• Geyser 2.9.0+
• Java 21+
• GeyserMenu Companion on your Spigot/Paper or Velocity server

Installation

1. Download GeyserMenu.jar and place it in your Geyser extensions/ folder
2. Start Geyser once to generate config.yml
3. Set your secret-key and server-port
4. Install the companion plugin on your server with matching credentials
5. Restart — buttons registered by companion plugins will appear automatically

Configuration

default-menu-title: "Server Menu"
require-authentication: true
secret-key: "your-secret-key-here"
server-port: 19133

For Developers

Use the GeyserMenu Companion API
to register buttons and send forms from your own plugins. Supports Spigot/Paper and Velocity.

Links

• GeyserMenu Companion
• GitHub
• Report Issues