> For the complete documentation index, see [llms.txt](https://5scripts-1.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://5scripts-1.gitbook.io/docs/assets/5s_hitmarker/faq.md).

# FAQ

<details>

<summary>How do players change their hit marker settings?</summary>

Every player can run the `/hitmarker` command in-game to open the settings menu, where they can toggle markers, toggle sounds, pick a sound pack and set the volume.

Settings are saved locally per client, so each player keeps their own preferences between sessions.

</details>

<details>

<summary>How do I switch to the crosshair (X) marker instead of damage numbers?</summary>

Open the `/hitmarker` menu and toggle **Marker Style** to `Crosshair`. This shows a classic 2D "X" hit marker at the center of the screen instead of the floating 3D damage numbers. The marker color still reflects the kill/headshot/armor/health logic from `Config.hitThresholds`.

You can tweak its size, thickness, gap and duration in `Config.crosshairMarker`.

</details>

<details>

<summary>Can players share their hitmarker settings?</summary>

Yes. In the `/hitmarker` menu, **Export Settings** copies the current configuration to the clipboard as a short share code. Another player can paste that code into **Import Settings** to instantly apply the same setup.

</details>

<details>

<summary>How do I add my own sound pack?</summary>

1. Drop your `.mp3` file(s) into the `5s_hitmarker/ui/sounds/` folder.
2. Add a new entry to `Config.soundTypes` in <kbd>5s\_hitmarker/config.lua</kbd>:

```lua
Config.soundTypes = {
    -- ...existing packs...

    myPack = {
        label = 'My Pack',                       -- name shown in the /hitmarker menu
        hitSound = 'sounds/my_hit.mp3',          -- normal hit sound
        headshotSound = 'sounds/my_headshot.mp3' -- optional headshot sound
    }
}
```

Paths are relative to the `ui/` folder. Restart the resource and the new pack will be selectable in the menu.

</details>

<details>

<summary>No sounds are playing</summary>

* Make sure sounds are enabled in the `/hitmarker` menu and the volume is above `0`.
* Confirm the file paths in `Config.soundTypes` match the files in `ui/sounds/`.
* Check that the sound files are valid `.mp3` files and listed in the resource `files {}` glob.

</details>

<details>

<summary>How do I change the marker colors or size?</summary>

Edit the `Config.hitThresholds` table in <kbd>5s\_hitmarker/config.lua</kbd>. Each style uses `r`, `g`, `b` for the color and `scaleStart` / `scaleEnd` for the size. See the [Config](/docs/assets/5s_hitmarker/config.md) page for details.

</details>

<details>

<summary>Can I give headshots a different marker color?</summary>

Yes. In `Config.hitThresholds`, change `headshot` from `'default'` to a style table, for example:

```lua
headshot = { r = 255, g = 140, b = 0, scaleStart = 0.75, scaleEnd = 0.6 }
```

</details>

<details>

<summary>Does this script need a database or a framework?</summary>

No. `5s_hitmarker` is fully standalone and client-side. It does not require ESX, QBCore, or a database - player settings are stored locally on each client.

</details>