> For the complete documentation index, see [llms.txt](https://atiysus-organization.gitbook.io/aty-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atiysus-organization.gitbook.io/aty-scripts/dispatch-v2/installation.md).

# Installation

### Installation

1. Ensure your framework is set up and `aty_lib` is installed.
2. Place the `aty_dispatchv2` folder into your server's `resources` directory.
3. Add `ensure aty_dispatchv2` to your `server.cfg`. Make sure it starts *after* `aty_lib`.

### Configuration Guide (`shared/config.lua`)

The system is designed to be highly customizable for server owners. Key settings include:

* `Config.OldESX`: Set to `true` if you are utilizing an older version of ESX.
* `Config.Theme`: Choose between `"default"` or `"minimal"` themes.
* `Config.DispatchCommand` & `Config.MenuKey`: Customize the command (`/dispatchmenu`) and hotkey (default: `F7`) to open the UI.
* `Config.RespondKey` & `Config.UnRespondKey`: Customize responder action keys.
* **GPS Settings:** Define if a GPS item is required (`Config.RequireGpsItem`), name the item (`Config.GpsItem`), and dictate if it stays active when the player is downed (`Config.LeaveGpsOnDie`).
* **Realistic Rules:** Tweak detection distances in `Config.RealisticSeen`, and configure notification cooldowns in `Config.Timeouts`.
* **Department Colors:** Customize the hex gradient colors used for different jobs under `Config.Colors`.