> For the complete documentation index, see [llms.txt](https://mango-5m.gitbook.io/mango5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mango-5m.gitbook.io/mango5m-docs/resources/mango-achievements/configuration/menu-and-keybinds.md).

# Menu and Keybinds

How players open the trophy list, and what it looks like.

```lua
Config.Menu = {
    keybind = { enabled = true, key = 'F3', label = 'Open Achievements' },
    pause   = { enabled = true, rawKey = 0x72, keyName = 'F3', hint = true },
    command = 'achievements',
    title   = 'Mango 5M',
    blurBackground = true,
    freezePlayer   = false,
}
```

| Setting          | Does                                                                       |
| ---------------- | -------------------------------------------------------------------------- |
| `keybind`        | A rebindable key, shown in *FiveM → Settings → Key Bindings*               |
| `pause`          | Opens the list from the pause menu. `rawKey` is a Windows virtual-key code |
| `command`        | Chat command name. `false` to skip registering it                          |
| `title`          | Your server name, shown top-left                                           |
| `blurBackground` | Blurs the game behind the menu                                             |
| `freezePlayer`   | Stops the ped moving while the menu is open                                |

## Opening from the pause menu

While the pause menu is open a prompt appears in the corner. Pressing the key closes the pause menu and opens the trophy list.

<details>

<summary>Why is it not a tab inside the GTA pause menu?</summary>

Because FiveM genuinely cannot do that, and any resource claiming otherwise is doing something else and calling it a tab.

The GTA V pause menu is built by the game's own compiled code from a layout file that ships **inside the FiveM client**. A server resource cannot replace it, no native exists to register a new page, and even if a tab appeared there would be nothing behind it to fill in.

What this resource does instead is watch for a key while the pause menu is open, close it, and open its own full-screen page. Your stock pause menu is never modified and keeps working exactly as it always did.

</details>

## Categories and rarities

Both lists live in `config.lua` and drive the filter drawer, the trophy counters and the colours on each row.

```lua
Config.Rarities = {
    { id = 'common',    label = 'Common',    colour = '#c8825a', order = 1 },
    { id = 'uncommon',  label = 'Uncommon',  colour = '#c2c6cd', order = 2 },
    { id = 'rare',      label = 'Rare',      colour = '#e3b23f', order = 3 },
    { id = 'epic',      label = 'Epic',      colour = '#5aa9ec', order = 4 },
    { id = 'legendary', label = 'Legendary', colour = '#9fd6ff', order = 5 },
}
```

Add your own freely. An award with an unknown rarity falls back to the first entry rather than breaking the row.