📖About Geyser-Menu

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.jar and place it in your Geyser extensions/ folder
Start Geyser once to generate config.yml
Set your secret-key and server-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.