# Multiplayer Diving Job

## Overview

**TW Diving Job** is an immersive multiplayer underwater diving system where players explore the ocean depths. Collect corals, clean the sea, loot treasure suitcases, and discover valuable items beneath the waves.

{% hint style="success" %}
**Multiplayer Support:** Work together with other players in cooperative underwater exploration!
{% endhint %}

***

## Features

### Core Features

* **Multiplayer Lobby System** - Work with other players in cooperative gameplay
* **Scuba Equipment System** - Purchase and use scuba gear, masks, and oxygen tanks
* **Coral Collection** - Harvest various coral species
* **Sea Cleaning** - Remove debris from the ocean
* **Treasure Hunting** - Loot suitcases with valuable items
* **Box Looting** - Discover treasure boxes with rare items
* **Boat & Anchor System** - Use boats with anchor mechanics

### Additional Features

* **Level & XP System** - Progress through levels with increasing rewards
* **4 Diving Missions** - Progressive difficulty in different ocean zones
* **Oxygen Tank System** - 3 tank levels with different capacities
* **Lift Bag Mechanic** - Raise heavy treasure boxes from the depths
* **Random Treasure System** - Probability-based valuable item drops
* **Knife Mechanic** - Cut open suitcases to access contents
* **Tutorial System** - In-game video tutorials for new players
* **Multi-language Support** - 7 languages included (EN, TR, DE, FR, PT, RU, AR)

***

## How It Works

### Step 1: Start a Lobby

Go to the diving job NPC and open the job menu. Create a lobby and invite other players (optional).

### Step 2: Get Equipment

Purchase diving equipment from the shop:

* **Scuba Gear/Mask** - $700
* **Oxygen Tanks** - Level 1: $500, Level 2: $1,000, Level 3: $1,500
* **Lift Bag** - $200
* **Knife** - $500

### Step 3: Dive & Complete Tasks

Take a boat to the dive site and complete missions:

1. **Coral Collection** - Harvest corals (15-50 per mission)
2. **Sea Cleaning** - Remove debris (15-50 per mission)
3. **Suitcase Looting** - Find and open suitcases (10-20 per mission)
4. **Box Looting** - Raise treasure boxes with lift bags

### Step 4: Collect Rewards

Sell collected items and complete missions for money and XP.

***

## Requirements

| Resource  | Required | Notes                                               |
| --------- | -------- | --------------------------------------------------- |
| Framework | Yes      | QBCore, QBox, ESX, vRP, or Standalone               |
| Database  | Yes      | oxmysql (recommended), mysql-async, or ghmattimysql |
| PolyZone  | Yes      | Required for all Tworst Scripts                     |

### Optional Dependencies

| Resource               | Purpose                           |
| ---------------------- | --------------------------------- |
| qb-target / ox\_target | Target interaction system         |
| Vehicle Keys Script    | Automatic vehicle key integration |
| Clothing Script        | Job uniform system                |

***

## Supported Systems

### Frameworks

| Framework  | Config Value       |
| ---------- | ------------------ |
| QBCore     | `'qb'`             |
| QBox       | `'qb'`             |
| ESX Legacy | `'esx'`            |
| vRP / vRP2 | `'vrp'` / `'vrp2'` |
| Standalone | `'standalone'`     |

### Inventory Systems

| System           | Config Value      |
| ---------------- | ----------------- |
| QBCore Inventory | `'qb_inventory'`  |
| ESX Inventory    | `'esx_inventory'` |
| ox\_inventory    | `'ox_inventory'`  |
| qs-inventory     | `'qs_inventory'`  |

### Vehicle Key Systems (Auto-detected)

* qb-vehiclekeys
* qbx-vehiclekeys
* qs-vehiclekeys
* wasabi-carlock
* cd\_garage
* Renewed-Vehiclekeys

### Fuel Systems (Auto-detected)

* LegacyFuel
* ox\_fuel
* cdn-fuel
* ps-fuel
* x-fuel

***

## Commands

| Command           | Description              |
| ----------------- | ------------------------ |
| `/anchor`         | Drop/pick up boat anchor |
| `/jobresetdiving` | Reset your current job   |
| `/deletegear`     | Remove diving equipment  |

***

## Equipment & Prices

### Scuba Equipment

| Item            | Price |
| --------------- | ----- |
| Scuba Gear/Mask | $700  |
| Lift Bag        | $200  |
| Knife           | $500  |

### Oxygen Tanks

| Level   | Capacity  | Price  |
| ------- | --------- | ------ |
| Level 1 | 3 seconds | $500   |
| Level 2 | 5 seconds | $1,000 |
| Level 3 | 7 seconds | $1,500 |

***

## Harvestable Items

| Item               | Drop Rate | Value       |
| ------------------ | --------- | ----------- |
| Dendrogyra Coral   | 70%       | $1,500      |
| Antipatharia Coral | 20%       | $1,500      |
| Rolex Watch        | Variable  | $750-$2,500 |
| Diamond Ring       | 20%       | $2,000      |
| Gold Bar           | 10-20%    | $2,500      |

***

## Missions & Rewards

| Mission   | Level | Location      | Money   | XP    |
| --------- | ----- | ------------- | ------- | ----- |
| Mission 1 | 0     | Tworst Island | $10,000 | 1,000 |
| Mission 2 | 2     | Tworst Island | $20,000 | 2,000 |
| Mission 3 | 3     | Deep Ocean    | $30,000 | 3,000 |
| Mission 4 | 4     | Deep Trench   | $40,000 | 4,000 |

***

## Quick Links

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Step-by-step installation guide</td><td><a href="diving-job/installation">installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Complete configuration reference</td><td><a href="diving-job/configuration">configuration</a></td></tr><tr><td><strong>Changelog</strong></td><td>Version history and updates</td><td><a href="diving-job/changelog">changelog</a></td></tr></tbody></table>

***

## Purchase

{% hint style="info" %}
Purchase Multiplayer Diving Job from our [Tebex Store](https://tworst.tebex.io) or [CFX Store](https://tworst.com).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tworst.com/scripts/diving-job.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
