> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_hud/chat-suggestions.md).

# Chat Suggestions

## 💬 Setting up Chat Suggestions

To ensure that chat command auto-complete and dynamic suggestions work perfectly within the custom HUD, you need to install the `chat-suggestions` helper script.

### 🛠️ Installation Steps

**1. Locate the Script** Find the `chat-suggestions` folder included in your download inside `INSTALL ME FIRST`

**2. Add to Resources** Drag and drop the `chat-suggestions` folder into your server's `resources` directory.

**3. Edit `server.cfg`** Open your `server.cfg` file to start the resource. Pay close attention to the load order below.

### ⚠️ Critical Note on Load Order

> 🛑 **IMPORTANT: MUST LOAD BEFORE FRAMEWORK**
>
> You **MUST** start `chat-suggestions` **BEFORE** your core framework (`es_extended`, `qb-core`, or `qbx_core`).
>
> **Why?** The main `ak47_hud` script loads *after* your framework. The `chat-suggestions` script needs to load *first* so it can actively listen for and capture all the chat command suggestions that register when your framework initializes on server startup.

#### ✅ Example `server.cfg` Layout

Make sure your configuration looks similar to this:

```
# 1. Start Chat Suggestions Helper FIRST
ensure chat-suggestions

# 2. Then start your core framework
ensure qb-core  # or es_extended / qbx_core

# ... (other dependencies and scripts) ...

# 3. Finally, start the main HUD
ensure ak47_hud
```
