# GeyserMenu<\/p>\n
A Geyser extension that gives Bedrock players a native form-based menu,
\ntriggered by double-clicking their inventory button. Designed as a foundation for
\nbuilding rich Bedrock-friendly UIs on any Java server \u2014 without touching the Java side directly.<\/p>\n
## How It Works<\/p>\n
Bedrock players double-click their inventory to open the menu. Companion plugins register
\nbuttons over a secure Netty TCP connection \u2014 each button can run a command, open a form,
\nor trigger custom logic. Everything is handled server-side through the
\nGeyserMenu Companion plugin.<\/p>\n
## Features<\/p>\n
– **Inventory double-click detection** \u2014 opens the menu instantly for Bedrock players
\n– **Button registration API** \u2014 companion plugins register buttons dynamically over TCP
\n– **Form support** \u2014 send simple, modal, and custom forms to Bedrock players
\n– **Permission-based visibility** \u2014 show or hide buttons based on player permissions
\n– **GeyserExtras compatible** \u2014 detects and works alongside GeyserExtras addon buttons
\n– **Secure TCP protocol** \u2014 Netty-based communication with shared secret authentication
\n– **Java players unaffected** \u2014 detection is Bedrock-only via Floodgate<\/p>\n
## Requirements<\/p>\n
– Geyser **2.9.0+**
\n– Java **21+**
\n– GeyserMenu Companion on your Spigot\/Paper or Velocity server<\/p>\n
## Installation<\/p>\n
1. Download `GeyserMenu.jar` and place it in your Geyser `extensions\/` folder
\n2. Start Geyser once to generate `config.yml`
\n3. Set your `secret-key` and `server-port`
\n4. Install the companion plugin on your server with matching credentials
\n5. Restart \u2014 buttons registered by companion plugins will appear automatically<\/p>\n
## Configuration
\n“`yaml
\ndefault-menu-title: “Server Menu”
\nrequire-authentication: true
\nsecret-key: “your-secret-key-here”
\nserver-port: 19133
\n“`<\/p>\n
## For Developers<\/p>\n
Use the GeyserMenu Companion API
\nto register buttons and send forms from your own plugins. Supports Spigot\/Paper and Velocity.<\/p>\n
## Links<\/p>\n
– GeyserMenu Companion
\n– GitHub
\n– Report Issues<\/p>\n","protected":false},"excerpt":{"rendered":"
A Geyser extension that adds a customizable form-based menu for Bedrock players, triggered by double-clicking inventory \u2014 with a companion API for plugins to register buttons over TCP<\/p>\n","protected":false},"featured_media":75432,"template":"","meta":{"_minecraft_slug":"geyser-menu","_minecraft_project_id":"owJ2jRKw","_minecraft_author":"dronzer-tb","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":79,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"geyser-menu.zip","_minecraft_size_bytes":4963218,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:13:15.028335Z","_minecraft_date_created":"2026-03-17T00:56:17.730579Z","_minecraft_date_modified":"2026-03-15T17:59:00.253400Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/geyser-menu","_minecraft_icon_attachment_id":75432,"_minecraft_imported_at":"2026-06-04T08:56:03+00:00","_minecraft_import_hash":"54eae9cc3e03186b1341f022e49faa27","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[1003],"mod_loader":[1004],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-75431","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-geyser","mod_loader-geyser","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n