> For the complete documentation index, see [llms.txt](https://fetchq-store.gitbook.io/fetchq-store-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fetchq-store.gitbook.io/fetchq-store-docs/fivem-multiplayer-oil-job.md). # Fivem Multiplayer Oil Job ## 🛢️ FetchQ Oil Rig Job An immersive, high-stakes offshore oil rig contracting script for FiveM servers. Allow your players to take on massive maritime logistics jobs, utilizing tugboats and heavy-lift helicopters to transport valuable oil barrels from isolated ocean rigs to the mainland. *** ### 🌟 Overview **FetchQ Oil Rig Job** introduces dynamic, multi-step maritime missions. Players can group up and sign contracts to execute complex logistics operations ranging from tugging cargo containers across the sea, to airlifting them via a Skylift helicopter. With a built-in interactive hacking minigame, custom work uniforms, and massive payouts, this script provides a high-tier civilian/criminal group activity. *** ### ✨ Features #### 🚢 Maritime & Aviation Missions * **Two Major Contract Types:** * *Boat Mission:* Attach a tugboat to heavy port containers, navigate to a designated oil rig, breach the container, load 10 explosive oil barrels, and deliver the cargo to the drop-off point. * *Heli Mission:* Pilot a heavy-duty Skylift helicopter, attach a cargo container from the helipad, transport it to the rig, load 6 barrels, and airlift the payload to the drop-off. * **Dynamic Oil Rigs:** 9 distinct oil rig locations fully configured with unique container placements, lock positions, and target zones for high replayability. * **Interactive Tools & Animations:** Players physically use an angle grinder to cut through container locks and feature custom animations for carrying the heavy oil drum props (`prop_barrel_exp_01a`). #### 💻 Hacking & Minigames * **Multi-Phase Rig Minigame:** Accessing the oil rig's systems requires bypassing a specialized 3-phase minigame. * *Hydraulic Pressure Lock:* Balance the pressure values of three valves (A, B, C) into the safe green zone. * *Circuit Routing:* Memorize and quickly re-trace the system's control route. * *Maglock Pulse Sync:* Stop the moving marker inside the target window 3 times consecutively to unlock the system. #### 🦺 Work Uniforms * **Job Clothing:** Pre-configured immersive job outfits including *Tactical Vest* and *Ocean Worker* variants. Includes full support for both male and female ped clothing components to keep players looking the part. #### 👥 Multiplayer & Squad Play * **Squad System:** Players can form a squad with a friend (2-player max group limit by default) via the interactive Roster UI. * **Roles & Payouts:** Features a Squad Leader and Member dynamic, ensuring fair salary distribution (e.g., 50/50 split) upon contract completion. * **Massive Economy Payouts:** Highly rewarding missions designed for groups (e.g., Boat missions yielding $450k-$800k, Heli missions yielding $600k-$1.2M), making it a perfect end-game group activity. #### ⚙️ System & Administration * **Universal Framework Support:** Seamless out-of-the-box compatibility with `qb-core`, `es_extended`, `qbx_core`, or custom frameworks. * **Dynamic Target & UI Integration:** Supports `qb-target`, `ox_target`, and `interact`. Fully configurable 3D Text integration (e.g., `drawtext-qb-core` or `drawtext-ox_lib`). * **Vehicle Key & Fuel Handling:** Built-in triggers to give players vehicle keys and max fuel for their mission vehicles automatically. *** ### 🚀 Installation & Configuration #### 1. General Setup The script **does not require** any dedicated SQL database tables. Simply ensure the resource is placed in your resources folder and started in your `server.cfg`. #### 2. Item Configuration Ensure that the necessary interaction items (if you choose to lock the job behind specific items) and target resources are actively running. The script utilizes standard GTA V props (`tr_prop_tr_grinder_01a`, `prop_barrel_exp_01a`) so no custom item images are strictly necessary unless you add them to your framework's inventory. #### 3. Framework Configuration (`shared/config.lua`) The script is highly customizable. Open `shared/config.lua` to edit: * **Framework & UI:** Set `Config.FrameworkSettings.CoreName` to your active framework and adjust Target/DrawText settings. * **Contracts:** Modify the payouts (reward), barrel requirements (`barrelsToLoad`), and step translations in `Config.Contracts`. * **Rigs & Locations:** Edit the coordinates, blips, and drop-off radiuses for all 9 oil rigs in `Config.OilRigs`. * **Clothing:** Change the drawable and texture IDs for the male and female work uniforms inside `Config.Clothing`. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://fetchq-store.gitbook.io/fetchq-store-docs/fivem-multiplayer-oil-job.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.