# Using mod menus

> Where to find each mod's menu and how its controls work - toggles, sliders, lists, pickers, key bindings, colors, sections and text fields.

URL: https://xichil.dev/wiki/xis-mvui/v1/guides/using-menus/ · Updated: 2026-11-06 · Applies to: Fabric, Quilt, Legacy Fabric, Forge, NeoForge, MC 1.7.10 - 26.3

Every mod that uses the library builds its menu from the same set of controls, and they look and work like
the game's own options screens. This page shows where to find the menus and what each control does.

## Open a menu

- **Options screen:** with one mod's menu installed, the button carries that mod's label and opens its menu.
  With several, the button reads **Mod menus...** and opens a list with one button per mod.
- **Mod list:** select the mod and press **Config**. This works on Forge and NeoForge, and on Fabric and Quilt
  with Mod Menu installed.
- **The mod's own key or button**, if the mod offers one.

**Done** leaves a screen. From a mod's first screen, that takes you back to where you opened the menu.

## The controls

| Control | Looks like | How to use it |
| --- | --- | --- |
| Button | a vanilla button | click it |
| On/off setting | a button reading "Name: ON" or "Name: OFF" | click to flip it |
| Check box | a box with a label beside it | click to check or uncheck |
| Choice | a button reading "Name: value" | click to step to the next value; after the last it starts again |
| List picker | like a choice | click to open a screen that lists every value; pick one, or press Cancel |
| Slider | a vanilla slider reading "Name: value" | drag it, click the track, or use the arrow keys while it is selected |
| Text field | a field with its name above it | type; a line below it says what's wrong, and the mod ignores the text until it is fixed |
| Number field | a text field | type a number; the line below says if it isn't a number or is out of range |
| Text box | a field several lines tall | type; Enter starts a new line, and long text scrolls |
| List | a scrolling list of rows | click a row to select it; buttons below usually act on the selected row |
| List editor | a list, a text field, **Add** and **Remove** | type a new item and press Add; select an item and press Remove |
| Key binding | a button reading "Name: key", like the Controls screen | click it, then press a key or mouse button. **Escape** unbinds it. |
| Color | a button reading "Name: #RRGGBB" with a color swatch | click to open a color editor (below) |
| Section | a button reading "▶ Title" | click to show the settings inside ("▼ Title"); click again to hide them |

Greyed-out controls can't be used right now, usually because another setting turns them off. Hover over one:
its tooltip often says why.

## The color editor

Clicking a color opens a screen with a preview, sliders for **Red**, **Green** and **Blue** (and **Alpha**, for
colors that can be see-through) from 0 to 255, and a **Hex** field where you can type the color as `#RRGGBB`
(or `#AARRGGBB`).

- **Done** keeps the new color.
- **Cancel** or **Escape** throws the changes away.

## Confirmations

Before something that can't be undone, such as deleting, a mod may ask on a screen of its own, like the
game's "Delete world?" screen. Pick the action to go ahead, or **No** or **Cancel** to go back without changes.

## "Working…"

Some actions, such as saving files, take a moment. The screen then shows **Working…** and ignores clicks until
the action is done. The game keeps running meanwhile.

## Languages

The library's own texts (Done, Cancel, Add, Remove…) follow the game's language. Each mod translates its own
menu; a mod that doesn't have your language shows its menu in English.

## Next steps

- [When a menu stops working](https://xichil.dev/wiki/xis-mvui/v1/mechanics/menu-errors/index.md)
- [Troubleshooting](https://xichil.dev/wiki/xis-mvui/v1/troubleshooting/index.md)