📦 Advanced Delivery Job | ESX & QBCore | Standalone

🚚 The Most Immersive Delivery Experience for FiveM

Transform your server's economy with a fully-featured, premium delivery job system. Built from the ground up with performance, security, and player engagement in mind.

---

🎥 Preview

(Buraya YouTube veya Streamable linki koyacaksın)

---

✨ Features

🎮 Core Gameplay

• Immersive Box Carrying System — Players physically pick up packages from the vehicle trunk, carry them by hand with full walk/run/idle animations, and drop them at delivery points
• Vehicle Trunk Interaction — Trunk opens and closes with realistic animations
• Dynamic Delivery Routes — 10 pre-configured delivery locations across Los Santos, randomly assigned each run
• Vehicle Return System — After completing all deliveries, players must return the vehicle to HQ to finish the shift
• Anti-Exploit Protection — 3-layer server-side security (active worker validation, cooldown timer, pay/xp value verification)

📊 Progression System

• XP & Level System — 5 unique ranks from Rookie Courier to Master Cargo
• Level-Based Pay Bonuses — Higher levels earn up to 50% more per delivery
• Persistent Database Storage — XP and delivery stats saved permanently, survives server restarts
• Real-Time XP Bar — GTA 5 styled thin progress bar with smooth animations

⏱️ Dynamic Challenge Systems

• Time Limit System — Configurable countdown timer per delivery (default: 5 minutes)
• Speed Bonus — Deliver under 2 minutes for an extra 15% pay bonus
• Vehicle Damage System — Damaged vehicle = 25% pay penalty. Too much damage = job cancelled
• Damage Threshold — Fully configurable damage levels for penalty and total failure

💰 Economy & Rental

• Vehicle Rental System — Players pay a rental fee to start (configurable)
• Deposit Refund — Rental deposit returned upon successful job completion
• Balanced Payouts — Each delivery point has unique pay and XP values

🔑 Universal Key System

• Supports ALL popular key scripts out of the box:
  • qb-vehiclekeys (QBCore Default)
  • Renewed-Vehiclekeys
  • wasabi_carlock
  • qs-vehiclekeys (Quasar)
  • jaksam-vehicles
  • cd_garage (Codesign)
  • okokGarage
  • esx_vehiclelock
• Just set your key script name in config — no code editing required
• Built-in vehicle protection loop — doors always unlocked, engine always running, no hotwire issues

🖥️ Premium UI (GTA 5 Aesthetic)

• Full Management Panel with tabbed navigation:
  • 📋 Main Menu — Job info, rental price, start button
  • 📊 Statistics — Current level, total deliveries, XP progress
  • 🏆 Leaderboard — Top 10 couriers with character names (not license IDs)
  • 📦 Missions — Daily mission cards with rewards
  • 🗺️ Route Info — All delivery point locations listed
• In-Game HUD — Compact right-side panel showing target, delivery count, timer, earnings, and XP bar
• Matte Dark Theme — Inspired by Rockstar Games UI. No glare, no glow, subtle grid texture background
• Red Accent Design — Signature left/top border lines, hover effects
• Smooth Animations — Slide-in/out transitions, progress bar fills
• Close Button on Sidebar — Accessible from every tab

🌍 Multi-Language Support

• Built-in Translation System — Switch between languages from config
• Currently Included:
  • 🇬🇧 English
  • 🇹🇷 Türkçe
• Easy to Add New Languages — Just copy the locale block in config and translate

🔧 Framework Support

• Dual Framework — Works on both ESX and QBCore without any code changes

• Automatic Detection — Script detects your framework on startup

• Bridge System — Clean abstraction layer for money, notifications, player identity

  📋 Dependencies

  Dependency

  Required

  Link

  oxmysql

  ✅ Yes

  GitHub

  ox_lib

  ✅ Yes

  GitHub

  es_extended OR qb-core

  ✅ One Required

  ESX or QBCore

  📂 What's Included
  elenadeliveryjob/ ├── fxmanifest.lua ├── config.lua (Full configuration + translations) ├── sql/ │ └── install.sql (One table, easy setup) ├── client/ │ ├── main.lua (Core gameplay logic) │ └── ui.lua (NUI communication) ├── server/ │ ├── bridge.lua (ESX/QB auto-detection) │ ├── main.lua (Payment, anti-exploit, keys) │ └── stats.lua (XP, levels, leaderboard) └── html/ ├── index.html (Tabbed management panel + HUD) ├── style.css (GTA 5 dark matte theme) └── app.js (Dynamic UI updates + language)

-- Language: 'en' or 'tr' Config.Locale = 'en' -- Key system: just type your script name Config.KeySystem = 'qb-vehiclekeys' -- Vehicle rental Config.Vehicle = { model = "boxville2", rental = { enabled = true, price = 250, refundOnFinish = true, refundAmount = 150 } } -- Time limit per delivery Config.TimeLimit = { enabled = true, timePerDelivery = 300, -- seconds speedBonus = { enabled = true, timeThreshold = 120, bonusPercent = 15 } } -- Damage system Config.DamageSystem = { enabled = true, damagePenalty = { threshold = 700.0, penaltyPercent = 25 }, totalFail = { destroyThreshold = 300.0 } } -- 5 Ranks with XP requirements and pay bonuses Config.Levels = { [1] = { title = "Rookie Courier", requiredXP = 0, bonusPay = 0 }, [2] = { title = "Standard Courier", requiredXP = 500, bonusPay = 10 }, [3] = { title = "Fast Courier", requiredXP = 1500, bonusPay = 20 }, [4] = { title = "Senior Courier", requiredXP = 3000, bonusPay = 35 }, [5] = { title = "Master Cargo", requiredXP = 6000, bonusPay = 50 } }

🛠️ Installation

1. Download and extract to your resources folder
2. Import sql/install.sql into your database
3. Add ensure deliveryjob to your server.cfg
4. Open config.lua and set:
   • Config.Locale → your language
   • Config.KeySystem → your key script name
   • Adjust prices, XP values, locations as needed
5. Restart your server

Setup time: ~2 minutes ⚡

💬 Support

• 🎫 Discord support included
• 🐛 Bug fixes & updates included
• 📖 Full documentation provided