Custom Icons (CMD Bridge) · NxMenu

🔗 The PAPER:CMD Bridge

Custom Model Data is how Minecraft displays a different texture on the same item type. NxMenu uses Paper as the base item for all custom icons, so you can have unlimited custom-art clickable buttons.

The Workflow

1. Draw Your Icon

In Texture Studio, switch to Custom Icons mode. Either click an existing icon to edit it, or click + New Icon.

2. Set the Icon Name and CMD

In the right Inspector:

Icon ID / Name: A friendly identifier like gold_coin or quest_button. Letters, numbers, underscores only.
Custom Model Data: A unique number starting at 10001. Click Auto to assign the next free one. The studio warns you of conflicts.

3. Paint the Icon

Use the 18×18 grid. Tools include brush, fill, eyedropper, line, rectangle, eraser, plus mirror X/Y. The icon auto-saves on every brush stroke release.

4. Export the Pack

Click Export Pack, run the install command in-game.

5. Use the Icon in a Menu

Switch to Menu Builder. Click ⟳ SYNC first to refresh the dropdowns. Select a slot, and in the Material field, you can either type:

gold_coin — The friendly name (auto-converts to PAPER:CMD)
PAPER:10001 — Direct CMD format

Both work identically.

The Special Invisible Icon (CMD 10000)

🔮 Pro Trick: NxMenu auto-generates an invisible 16×16 paper item at PAPER:10000. This is incredibly useful: place an invisible button over your custom-painted GUI background to create a clickable hitbox where there's no "item" visible. Perfect for buttons painted directly into the GUI background!

Example: You painted a "CLOSE" button into your GUI background art. In the Menu Builder, place an item at the slot where that art appears, set Material to PAPER:10000, set Hide Tooltip to true, and add a [close] action. Players see your painted button — click it — menu closes. Looks like magic.

For invisible buttons over GUI backgrounds, always check HIDE TOOLTIP in the Visual tab. This requires Minecraft 1.20.5+ on the server.