esx_dmvschool

esx_dmvschool is the driving school for ESX Legacy. Players first pass a multiple-choice theory test (dmv license) and then take practical road tests for cars (drive), motorcycles (drive_bike) and trucks (drive_truck). Licenses are stored through esx_license, so police and vehicle scripts can check them.

OverviewCopy Anchor Link

In-game flowCopy Anchor Link

1. Go to the DMV marker (blip sprite 408) and press E.
2. Pay for the theory test. Answer 10 questions; 5 correct answers pass and grant dmv.
3. With dmv, the menu offers the road tests you do not own yet. The test vehicle spawns at VehicleSpawnPoint.
4. Drive through all checkpoints. Speeding and vehicle damage count as errors. Speed limits switch between residence, town and freeway at certain checkpoints.
5. At the last checkpoint the vehicle is deleted and, if you passed, the license is granted.

InstallationCopy Anchor Link

INSERT INTO `licenses` (`type`, `label`) VALUES
	('dmv', 'Driving Permit'),
	('drive', 'Drivers License'),
	('drive_bike', 'Motorcycle License'),
	('drive_truck', 'Commercial Drivers License');

ensure esx_license
ensure esx_dmvschool

ConfigurationCopy Anchor Link

Config.Prices = {
	dmv         = 500,
	drive       = 2500,
	drive_bike  = 3000,
	drive_truck = 5000
}

Config.VehicleModels = {
	drive       = 'blista',
	drive_bike  = 'sanchez',
	drive_truck = 'mule3'
}

Config.SpeedLimits = {
	residence = 50,
	town      = 80,
	freeway   = 120
}

CheckpointsCopy Anchor Link

Each checkpoint runs its Action when the player reaches it. The function receives the player ped, the test vehicle and a setter for the current speed zone:

{
	Pos = { x = -453.790, y = -1444.726, z = 27.665 },
	Action = function(playerPed, vehicle, setCurrentZoneType)
		setCurrentZoneType('freeway')
		DrawMissionText(TranslateCap('hway_time', Config.SpeedLimits['freeway']), 5000)
	end
},

The last checkpoint must stay near the DMV: the server only grants road-test licenses when the player is within 35 m of the last checkpoint, and its default action deletes the test vehicle.

Server callbacks and eventsCopy Anchor Link

esx_dmvschool:canYouPay (callback)Copy Anchor Link

Called with a test type. The server checks that the type is valid, the player is within 20 m of the DMV marker, does not own that license yet and has enough cash. It then removes the money and records a paid test that is valid for 15 minutes.

esx_dmvschool:addLicense (net event)Copy Anchor Link

TriggerServerEvent('esx_dmvschool:addLicense', type)

esx_dmvschool:loadLicenses (client event)Copy Anchor Link

Sent by the server with the player's license list on esx:playerLoaded and after a license is added. The client uses it to build the menu.

Integration tipsCopy Anchor Link

• Check licenses from other resources with esx_license:

TriggerEvent('esx_license:checkLicense', source, 'drive', function(hasLicense)
    if not hasLicense then
        TriggerClientEvent('esx:showNotification', source, 'You need a drivers license.')
    end
end)

• Police can revoke drive* licenses through esx_policejob, which uses esx_license as well.
• The test vehicle gets 100 fuel and the _FUEL_LEVEL decor, so legacy fuel scripts do not drain it.

Common issuesCopy Anchor Link

• Prices or menu text show the wrong language: set setr esx:locale "en" before resources start. The license labels come from the SQL catalog in the same locale.
• Paid but no license: the paid test expired (15 minutes) or you were too far from the last checkpoint when it finished.
• Speeding errors on the first meters: if you use mph limits, also change Config.SpeedMultiplier to 2.236936.

RelatedCopy Anchor Link

• esx_license
• esx_policejob
• esx_boat
• Server events

Frequently asked questions