Configurations

All primary configuration is in **`public/shared/config.lua`**. Restart the resource after changing values.

UI theme tokens (optional) are in public/shared/themes.json — see Theme below.

---

General

Option	Type	Default	Description
Debug	boolean	false	Extra logs in F8 and server console. Use false on production.
Locale	string	"en"	Language file under public/shared/locales/ (e.g. en, pt).
Theme	string	"default"	UI palette id: "default", "cdev", or "custom" (see public/shared/themes.json).

---

Bridge

Option	Type	Options	Description
Bridge.Framework	string	"auto" | "qb-core" | "qbx_core" | "es_extended"	Framework. "auto" detects a running core.
Bridge.Inventory	string	"auto" | "ox_inventory" | "qb-inventory" | "qs-inventory"	Inventory integration.
Bridge.Interaction	string	"drawtext" | "target"	How players open the lane UI near a placed board.
Bridge.Target	string	"auto" | "ox_target" | "qb-target" | "custom"	Target resource when Interaction = "target". "custom" → edit public/bridge/target/client.lua.
Bridge.Notify	string	"auto" | "ox_lib" | "qbcore" | "esx" | "native"	Notification backend.

---

Interaction options

DrawText (Bridge.Interaction = "drawtext")

Option	Type	Default	Description
InteractionOptions.DrawText.maxDistance	number	2.8	Max distance (m) for 3D hints.
InteractionOptions.DrawText.keyDisplay	string	"E"	Shown in the hint.
InteractionOptions.DrawText.controlId	number	38	Control id (38 = E).
InteractionOptions.DrawText.label	string | nil	nil	Override text; nil uses locale axe.interact_lane.
InteractionOptions.DrawText.pickupKeyDisplay	string	"G"	Pickup hint key label.
InteractionOptions.DrawText.pickupControlId	number	47	Pickup control (47 = G).

Target (Bridge.Interaction = "target")

Option	Type	Default	Description
InteractionOptions.Target.maxDistance	number	2.8	Range for target options.
InteractionOptions.Target.label	string	"Axe Throwing"	Main target label.
InteractionOptions.Target.icon	string	"fas fa-bullseye"	Font Awesome class (ox_target).
InteractionOptions.Target.pickupLabel	string	"Pick up target"	Pickup option label.
InteractionOptions.Target.pickupIcon	string	"fas fa-box"	Pickup icon.
InteractionOptions.Target.TargetSyncRadius	number	80.0	Bubble (m) for syncing nearby boards.
InteractionOptions.Target.TargetSyncPullDebounceMs	number	4500	Min interval between server sync checks.
InteractionOptions.Target.TargetRescanMs	number	8000	World rescan interval for target mode.

---

Items

Option	Type	Default	Description
Item.enabled	boolean	true	If false, inventory item exports / ESX-QB registration are skipped.
Item.Target.name	string	"axe_throwing_target"	Inventory item name for placing the board.
Item.Target.label	string	"Axe Throwing Target"	Display label (also for notifications where used).
Item.Hatchet.name	string	"axe_throwing_hatchet"	Hatchet item name.
Item.Hatchet.label	string	"Throwing Hatchet"	Display label.
Item.Hatchet.requiredToThrow	boolean	true	If true, players need the hatchet item to register throws (economy servers).

---

Tournament (lobby rules)

Option	Type	Default	Description
Tournament.MaxPlayers	number	5	Max competitors in a tournament.
Tournament.MinPlayersToStart	number	2	Minimum players to allow start (unless rules say otherwise).
Tournament.RequireFullLobby	boolean	false	If true, host cannot start until lobby is full.
Tournament.PaidPlaces	number	3	How many ranks split the prize pool in UI.
Tournament.MinPrizePool	number	100	Minimum prize pool to create (use 0 to disable floor).
Tournament.TieBreakRevealMs	number	8400	Duration of tie-break reveal animation in end UI.
Tournament.DivisionJoinRules.Enabled	boolean	true	Enforce division join limits by rating points.
Tournament.DivisionJoinRules.AmateurMaxPoints	number	1999	Amateur division max rating points.
Tournament.DivisionJoinRules.ProMinPoints	number	2000	Pro division minimum rating points.

---

Props & streaming

Option	Description
Props.TargetBoard.model	Board archetype (must match streamed .ydr / .ytyp). Default cdev_axetarget.
Props.Axe	Hatchet model attach offsets, stick tuning, TTL — change carefully if you swap .ydr.

Addon props live under stream/props/; animations under stream/anim/*.ycd. Keep fxmanifest.lua data_file / files entries in sync when adding assets.

---

Placement

Option	Default	Description
Placement.raycastDistance	20.0	Max placement ray length.
Placement.maxDistanceFromPlayer	6.0	Max distance from player to hit surface.
Placement.surfaceOffsetM	0.045	Push board along wall normal.
Placement.Keybinds.*	—	Controls for place / cancel / rotate / fine rotate (control IDs).

---

Fault line (ground)

FaultLineDisplay controls RGBA colors, half-width, stand zone, max draw distance, and whether the line follows tournament fault rules only.

---

Match controls

MatchControls — killshot toggle, begin throw, cancel practice, forfeit, spectator mouse toggle, practice aim difficulty page keys. Values are FiveM control IDs.

---

Strength meter & aim

Block	Description
StrengthMeter	Oscillation speed, confirm key (Space default), movement lock, aim dot smoothing.
AimDifficulty.Presets	fixed / easy / medium / ultra drift for practice and tournament rule presets.

---

Throw animation

ThrowAnimation — anim dict/name (custom .ycd), blend, flag, syncAxeReleaseMs delay before spawning the flying axe.

---

Flight (visual)

Flight — duration, spins, arc, miss distance, camera vs ped rotation, model spin offsets.

---

Realistic mode tuning

ThrowRealism applies when match rules use throwMode == "realistic" (ideal power vs distance, green window, short throw, bounce).

---

Rating (ELO)

Option	Default	Description
Rating.DefaultELO	1000	Starting rating.
Rating.KFactor	32	Base K for rating updates.
Rating.KFactorByPlacement	table	Multipliers for 1st / 2nd / 3rd / others.
Rating.MinRating	100	Floor.
Rating.MaxRating	3000	Ceiling.
Rating.Badges	table	{ min, badge, label, color } tiers for UI (hex colors).

---

Themes (public/shared/themes.json)

Theme id	Purpose
default	Baseline colors.
cdev	CDEV / Discord-style dark + blue accents.
custom	Same keys as default; values can be short documentation strings until you replace them with real CSS colors — non-CSS text falls back to default at runtime.

Restart the resource after editing JSON.

---