📝 Overview
Give your RedM civilians something meaningful to do with the Codex Civilian Oil Job System.
This script adds a fully interactive, non-whitelisted job where players can collect oil or repair oil machinery for rewards no factions or complex setup required. Just walk up, clock in, and get to work.
Perfect for progression-based economies and servers that want immersive, hands-on jobs instead of simple “press E and wait” tasks.
🔧 Core Job Types
⛽ Collect Oil from Fields
Players are assigned to various oil field locations across the map.
Each site requires manual interaction and immersion-friendly animations.
Tasks feel like real labor rather than a single progress bar.
On completion, players receive configurable rewards (money/items/XP via hooks).
🛠 Repair Oil Machines
Players are sent to malfunctioning machinery to perform multi-step repairs.
Includes:
Repair progress bar
Visual markers
Appropriate animations
Feels like a proper maintenance route instead of a one-tap interaction.
🧰 Immersive & Functional Design
NPC-Driven Job Hub
Static job NPC at your configured oil company HQ.
Players hold [G] (or your chosen key) to open the job menu.
Clean, RP-friendly flow with no clunky menus.
Blip Integration
Dynamic map blips for:
Oil fields
Repair locations
Custom icons and auto-removal on completion for a tidy map.
Prompt-Based Interaction (CodexPromptAPI)
Uses CodexPromptAPI for all interactions.
Players hold a key at each step, enhancing immersion and preventing accidental clicks.
Progress Tracking & Concurrency
Tracks current job step to prevent duplication/abuse.
Supports multiple players working at once without conflicts.
Performance Aware
Smart sleeping logic to keep resource usage low.
Proper cleanup of NPCs, blips and entities when the resource stops.
💡 Server-Side Hooks & Extensibility
OnPlayerFinish Hook
Triggered when a player completes a full route.
Easily add:
Custom rewards
XP systems
Items (oil barrels, company vouchers, etc.)
Clean Structure for Expansion
Clear server/client separation with well-organized data tables.
Add more:
Locations
Animations
Job variations (night shift, hazardous zones, etc.) with minimal effort.
🎯 Ideal For
Civilian life & economy-focused RP servers.
Progression systems where working jobs actually matters.
Servers looking to replace “one-button jobs” with detailed, hands-on experiences.
Make hard work feel meaningful – turn black gold into real gameplay.
📦 Dependencies
codex_corecodex-notificationsoxlib
All prompts, notifications, and contextual interactions are handled through codex-notifications, CodexPromptAPI, and oxlib.
🧱 Framework Support
Through Codex Core, the script supports:
RSG
VORP
TPZ-CORE
Vide Preview : [Coming Soon]
Docs : https://codexstudios.gitbook.io/codexstudios-store

