Before You Begin#
Deathmatch has no hard dependencies and no database. All lobbies live in memory, so there is no SQL to import.
Requirement | Status | Notes |
|---|---|---|
OneSync | Required | Matches use routing buckets and the |
Framework | Optional |
|
Ambulance resource | Recommended | Revives players between rounds. See the supported list in Integrations. |
ox_inventory / qs-inventory | Optional | Locks the weapon wheel during matches. |
qs-textui | Optional | Nicer 3D prompt at the entrance. |
Every optional integration is detected automatically when the resource starts. If something is missing, that feature simply falls back to the GTA default.
Downloading Deathmatch#
After purchasing Deathmatch, the resource is linked to your CFX Portal account. Sign in to the CFX Portal with the same account used during checkout, open Granted Assets and download qs-deathmatch.
After extracting the download, you should have the following folder:
qs-deathmatch/
├── shared/config.lua -- all settings
├── locales/ -- 29 languages
├── client/custom/ -- framework, ambulance and inventory bridges
├── server/custom/ -- framework, ambulance, FiveGuard and quests
├── html/ -- the menu and HUD
└── apiExamples.lua -- examples of the exports and eventsThe folder must be named
qs-deathmatch. The resource checks its own name on start and closes the server console if it was renamed.
Installing the Resource#
Move the qs-deathmatch folder into your server's resources directory, then add it to your server.cfg after everything it should detect:
# Framework
ensure es_extended # or qb-core / qbx_core
# Optional — start them before Deathmatch
ensure esx_ambulancejob # or your ambulance resource
ensure ox_inventory # or qs-inventory
ensure qs-textui
# Deathmatch
ensure qs-deathmatchThe loading order matters. Framework, ambulance and inventory are detected once, when Deathmatch starts. A resource that starts later is not seen.
Configuring the Resource#
Every setting lives in shared/config.lua. Each value is tagged: [EDIT] is safe to change, [ADV] only if you know what it does, and [CORE] / [AUTO] should be left alone.
Language#
Config.Language = 'en'
-- ar, bg, ca, cs, da, de, el, en, es, fa, fr, he, hi, hu, it,
-- jp, ko, nl, no, pl, pt, ro, ru, sl, sv, th, tk, tr, zhThe value must match a file in locales/. The same file translates the in-game texts and the menu.
Entrance marker and blip#
The entrance is where players open the Deathmatch menu. By default it is at the Port of Los Santos.
Config.SpotEnable = true
Config.Marker = {
DrawDistance = 10,
Pos = vector3(478.443970, -3369.969238, 4.660791),
Type = 1,
Size = vector3(5.5, 5.5, 1.5),
Color = { r = 255, g = 255, b = 255 },
}
Config.Blip = {
Enable = true,
SetBlipSprite = 437,
SetBlipScale = 0.6,
SetBlipColour = 36,
}Option | What it does |
|---|---|
| Draws the marker, the 3D prompt and the blip. Set to |
| Position of the entrance. Players must be within 10 meters to use the menu. |
| Look of the floor marker. Type and Size are also used for the green play-area marker during matches. |
| Map blip sprite, scale and colour. The name comes from the locale key |
Other settings#
Option | Default | What it does |
|---|---|---|
| 420 | Seconds per round. When it reaches zero the match ends as a timeout. See Usage. |
| false | Name of your FiveGuard resource, to grant temporary bypasses during matches. |
| 8 maps | Spawns and play area of every map. |
| — | The pre-match showcase. |
| true | Prints |
Verifying the Installation#
Restart the server and look for the version line in the console:
You are using the latest version of qs-deathmatch!Then join and play a first match:
Go to the entrance
Follow the Deathmatch Zone blip, stand on the marker and press E.
Create a lobby
Press Create a room, give it a name of 4 to 15 characters, choose a map and a weapon, and create it.
Start the match
Have a second player join the other team and press I am ready. Press Start.
Next: learn how lobbies, rounds and maps work in Usage.