> For the complete documentation index, see [llms.txt](https://codeforge.gitbook.io/codeforge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codeforge.gitbook.io/codeforge/jobs/transporter-jobs/work-guide.md).

# WORK GUIDE

### 📋 WORK GUIDE

#### 🔄 Universal Job Structure

All transport jobs follow a consistent workflow:

1. **Find the Job NPC** → Look for the job blip on your map
2. **Open the Job Menu** → Interact with the NPC to access the UI
3. **Select a Route** → Choose a route based on your level
4. **Get Your Vehicle** → Go to the spawned vehicle
5. **Complete the Route** → Follow objectives and deliver
6. **Return the Vehicle** → Return to the depot to finish

***

### 🚌 BUS DRIVER JOB

#### Overview

Transport passengers around Los Santos on various bus routes. Pick up and drop off passengers at designated stops while managing your schedule and vehicle condition.

#### How to Work

**Step 1: Find the Dispatcher**

* Look for the **\[JOB] Bus Driver** blip on your map
* Location: Bus Depot (Downtown LS)
* NPC: Bus Dispatcher

**Step 2: Select a Route**

Open the job menu and choose from available routes:

| Route             | Level | Stops | Base Pay     | XP   |
| ----------------- | ----- | ----- | ------------ | ---- |
| Downtown Express  | 1     | 4     | $25-45/stop  | 400  |
| Vinewood Line     | 3     | 5     | $35-55/stop  | 500  |
| Coastal Route     | 5     | 6     | $45-70/stop  | 600  |
| City Grand Loop   | 7     | 9-10  | $55-85/stop  | 800  |
| Night Owl Express | 10    | 12    | $70-100/stop | 1000 |

**Step 3: Get Your Bus**

* A bus will spawn at the depot
* Follow the marker/blip to find your vehicle
* Enter the bus to start the route

**Step 4: Complete Bus Stops**

* Drive to each bus stop (marked on map)
* Stop inside the marker
* Press the interaction key to open doors
* Wait for passengers to board
* Some passengers may not pay (random event)

**Step 5: Handle Random Events**

* **Breakdowns**: Vehicle may break down (minigame to repair)
* **Non-paying passengers**: Some passengers won't pay

**Step 6: Finish the Route**

* Complete all stops in order
* Return to the final destination
* Park in the designated area
* Receive your payment + completion bonus

#### Vehicle Progression

| Level | Vehicle  |
| ----- | -------- |
| 1     | Tour Bus |
| 5     | City Bus |
| 10    | Coach    |

***

### 🚛 TRUCKER JOB

#### Overview

Haul cargo across San Andreas using semi-trucks and trailers. Load cargo at warehouses and deliver to designated locations. Choose between legal routes for steady income or illegal routes for higher risk/reward.

#### How to Work

**Step 1: Find the Dispatcher**

* Look for the **\[JOB] Trucker** blip on your map
* Location: Port of Los Santos
* NPC: Truck Dispatcher

**Step 2: Select a Route**

Choose from legal or illegal routes:

**Legal Routes (Clean Money)**

| Route              | Level | Pay        | XP  |
| ------------------ | ----- | ---------- | --- |
| Warehouse Supply   | 1     | $500-750   | 400 |
| Package Delivery   | 2     | $550-800   | 450 |
| Industrial Cargo   | 3     | $700-950   | 500 |
| Express Freight    | 4     | $800-1050  | 550 |
| Heavy Machinery    | 5     | $900-1200  | 600 |
| Long Haul Delivery | 6     | $1100-1400 | 700 |

**Illegal Routes (Dirty Money)**

| Route              | Level | Pay        | XP   | Risk      |
| ------------------ | ----- | ---------- | ---- | --------- |
| Shady Deal         | 7     | $1000-1400 | 650  | Medium    |
| Weapons Run        | 9     | $1300-1700 | 800  | High      |
| Toxic Shipment     | 11    | $1500-2000 | 900  | High      |
| Black Market Goods | 13    | $1800-2500 | 1000 | Very High |

**Step 3: Get Your Truck**

* A truck will spawn at the depot
* Find and attach your trailer (marked with blip)
* Drive carefully with the trailer attached

**Step 4: Load Cargo**

Two loading methods:

**Forklift Loading:**

1. Enter the forklift at the loading zone
2. Pick up pallets with the forklift
3. Bring pallets to the back of the trailer
4. Load all cargo items

**Hand Carry Loading:**

1. Walk to each cargo item (boxes, packages)
2. Pick up the item
3. Carry it to the trailer
4. Repeat for all items

**Step 5: Deliver the Cargo**

* Drive to the delivery point
* Align your trailer in the designated zone
* The zone turns green when properly aligned
* Wait for unloading to complete

**Step 6: Handle Random Events (Illegal Routes)**

* **Police Alerts**: Police may try to stop you
* **Biker Attacks**: Gang members may ambush you (survive for the timer)
* **Breakdowns**: Vehicle mechanical failures

**Step 7: Return the Truck**

* Return to the depot
* Park in the return zone
* Collect your payment

#### Vehicle Progression

| Level | Truck Model |
| ----- | ----------- |
| 1     | Phantom     |
| 5     | Packer      |
| 10    | Hauler      |

#### Police Cargo Inspection

Police officers can inspect trucker cargo:

* **Legal cargo**: "Everything looks normal"
* **Illegal cargo**: Alert triggered!

***

### 📦 COURIER JOB

#### Overview

Deliver packages to residential addresses across Los Santos. Load your van with packages and deliver them door-to-door. Interact with customers and handle various delivery scenarios.

#### How to Work

**Step 1: Find the Dispatcher**

* Look for the **\[JOB] Courier** blip on your map
* Location: Airport Area
* NPC: Courier Dispatcher

**Step 2: Select a Route**

Choose from available delivery zones:

| Route              | Level | Deliveries | Pay/Delivery | XP  |
| ------------------ | ----- | ---------- | ------------ | --- |
| Del Perro Heights  | 1     | 3          | $50-70       | 400 |
| Vespucci Canals    | 3     | 3-4        | $55-75       | 450 |
| La Mesa Industrial | 5     | 4          | $65-90       | 550 |
| South Central      | 7     | 3          | $70-95       | 600 |
| Vinewood Hills     | 10    | 4          | $80-120      | 700 |
| Sandy Shores       | 12    | 4          | $90-125      | 750 |
| Paleto Bay         | 15    | 3-4        | $100-150     | 850 |

**Step 3: Get Your Van**

* A delivery van will spawn nearby
* Enter the van to start your route
* Load packages

**Step 4: Make Deliveries**

For each delivery:

1. Drive to the delivery address (marked on map)
2. Exit your van near the delivery point
3. Open the rear doors of the van
4. Pick up a package from inside
5. Carry the package to the customer's door
6. Wait for the customer to appear
7. Complete the delivery interaction

**Step 5: Handle Delivery Events**

Random events may occur at each delivery:

| Event          | Chance   | Description                       |
| -------------- | -------- | --------------------------------- |
| **Success**    | \~65-70% | Normal delivery, customer accepts |
| **Tip**        | \~10-15% | Customer gives you extra money    |
| **Not Home**   | \~12-18% | Leave package at door             |
| **Dog Attack** | \~5-8%   | Escape the dog! Survive the timer |

**Dog Attack Survival:**

* A dog will chase you
* Run away and survive the countdown timer
* You'll receive compensation for the incident

**Step 6: Complete All Deliveries**

* Deliver all packages on your route
* Track your progress in the UI
* Each delivery adds to your earnings

**Step 7: Return the Van**

* Return to the courier depot
* Park in the designated return zone
* Receive your full payment + bonuses

#### Vehicle Progression

| Level | Van Model |
| ----- | --------- |
| 1     | Youga     |
| 5     | Burrito   |
| 10    | Boxville  |

#### Delivery Tips by Area

| Zone           | Customer Type | Tip Amount |
| -------------- | ------------- | ---------- |
| Vinewood Hills | Wealthy       | $25-55     |
| Del Perro      | Middle Class  | $12-28     |
| South Central  | Low Income    | $8-18      |
| Vespucci Beach | Tourists      | $8-20      |

***

### 🎯 PROGRESSION SYSTEM

#### Experience & Levels

* **XP per Route**: Each completed route grants XP based on difficulty
* **Level Unlocks**: Higher levels unlock better vehicles and routes
* **Max Level**: 20 (configurable)
* **XP per Level**: 1200 (configurable)

#### Level Benefits

1. **Better Vehicles**: Unlock upgraded vehicles at levels 1, 5, and 10
2. **New Routes**: Access higher-paying routes as you level up
3. **Bonus Multipliers**: Earn up to 3x at max level

#### Earnings Optimization Tips

1. ✅ Start with basic routes to learn the mechanics
2. ✅ Complete routes without vehicle damage for maximum pay
3. ✅ Level up gradually to unlock better-paying routes
4. ✅ Illegal trucker routes pay more but have higher risk
5. ✅ Vinewood/Hills courier routes give the best tips
6. ✅ Longer bus routes = more XP and money

***

### 🔧 DAMAGE SYSTEM

All jobs feature a damage penalty system:

| Job     | Pay Per Damage | Max Penalty | Threshold |
| ------- | -------------- | ----------- | --------- |
| Bus     | $1.80          | $500        | 5 pts     |
| Trucker | $1.50          | $600        | 8 pts     |
| Courier | $1.50          | $400        | 5 pts     |

**Drive carefully!** Vehicle damage is deducted from your final payment.

***

### 🌍 LOCALIZATION

The script supports multiple languages. Set your language in config:

```lua
Config.Locale = 'en'  -- Options: 'en', 'es', 'fr', etc.
```

Add translations in the `Config.Translations` table for full localization support.

***

### 📝 PLAYER TIPS

#### Efficient Strategies

* 🚗 **Start slow**: Learn each job's mechanics with beginner routes
* 💰 **Avoid damage**: Careful driving = more profit
* ⬆️ **Level up**: Higher levels = better vehicles and routes
* 🎯 **Focus on one job**: Specialize to level up faster
* 🗺️ **Learn the map**: Knowing shortcuts saves time

#### Earnings by Job Type

| Job               | Best For                   | Risk Level |
| ----------------- | -------------------------- | ---------- |
| Bus Driver        | Steady, predictable income | Low        |
| Trucker (Legal)   | Good pay, moderate effort  | Medium     |
| Trucker (Illegal) | Highest pay potential      | High       |
| Courier           | Quick runs, tips           | Low-Medium |

***