Usage — Water War | Quasar Store | Quasar Store

Usage — Water War | Quasar Store | Quasar Store

The Creator#

Everything about arenas happens in one window, the Water War Creator, opened with /waterwarcreator. Players never open anything — they just walk into an arena.

The window has two halves. On the left, every arena on the server sorted by name, with a search box and a Create Arena button. On the right, the form of the arena you picked.

To	Do this
Create an arena	Create Arena, fill in the form, then Create Arena again at the bottom.
Edit an arena	Click it in the list, change anything, Save.

Key	Does
W A S D	Fly the camera.
Q / E	Down / up.
Mouse	Look around. The red cross shows where a corner would go.
Left click	Add a corner.
Right click	Remove the last corner.
Z / X	Make the arena taller / shorter. It starts 25 metres tall.
Enter	Finish and return to the form.
Backspace · Esc	Leave the camera. Four corners or more are still kept; with fewer, the form says Zone creation cancelled.

lua

Config.DefaultRewards = {
    first  = { money = 5000, items = { { name = 'water', count = 5 } } },
    second = { money = 2500, items = { { name = 'water', count = 3 } } },
    third  = { money = 1000, items = {} },
}

Field	Notes
Blip Label	The name on the map legend.
Blip Sprite	The icon. Search by name, with a picture of each.
Blip Color	The colour, searchable the same way.
Blip Scale	0.2 – 1.0.
Blip Coordinates	Select, aim with your own camera and left click. The point must be inside the arena's outline, so draw the area first.

What happens	Set by
A notice: You entered the water war arena!	—
The player's weapons are put away.	`Config.RemoveWeaponsOnEnter`
A water gun with 9,999 rounds goes into their hands.	`Config.WeaponHash` · `Config.GiveAmmo`
Glowing cyan walls mark the arena's edge.	`Config.BoundaryWalls`
The battle card opens on the round in progress.	—

Part	Shows
Header	The arena's name and a LIVE badge.
Time Remaining	The countdown, kept by the server.
Your Score	Your points, as a bar measured against the leader.
Leaderboard	The top five, with your own row marked You.
Hit Feed	The last five hits in the arena: who hit whom.

When	What happens
The first player walks in	A round starts at once, with the arena's full duration.
More players walk in	They join the round already running, at zero points, and see the time left. Once the arena holds its maximum, newcomers are turned away.
The clock reaches zero	Rewards are paid and the end screen shows the result for ten seconds.
Ten seconds later	Scores go back to zero and a new round begins for everyone still inside. An empty arena simply goes quiet until the next player arrives.
Everybody walks out early	The round is cancelled. Nobody is paid.

Config.WaterFx	Default	What it does
`scale`	0.35	The jet's size. A fire truck's cannon is 1.0. The splash is drawn at twice this size.
`offset`	vec3(0, 0, 0)	Where the jet starts, relative to the muzzle.
`rotation`	vec3(0, 0, -100)	Which way it points. Change it if the jet sprays sideways.
`graceMs`	250	Keeps the jet flowing between the shots of automatic fire.
`scanInterval`	200	How often, in ms, the game looks for nearby shooters while nobody is spraying.
`asset` · `effect` · `splashEffect` · `boneName`	core · water_cannon_jet · water_cannon_spray · gun_muzzle	The particles used and the bone the jet is attached to. Leave them unless you know the particle library.

General

Setting	Default	What it does
`Config.Locale`	'en'	The language file in `locales/`, for messages and the interface.
`Config.Debug`	true	Step-by-step console output, and every arena's zone drawn in the world. Turn it off on a live server.
`Config.Path` · `Config.ImagePath`	nui://qs-waterwar/web/	Where the interface finds its pictures. Leave them as they are.

Creator

Setting	Default	What it does
`Config.CreatorCommand`	'waterwarcreator'	The command that opens the creator.
`Config.MinPointLength`	30.0	Metres around the outline before its walls turn green.

Arenas and the water gun

Setting	Default	What it does
`Config.Locale`	'en'	The language file in `locales/`, for messages and the interface.
`Config.Debug`	true	Step-by-step console output, and every arena's zone drawn in the world. Turn it off on a live server.
`Config.Path` · `Config.ImagePath`	nui://qs-waterwar/web/	Where the interface finds its pictures. Leave them as they are.

Battles

Setting	Default	What it does
`Config.ScorePerHit`	1	Points for each hit.
`Config.RemoveWeaponsOnEnter`	true	Put the player's weapons away when they walk in.
`Config.RestoreWeaponsOnExit`

Rewards and blips

Setting	Default	What it does
`Config.DefaultRewards`	5000 · 2500 · 1000	Money and items for 1st, 2nd and 3rd, copied into new arenas.
`Config.MoneyType`	'money'	The account rewards are paid into: `money`, `bank`, or on ESX.

Interface

Setting	Default	What it does
`Config.Intl`	tr-TR · TRY	How money is written on screen. See Integrations → The currency format.

Editor controls and camera

ActionControls maps each action of the drawing camera to one or more GTA control IDs, and CameraOptions sets how it moves:

lua

CameraOptions = {
    lookSpeedX = 1000.0, -- mouse sensitivity, up and down
    lookSpeedY = 1000.0, -- mouse sensitivity, left and right
    moveSpeed  = 20.0,   -- W A S D
    climbSpeed = 10.0,   -- Q / E
}

The keys used while drawing are forward, right, up, leftClick, undo_point, boundary_height, and . Change a code to move an action to another key; the on-screen hints follow.