ScriptsGameplay
Weapon Licenses preview

  • 01Theory test graded on the server. Players never see the answers
  • 02Timed shooting exam with server-side checks against impossible results
  • 03ESX, QBCore and Qbox, with ox_inventory working out of the box

Weapon licenses should be earned, and they should not be one exploit away. Players take a theory test with random questions and then pass a timed shooting exam. Every step that matters happens on the server: it picks and grades the questions, charges for each exam, times the range and grants the license.

Version 3 is a full rewrite on ox_lib. It runs on ESX, QBCore and Qbox, works with ox_inventory out of the box, and its test UI takes your server’s name and colors.

Features

  • Random questions per test from an editable bank, in English and Spanish
  • Configurable number of questions and correct answers to pass
  • Shooting exam with targets, time limit and countdown, all configurable
  • Targets swing down from the ceiling rail and fold back when hit
  • Optional practice mode with its own price and settings
  • Optional prior license required before the theory test (e.g. a medical check)
  • Brand name, title, accent color and rules link of the test UI configurable
  • Exams started, charged and timed on the server
  • Local targets, so there are no leftover props and nothing to clean up
  • Range weapon removed when the session ends or the player leaves the range
  • License names configurable to keep the ones your players already have
  • HasWeaponLicense server export for other resources
  • Open framework bridge for custom frameworks or license systems

Changelog

  1. v3.1.0
    • Targets swing down from the ceiling rail and fold back when hit
  2. v3.0.0
    • Rewritten on ox_lib, with Qbox support alongside ESX and QBCore
    • Theory test picked and graded on the server
    • Shooting exam started, charged and timed on the server
    • Local targets, ox_inventory support without patches
    • New configurable test UI, English and Spanish
    • Optional prior license, HasWeaponLicense export, version check
  3. v2.0.1
    • Security update for license granting and range cleanup

FAQ

Do I need to modify ox_inventory?

No. The range weapon uses ox_inventory's public weapon-wheel export only while the session lasts. If you edited ox_inventory for an older version, you can revert it.

Will my players keep the licenses they already have?

Yes. Set the license names in the config to the ones your server already uses and nothing changes for them.

Can I write my own questions?

Yes. Questions live in one file per language, loaded only on the server, so players can never read the answers.

I bought an older version. Do I get v3?

Yes, at no cost. Download it again from your Keymaster.

Questions before you buy?

Open a ticket on Discord: compatibility, install, what the config covers.

Ask on Discord