# How to use Key Mapping

#### 🎮 Keybinding System & Customization

We’ve implemented native `RegisterKeyMapping` support in our scripts to boost performance and eliminate the need for constant `while` loops monitoring key inputs.\
Thanks to this, key detection is now **event-based**, making the resource significantly more efficient.

With this system:

* Keybinds are assigned to specific chat commands.
* The associated actions are only triggered when the defined key is pressed.
* Players can fully customize their keybinds through the in-game menu:\
  **GTA V > Settings > Key Bindings > FiveM**

***

#### 🔧 How to Update or Unbind a Key

After first launching the script on your server, any changes to keybinds in `config.lua` **won’t apply** to players who have already joined.\
Only new players will receive the updated keybinds automatically.

If a player wants to reset or unbind the key manually, there are two options:

**Option 1 – via F8 Console:**

```
unbind keyboardinput_parameter
```

**Option 2 – via File Cleanup:**

1. Go to:\
   `C:\Users\[USERNAME]\AppData\Roaming\CitizenFX`
2. Open the `fivem.cfg` file.
3. Remove any lines related to the keybind for this script.
4. Restart FiveM.\
   → The keybind will now reset to the default value set in `config.lua.`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.qfdevelopers.com/general-informations/publish-your-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
