esx_boat

esx_boat lets players buy boats at a marina, store them in boat garages along the coast and buy a boat license through esx_license. Purchased boats are saved in owned_vehicles with type = 'boat', so they are separate from cars handled by esx_garage.

OverviewCopy Anchor Link

In-game flowCopy Anchor Link

1. At the boat shop marker press E. If the license is required and missing, a menu offers the license for Config.LicensePrice.
2. Pick a boat, preview it on the water and choose Buy. Money is taken from the cash account.
3. At a garage marker press E to take out a stored boat at the garage's SpawnPoint.
4. Drive into the large red marker (StorePos) as the driver and press E to store the boat. You are teleported to StoreTP.

InstallationCopy Anchor Link

INSERT INTO `licenses` (`type`, `label`) VALUES
	('boat', 'Boat License');

ensure esx_vehicleshop
ensure esx_license
ensure esx_boat

ConfigurationCopy Anchor Link

All keys live in config.lua.

Each garage entry has four positions:

Default boats and prices:

Config.Vehicles = {
    { model = 'seashark', label = 'Seashark (Random Color)', price = 7500 },
    -- optional props are applied in the preview and saved on purchase
    { model = 'speeder', label = 'Speeder (Black)', price = 90000, props = { color1 = 0, color2 = 0 } },
}

ExportsCopy Anchor Link

getGaragesCopy Anchor Link

Shared export defined in config.lua. Returns the Config.Zones.Garages table, for example to show boat garages on a phone map.

local garages = exports['esx_boat']:getGarages()

for i, garage in ipairs(garages) do
    print(i, garage.GaragePos)
end

Server callbacks and eventsCopy Anchor Link

These are triggered by the esx_boat client. They are listed so you can audit them or call them from your own UI. All are validated on the server.

Integration tipsCopy Anchor Link

• Other garage scripts can read boats with SELECT * FROM owned_vehicles WHERE type = 'boat'.
• The client still calls exports['esx_vehicleshop']:GeneratePlate() before buying, which is why esx_vehicleshop must be running even though the server replaces the plate.
• Blips: garages use sprite 356, the shop uses sprite 427, both color 3.

Common issuesCopy Anchor Link

• "Unknown model" in the garage: the boat's model is no longer in Config.Vehicles. Keep old entries or change the label lookup.
• Cannot store the boat: you must be the driver and inside the red StorePos marker. The server also requires the boat with your plate to be within 20 m.
• Shop does not open, license menu appears every time: esx_license is not started or the boat row is missing in licenses.
• Resource fails at start: esx_vehicleshop is a hard dependency in fxmanifest.lua. Start it before esx_boat.

RelatedCopy Anchor Link

• esx_vehicleshop
• esx_garage
• esx_license
• Database schema

Frequently asked questions