AWS Dartboard

Placeable dartboards with lobbies, X01 scoring, wagers and configurable interaction and presentation.

Installation

Requirements

• ox_lib and oxmysql
• One supported core: QBCore, Qbox or ESX
• qb-target or ox_target when Config.UseTarget is enabled

Startup order

This example selects one framework and target. Use the resources matching your configuration and start dependencies first.

ensure ox_lib
ensure oxmysql
ensure qb-core
ensure qb-target
ensure aws-dartboard

Setup steps

1. The dartboards database is initialized in editable/sv_utils.lua. Permit table creation and verify it after first startup; there is no separate SQL file in this package.
2. Review editable/sv_config.lua: /placedartboard, Config.AllowedCitizenIds and command permissions control placement.
3. The shipped solo test option is enabled. Set Config.AllowSoloTest to false in both client/server configuration for public play if you do not want test opponents.

Gameplay and usage

1. Use /placedartboard with a permitted account to place a board, then interact through the chosen target.
2. Create a lobby, select rules, approve a second player and complete a match before enabling public wagers.

Configuration

• editable/sh_config.lua selects Config.Framework and Config.Locale.
• editable/sh_gamemodes.lua defines 301/501/701 modes, darts per turn, round limits and throw distances.
• editable/cl_config.lua sets target selection, board style, HUD, camera, lighting and sound.
• editable/sh_wagers.lua defines available wagers; editable/sv_config.lua contains log and placement settings.

Exports and integrations

No public callable export is declared with exports() in these source files. Use the documented commands or configuration; internal network events are not a trusted integration API.

Troubleshooting

• If placement is denied, check ACE/framework staff access and identifier allowlists.

• If boards disappear after restart, inspect the dartboards table and oxmysql logs.

• Include the package version, framework and exact server/F8 error when requesting support. Remove private tokens and player data.

Package reference

Database files

No standalone SQL file is included. Check the installation steps above for tables created by server code.

Configuration reference

Frequently asked questions

Does this need Keymaster or an escrow key?

The Lua sources in this delivery package were readable in the static audit. No /assetpacks requirement is added by this package. Required framework, inventory and map resources still need to be installed separately.

Can I change the folder or database table names?

Keep the supplied folder names. Historical event, SQL and KVP identifiers are retained to protect existing integrations and saved data. Renaming a table or event requires a separate migration.

Why is an interface or item missing?

Check the startup order, selected framework/target adapter, inventory item definitions and the server/F8 console. The package does not install an entire framework or inventory for you.

Has this been tested on my server?

ZIP integrity, source readability, script syntax and manifest references were checked locally. Multiplayer gameplay, your framework version and integrations require a FiveM server acceptance test before a public release.