# Configuration

The main configuration file is `0r-gungame/config.lua`.

## Main Settings You Will Usually Change

| Field                         | What it controls                           |
| ----------------------------- | ------------------------------------------ |
| `Config.Commands.OpenMenu`    | Menu command                               |
| `Config.Commands.EndMatch`    | Force end match command for lobby leader   |
| `Config.Game.weapons`         | Weapon categories used in matches          |
| `Config.Game.reviveCountdown` | Respawn delay                              |
| `Config.Game.gameTimes`       | Allowed match durations                    |
| `Config.Game.startCountDown`  | Countdown before match starts              |
| `Config.Game.maps`            | Arena list, map image, and spawn positions |
| `Config.GunGameMenuZone`      | Physical menu zone and blip                |
| `Config.debug`                | Debug mode                                 |

## Commands

Default commands:

```lua
/gungame
/endgungame
```

If you change these names, restart the resource after saving `config.lua`.

## Weapon Categories

GunGame uses grouped weapon sets instead of one single weapon.

The default categories are:

* `random`
* `melee`
* `handguns`
* `submachine`
* `shotguns`
* `rifles`

If you add or remove weapons, keep the weapon names valid GTA weapon names.

## Match Flow

The most commonly changed gameplay values are:

* `Config.Game.reviveCountdown`
* `Config.Game.gameTimes`
* `Config.Game.startCountDown`

These values control how fast the arena feels.

## Maps and Spawn Points

Each entry in `Config.Game.maps` contains:

* Preview image name
* Display name
* Red team spawn points
* Blue team spawn points

If you create your own map, add both team spawn lists and place the matching image in:

```lua
ui/build/images/maps
```

## Menu Zone

`Config.GunGameMenuZone` lets you force players to go to one location before opening the arena UI.

You can change:

* `active`
* `coords`
* blip sprite
* blip color
* blip scale
* blip name

## Localization

This resource uses locale files in the `locales/` folder. The active language is controlled through `ox_lib`.

Example:

```cfg
set ox:locale "en"
```