> 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.md).

# 5s\_hitmarker

### 📖 Documentation Sections

* **🖥️** [**Install**](/docs/assets/5s_hitmarker/install.md) - File installation and server.cfg setup
* **🔧** [**Configuration**](/docs/assets/5s_hitmarker/config.md) - Colors, scaling, fonts and sound packs
* **📝** [**Editable Files**](https://gitlab.d2qube.com/5scripts/5s_docs/-/tree/main/assets/5s_hitmarker/editable.md) - Files you can safely modify
* **💻** [**Available exports**](/docs/assets/5s_hitmarker/exports.md) - Exports to use in your code
* **❓** [**Frequently asked questions**](/docs/assets/5s_hitmarker/faq.md) - Answers to questions asked frequently

### 🚀 Quick Start

1. Place the script in your `resources` folder
2. Add `ensure 5s_hitmarker` to your server.cfg
3. Configure dependencies: `ox_lib`, `5s_lib`

### 📦 Dependencies

* **ox\_lib** (required)
* **5s\_lib** (required)

### ✨ Features

* Color-coded markers based on remaining health, armor, kills and headshots
* Two marker styles: floating 3D damage numbers **or** a 2D crosshair (X) marker
* Distance-based scaling and fade-out for the 3D numbers
* Multiple built-in sound packs (Rust, CS2, Casual, Minecraft) - fully extendable
* In-game player menu (`/hitmarker`) with persistent per-player settings
* Export / import settings to share builds between players
* Standalone - no framework required, runs purely client-side