crg-logistic

🚚 Logistic Delivery Job System

A fully customizable, immersive, and optimized delivery mission system for roleplay servers. Players pick up a truck, attach a trailer, follow checkpoints, and get rewarded based on mission success.

---

📁 Configuration Overview

This script uses two main configuration files:

• main.lua (Config) — mission routes, vehicles, rewards, ped model, blips

• localization.lua — all text shown to players

---

🌍 Localization

Below are all localization strings used in the system: localization

Key	Text
job_start	Start a delivery job
job_end	End current job
job_blip	Logistic
truck_blip	Truck
trailer_blip	Trailer
checkpoint_blip	Checkpoint
msg_get_truck	Get in the truck.
msg_get_trailer	Attach the trailer.
msg_follow_checkpoints	Follow checkpoints to complete delivery.
msg_truck_destroyed	Truck has been destroyed!
msg_trailer_destroyed	Trailer has been destroyed!
msg_left_truck_behind	You left the truck behind you!
msg_left_trailer_behind	You left the trailer behind you!
msg_mission_end	Delivery completed successfully!
ntf_mission_success	Earned Money
ntf_mission_failed	Lost Money

---

⚙️ Main Configuration

Below is the core configuration that controls mission behavior, vehicles, checkpoints, and rewards: main

🔧 General Settings

Setting	Description
boss_ped	Ped model used to start and stop delivery jobs
blip_code	Blip icon for mission locations
blip_color	Blip color
Destinations	All delivery routes and mission data

---

📦 Delivery Missions

Each mission includes:

• Success reward

• Failure penalty

• Truck & trailer models

• Vehicle spawn positions

• Checkpoint route

Below are all missions included in the default configuration:

---

1️⃣ Delivery Route — Hauler + Tanker

Setting	Value
Success Earnings	500
Failed Penalty	250
Truck	hauler
Trailer	tanker
Truck Spawn	vector4(1189.61, -3104.07, 5.77, 0)
Trailer Spawn	vector4(1273.3, -3097.69, 5.9, 90)

🟡 Checkpoints

1045.99, -3112.6, 5.48
845.83, -3168.68, 5.56
739.06, -2620.75, 17.06
281.16, -2524.78, 5.41
3.21, -2521.64, 5.62
-62.33, -2528.42, 5.59

---

2️⃣ Delivery Route — Phantom + Trailers

Setting	Value
Success Earnings	500
Failed Penalty	250
Truck	phantom
Trailer	trailers

🟡 Checkpoints

1045.99, -3112.6, 5.48
845.83, -3168.68, 5.56
739.06, -2620.75, 17.06
780.49, -2145.68, 28.9
1088.07, -2081.94, 35.29
1262.17, -1975.96, 42.84

---

3️⃣ Delivery Route — Phantom + TR4 (Car Trailer)

🟡 Checkpoints

1045.99, -3112.6, 5.48
845.83, -3168.68, 5.56
739.06, -2620.75, 17.06
802.92, -1968.56, 28.83
730.58, -1735.72, 28.98
71.94, -1216.99, 28.87
-12.93, -1090.91, 26.25

---

4️⃣ Delivery Route — Bison + Small Trailer

🟡 Checkpoints

1045.99, -3112.6, 5.48
845.83, -3168.68, 5.56
739.06, -2620.75, 17.06
926.49, -2465.26, 28.1
1098.22, -2079.37, 36.96
1276.98, -2169.6, 48.27
1137.59, -2504.71, 32.9

---

🎮 Gameplay Flow

1️⃣ Start the Job

The player interacts with the logistic boss ped to begin the mission.

2️⃣ Enter the Truck 🚛

Player receives on-screen instructions.

3️⃣ Attach the Trailer 🔩

A marker guides the player to connect the trailer.

4️⃣ Follow the Checkpoints 🟡

The route is fully guided by GPS and map blips.

5️⃣ Deliver the Cargo 📦

Upon completion, the player receives the configured success_earning reward.

---

❌ Failure Conditions

The mission fails if:

• The truck is destroyed

• The trailer is destroyed

• The player moves too far from the truck

• The player moves too far from the trailer

• The player manually ends the job

Failure results in failed_lost being deducted.

---

🧩 Adding New Routes

Adding a new delivery job is simple. Use this template:

{
    success_earning = 500,
    failed_lost = 250,
    truck_name = "your_truck",
    truck_pos = vector4(x, y, z, heading),
    trailer_name = "your_trailer",
    trailer_pos = vector4(x, y, z, heading),
    checkpoints = {
        vector3(x, y, z),
        ...
    }
}

You can add unlimited routes, use any truck/trailer models, and adjust rewards to match your server economy.