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
- Download
GeyserMenu.jarand place it in your Geyserextensions/folder - Start Geyser once to generate
config.yml - Set your
secret-keyandserver-port - Install the companion plugin on your server with matching credentials
- 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.
