Diving Script

Diving Script

Explore the depths of the ocean with the Sosomods Diving Script, a comprehensive underwater diving system for your FiveM server. This script features oxygen management, dynamic underwater props, a user-friendly NUI equipment shop, and secure server-side weighted loot drops, providing an engaging and rewarding diving experience for your players.

Features

• Oxygen Management: Draggable floating HUD with alerts at critical levels (75/50/25/10%). Automatic server metadata save and bottle recharge at the NPC vendor with full-tank check.
• 5 Diving Zones: Includes Deep water, Sandy bottom, Airplane wreck, Hidden bay, and Deep wreck. Each zone features configurable radius, loot table, cooldown, and props.
• Server-Side Weighted Loot: 100% server-side random draw with relative weights, ensuring fair and secure loot distribution. Item whitelisting validated server-side, preventing client manipulation.
• Dynamic Underwater Props: Props spawn only when a zone mission is active and are immediately removed upon cancellation or mission end, minimizing impact on other players.
• Full NUI Shop: Shop includes tabs for equipment, oxygen, selling, and missions. Dynamically calculates total inventory value and displays zone distances in real time.
• Full Server Security: All NetEvents are validated server-side, including equipment, position, ownership, and money transactions. Includes anti-spam rate-limiting and server-routed mission starts.
• Dual-Mode Interaction: Configurable interaction mode with either ox_target (aim + menu) or helpnotif (E key), providing identical behavior in both modes.

Included Zones

• Deep water (-175m)
• Sandy bottom (-54m)
• Airplane wreck (-24m)
• Hidden bay (-7m)
• Deep wreck (-33m)

Configuration

The script is fully configurable via the config.lua file. Adjust language, interaction mode, oxygen bottle duration, refill price, vendor NPC details, sellable items, diving zones, and notification system to suit your server's needs.

Installation

1. Ensure you have the required dependencies installed: es_extended, ox_lib, ox_inventory, and ox_target.
2. Place the diving resource folder into your server's resources directory.
3. Add ensure diving to your server.cfg file.
4. Configure the config.lua file to your desired settings.
5. Restart your FiveM server.