❓ Frequently Asked Questions
Why did my editor link expire?
For security, editor sessions expire after 1 hour of inactivity. While the tab is open, NxMenu sends a heartbeat every 5 minutes to keep your session alive. If you closed the tab and came back hours later, just run /nxmenu editor in-game again — your work is saved locally in your browser, so you pick up exactly where you left off.
Does this work on Bedrock?
Yes! All menu logic, click actions, and conditions work perfectly on Bedrock via GeyserMC. Custom item icons and GUI backgrounds also work if you install the Bedrock Addon pack (see the Bedrock section). The only caveat is shift-click and middle-click reliability on touch/controller devices.
Can I use my Texture Studio art in other plugins?
Yes! When you Export Pack, download the Java Pack ZIP. Inside you'll find nxmenu_titles.txt and nxmenu_cmd_list.txt with the exact Unicode characters and CMD numbers for everything you painted. You can use those values in any other plugin (DeluxeMenus, ChestCommands, etc.).
Why isn't my custom icon showing up in the Menu Builder dropdown?
After saving icons in Texture Studio, you need to click the ⟳ SYNC button in the Menu Builder's top bar. This re-reads the local storage and refreshes the material autocomplete list.
What's the difference between [require] in actions vs Open Requirements vs State conditions?
- Open Requirements — Gates the entire menu. If failed, the menu doesn't open at all.
- [require] in actions — Gates a specific click chain. If failed, that click does nothing (deny msg fires).
- State conditions — Visually changes a slot's appearance and click behavior based on conditions, without blocking access.
Why does [take] sometimes not work even when the player has the item?
NxMenu's [take] is strict by default — it only matches vanilla items with no custom name, lore, enchants, or CMD. This prevents accidentally consuming named/enchanted items. To take a CMD-specific item, use [take] PAPER:10001 1 instead of [take] PAPER 1.
How do I make a menu that opens for another player?
Use args. Set the menu's TRIGGER to profile. When a player runs /profile Notch, %arg1% becomes Notch. Use %arg1%:%placeholder% syntax to read Notch's data. See the Args & Player Profiles section for a full walkthrough.
Why is my custom GUI background not aligning correctly?
Three things to check:
- The hex code in Texture Studio's Unicode field must match exactly the hex you paste in the Menu Builder's Custom GUI input.
- Make sure the resource pack is actually applied client-side. Run the test command from the Export modal.
- The Menu Builder's title-mode dropdown must be set to ▧ CUSTOM GUI, not TEXT.
How many menus and icons can I create?
There's no hard limit on menus, GUI canvases, or icons. CMD numbers run from 10001 to over 2,000,000,000, so you essentially have unlimited room. Browser localStorage holds approximately 10MB of workspace data.
Can multiple admins edit the same workspace?
Each admin's workspace is local to their browser. To share, use the Share button in Texture Studio (URL-based) or the Export Package system in Menu Builder (ZIP-based). Note: there's no real-time multiplayer editing — work in shifts and re-share when changes are made.
Do meta variables persist across server restarts?
No. Meta variables (%nxmenu_meta_*%) are stored in memory and clear when the player disconnects or the server restarts. For persistent data, use a permission plugin's metadata or write to a database via console commands.