Diving - ESX

Description

PK Diving is a fully configurable and immersive diving script for FiveM, allowing players to buy diving gear, manage oxygen tanks, explore underwater dive sites, search crates, complete diving missions and discover legal or illegal underwater loot.

This script supports: ESX, QBCore and QBox

Diving Gear System

Players can buy and use different diving suits through a configurable gear shop.

13 different diving suit items
Oxygen tank item
Custom equip animations
Automatic outfit saving and restoring
Configurable shop NPC and prices

Oxygen Tank System

Players need oxygen tanks to dive safely.

Each tank has its own oxygen percentage and metadata, meaning tanks keep their remaining oxygen instead of resetting.

Includes:

Oxygen usage over time
Configurable max dive duration
Individual tank fill levels
Tank swapping on land only
Tank refill station
Refill one tank or all tanks
Optional refill prices
Oxygen depletion warnings

Custom Diving HUD

PK Diving includes its own custom underwater HUD.

The HUD shows:

Oxygen percentage
Current depth
Low oxygen warning
Warning beep at critical oxygen levels
Custom diving notifications

Diving Effects

Players get a more immersive underwater experience with:

Scuba movement
Diving tank prop on the player
Toggleable diving light
Configurable light key
Enhanced underwater headlight
Optional breathing sound while diving

Dive Sites & Crate Searching

Server owners can create multiple underwater dive sites where players can search crates for loot.

Each dive site supports:

Configurable location
Configurable radius
Active crate amount
Random crate spawning
Multiple crate models
Loot tables with item chances
Min/max rewards per item
Automatic replacement crates after searching

Current included dive sites:

Alamo Sea Plane Wreck
Humane Labs Deep Site
Elysian Salvage Zone
Illegal Diving Site

Illegal Diving System

PK Diving also includes illegal salvage gameplay.

Illegal sites can require special tools, such as a grinder, before crates can be opened.

Includes:

Hidden illegal dive sites
Required tool item
Tool durability / max uses
Separate illegal loot tables
Rare high-value loot
Configurable max loot items per crate

** **

Diving Missions

Players can talk to a diving contractor NPC and accept randomized underwater recovery missions.

Mission system includes:

Mission NPC
Random mission offers
Accept / decline system
Personal decline cooldown
Random underwater search zones
Mission item spawning
Search area blips
Return-to-NPC delivery
Configurable money rewards
Persistent active missions

Persistent Mission System

Active missions and cooldowns are saved, so players cannot abuse reconnecting to reset mission progress.

Includes:

Personal active missions
Personal decline cooldowns
Mission state saving
Mission item validation
Delivery validation

Framework & Target Support

PK Diving supports automatic framework and target detection.

Target support:

ox_target
qb-target
No target fallback

** **

Multi-language Support

Includes locale files for:

English
Dutch
German
Swedish