Commands#

Darts registers two everyday commands and four calibration tools. All of them are typed in the in-game chat.

Command	Who	Description
`/dartscreator`	Creator permission	Opens the Dartboard Creator: place, edit, price, delete and teleport to boards.
`/dartsresign`	Anyone in a game	Resigns the current game. In a duel the opponent wins the game and the pot. The same as `Backspace` and Confirm.
`/dartsdebug`	Creator permission, debug on	Calibrates the rings on the nearest board: the face, the bullseye, the size and the rotation.
`/dartsoche`	Creator permission, debug on	Calibrates the throwing line and the throwing camera.
`/dartsdart`	Creator permission, debug on	Calibrates the dart held in front of the camera and the dart stuck in the board.
`/dartshand`	Creator permission, debug on	Calibrates the dart other players see in the thrower's hand, on a sample NPC.

The four calibration tools exist only while Config.Debug = true — with it off they are not registered at all. They work on the board nearest to you within 15 m, close when you type the same command again or press Backspace, and print their values to the F8 console on the way out. How to use them together is in Usage.

Controls#

At a board#

Key	Does
`E`	At a free board, within 3 m: opens the menu with Play solo and Player vs Player. The key is `Config.Keys.interact`.

During your throw#

Key	Does
`Mouse`	Aim. The aim stays within a set distance of the bullseye.
`Left mouse` — hold	Charge the power bar. It fills and empties over and over.
`Left mouse` — release	Throw.
`Backspace`	Leave the game. Asks first; confirming resigns. The key is `Config.Keys.cancel`.
`N` · `T` · `Esc`	Push-to-talk, the chat and the pause menu still work. Every other control is locked while you throw.

Between throws#

Key	Does
`E`	Right in front of the board after your last dart: collect your darts. The prompt shows from 5 m; the key works from about 2.4 m.
`Backspace`	Leave the game, as above.

Placing a board#

Key	Does
`Mouse`	Aim at a wall or the floor, up to 50 m away.
`Left click` / `E`	Confirm.
`Z` / `X`	Rotate, while held.
`Q`	Turn by 90°.
`Mouse wheel`	Raise or lower in 5 cm steps.
`Backspace`	Cancel.

Calibration tools#

These keys are the same in all four tools. Values change while a key is held; the mouse wheel moves one step per notch.

Key	Does
`Shift` — hold	Fine steps.
`Tab`	Switch what you are editing. Not used by `/dartsdebug`.
`Enter`	Print the values in F8, ready to paste into `config/config.lua`.
`Backspace`	Close the tool. The values are printed in F8 on the way out.

/dartsdebug — the rings

The rings the server scores against are drawn over the nearest board — bull, outer bull, treble, double and the board's edge, each in its own colour — with two white lines bounding the 20. Move them until they sit exactly on the rings printed on the board.

Key	Changes
`↑ ↓`	The bullseye up and down — `bullOffsetZ`
`← →`	The bullseye sideways — `bullOffsetX`
`Mouse wheel`	How far the face sits from the wall — `faceOffset`
`Q` / `E`	Shrink or grow every ring — `radiusScale`
`Z` / `X`	Rotate the sectors so the 20 is at the top — `rotationDeg`

/dartsoche — the line and the camera

You are put on the throwing line, frozen, looking through the throwing camera with a dart where it will float. A blue marker shows where you stand, a yellow line runs to the bullseye, and a green one shows which way the board faces. Tab switches between PED and CAMERA. If something blocks the line, the panel warns how long it will really be in a game.

Key	PED	CAMERA
`↑ ↓`	Distance from the board — `Oche.distance`	Behind or in front of you — `Camera.back`
`← →`	Sideways — `Oche.side`	Over which shoulder — `Camera.side`
`Z` / `X`	Turn the player — `Oche.yawFix`	Look higher or lower — `Camera.lookOffsetZ`
`Mouse wheel`	—	Height — `Camera.height`
`Q` / `E`	—	Field of view — `Camera.fov`

/dartsdart — the darts

Two darts appear: one floating in front of the throwing camera, as you hold it, and one stuck in the bullseye. Tab switches between them.

Key	Floating	Stuck
`Z` / `X`	Yaw — `yawFix`	Yaw — `stickYawFix`
`Q` / `E`	Pitch — `pitchFix`	Tilt — `stickPitch`
`↑ ↓`	Height — `holdUp`	How far it pokes out — `stickOut`
`← →`	Sideways — `holdRight`	—
`Mouse wheel`	Distance from the camera — `Throw.holdDistance`	Roll — `stickRoll`

/dartshand — the dart in the hand

A sample NPC stands on the throwing line in the throwing pose, a dart in its right hand — exactly what other players see while you aim. Tab switches between POSITION and ROTATION.

Key	POSITION	ROTATION
`← →`	`x`	`rx`
`↑ ↓`	`y`	`ry`
`Mouse wheel`	`z`	`rz`

In both modes Z / X slide the dart along itself, deeper into or further out of the hand, and A / D orbit the camera around the NPC.

For Developers#

Darts has no exports. Everything another resource needs comes from a replicated state bag and from the bridge files.

Is this player playing darts?#

While a player is in a game, their ped carries qdarts_playing = true. It is replicated, so the server and every client can read it — useful to keep a phone call, a robbery, an emote menu or an arrest from interrupting a game.

lua

-- server
local ped = GetPlayerPed(source)
if Entity(ped).state.qdarts_playing then
    return -- busy playing darts
end

-- client
if Entity(PlayerPedId()).state.qdarts_playing then
    return
end

Darts reads it too: a player whose ped carries it cannot start another game or be challenged.

The bridge functions#

Function	Side	Decides
`CanAfford` · `RemoveMoney` · `AddMoney`	Server	Entry fees, stakes and payouts. Overridable from the config with `Config.CanAfford`, `Config.RemoveMoney` and `Config.AddMoney`.
`HasPermission`	Server	Who may use the creator and the calibration tools.
`GetCharacterName`	Server	The name on the scoreboard, in the opponent list and on a challenge.
`Notification` · `ToggleGameHud` · `DrawText3D`	Client	Messages, hiding the HUD during a game, and the board prompts.

Examples for each are in Integrations.