📱 Bedrock Edition (via Geyser)

NxMenu has full Bedrock support — with caveats. Here's exactly what works.

What Works on Bedrock

• ✅ All menu logic — click actions, conditions, variables, states
• ✅ Custom GUI backgrounds (with the Bedrock UI overlay pack)
• ✅ Custom icons (via Geyser item mappings)
• ✅ Heads (HEAD- and BASEHEAD-)
• ✅ PlaceholderAPI integration

What Doesn't Work

• ⚠️ Shift-click reliability (Bedrock players can't shift-click in inventories on touch/controller)
• ⚠️ Middle-click on touch devices (no middle button on phones)

Recommendation: If you have a large Bedrock playerbase, prefer LEFT and RIGHT click handlers as the primary interactions. Use Shift/Middle for power-user shortcuts only.

Setting Up Bedrock

The Texture Studio's Export modal includes a Bedrock Addon download. The ZIP contains:

• Geyser-Spigot/packs/nxmenu_geyser_pack.zip — Bedrock item textures with CMD→bedrock_identifier mappings
• Geyser-Spigot/packs/nxmenu_ui_pack.mcpack — UI overlay pack for custom GUI backgrounds
• Geyser-Spigot/custom_mappings/geyser_mappings.json — The Geyser item mapping config

Installation:

1. Download and extract the Bedrock ZIP.
2. Copy the contents of the Geyser-Spigot folder into your plugins/Geyser-Spigot/ folder, preserving subfolder structure.
3. Restart your server (or run /geyser reload).
4. Bedrock players will now see your custom item icons and GUI backgrounds.

How the Bedrock UI Pack Works

NxMenu uses a clever trick: when a menu's title contains a special § sequence, the Bedrock UI pack detects it and overlays the matching custom GUI background on top of the standard chest screen. This happens entirely client-side via Bedrock's UI definition system.

For Bedrock players, your menu still functions exactly the same — clicks register, actions execute, items appear. The only difference is the texture rendering pipeline.