# WORK GUIDE

Don't know how the taxi job works or what the steps are? Check out this step-by-step guide we've made for you!

#### 📋 Requirements

Before starting, make sure you have:

* A taxi job assigned to your character (from server admin)
* Access to a taxi company (if multiple companies are configured)
* A valid driver's license (its roleplay not from system)

***

#### 🚀 Starting Your Shift

**Step 1: Getting on Duty**

1. **Locate a Taxi Company**: Find a taxi company location on your map (marked with a taxi blip)
2. **Find the NPC**: Look for the company NPC at the taxi company location (usually standing near the garage or office)
3. **Interact with NPC**: Approach the NPC and interact with them (using your target system or E key)
4. **Toggle Duty**: Click on "Toggle Duty" or "Go on Duty" option to activate your duty status
5. **Duty Activated**: You'll receive a notification confirming you're now on duty

**Note**: You must be on duty before customers will spawn and missions will be available.

**Step 2: Getting Your Vehicle**

1. **Access Garage Menu**
2. **Choose Vehicle**: Browse available taxi vehicles for your selected company
3. **Spawn Vehicle**: Select a vehicle and it will spawn at the designated garage location
4. **Vehicle Ready**: Your taxi is now ready to pick up customers!

**Note**: You can also use an existing taxi vehicle if one is available, but spawning from the garage ensures you have a proper company vehicle.

***

#### ✅ Legal Missions (Standard Taxi Rides)

Legal missions are the regular taxi rides that make up most of your work. Here's how to complete them:

**Step 1: Finding a Customer**

1. **Look for Yellow Markers**: Yellow circular markers will appear on your map indicating customer pickup locations
2. **Customer Arrow**: When you get close (within 60 meters), a yellow arrow will appear above the waiting customer
3. **Drive to Location**: Navigate to the marker using your GPS or map

**Step 2: Picking Up the Customer**

1. **Stop Near Customer**: Park your taxi close to the customer (they will automatically detect your vehicle)
2. **Customer Approaches**: The NPC will walk toward your taxi and enter automatically
3. **Wait for Entry**: Give the customer a few seconds to get into the vehicle
4. **Destination Given**: Once inside, the customer will tell you their destination and a GPS route will appear

**Step 3: Driving to Destination**

1. **Follow GPS**: Use the GPS route displayed on your map to navigate to the destination
2. **Yellow Destination Marker**: A yellow marker will show where to drop off the customer
3. **Drive Safely**:
   * **Speed Limit**: Keep your speed under 100 km/h (65 mph) to avoid customer complaints
   * **Avoid Damage**: Don't crash or damage your vehicle, or the customer may exit angrily
   * **Smooth Driving**: Smooth, professional driving earns better tips

**Step 4: Conversations During the Trip**

During the trip, passengers may start conversations with you:

1. **Conversation Prompt**: A notification will appear with a question from the passenger
2. **Answer Options**: You'll see two options:
   * Press **Y** for Option A
   * Press **U** for Option B
3. **Time Limit**: You have 12 seconds to respond (configurable)
4. **Tips**: Correct answers improve your tip multiplier:
   * **Excellent** (80%+ correct): 2.0x tip bonus
   * **Good** (60-79% correct): 1.5x tip bonus
   * **Average** (40-59% correct): 1.0x (no bonus/penalty)
   * **Poor** (<40% correct): 0.7x (30% penalty)

**Pro Tip**: Answer honestly and thoughtfully - the conversations are moral dilemmas, not just random questions!

**Step 5: Completing the Trip**

1. **Arrive at Destination**: Stop at the yellow destination marker
2. **Customer Exits**: The customer will automatically exit your vehicle
3. **Payment Received**: You'll receive payment based on:
   * Base fare (minimum payment)
   * Distance traveled (per kilometer rate)
   * Trip quality (conversation performance affects tips)
   * Time of day (night rates are higher)
4. **Trip Summary**: A detailed trip summary will appear showing:
   * Total distance traveled
   * Total fare earned
   * Items received (if configured)
   * Trip duration

**Step 6: What Happens Next?**

* **Customer Walks Away**: The customer will walk away and despawn after a short distance
* **New Customer Available**: A new customer will spawn at a random pickup location
* **Repeat**: Continue picking up customers to earn more money!

***

#### ⚠️ Illegal Missions (Optional High-Risk Rides)

Some customers may offer illegal missions. These pay more but come with risks!

**Mission Offer**

1. **Illegal Customer**: After picking up a regular customer, they may ask: *"Hey, do you do less legal jobs?"*
2. **Decision Time**: You'll have two options:
   * **Accept**: You'll be taken to an illegal location (beat mission or drug deal)
   * **Decline**: The customer will exit angrily and run away (you keep the legal job payment)

**Beat Mission (If Accepted)**

1. **Drive to Location**: Follow GPS to the beat mission location (marked with a red marker)
2. **Arrive at Location**: Stop at the destination
3. **Customer Exits**: The customer will exit and approach their target
4. **Beat Animation**: The customer will perform a beatdown animation on the target
5. **Mission Complete**: After the animation, the customer returns to your taxi
6. **Return Trip**: Drive the customer to their final drop-off location

**Drug Deal Mission (If Accepted)**

1. **Drive to Dealer**: Follow GPS to the drug dealer location (marked with a red marker)
2. **Arrive at Location**: Stop near the dealer
3. **Customer Exits**: The customer exits and approaches the dealer
4. **Transaction**: Both NPCs perform a transaction animation
5. **Mission Complete**: After the transaction, the customer returns to your taxi
6. **Return Trip**: Drive the customer to their final drop-off location

**Chase System (Risk Factor)**

During illegal missions, there's a chance (30% by default) that police or bikers will chase you:

1. **Chase Triggered**: vehicles will spawn and start chasing you
2. **Chase Duration**: You have 60 seconds to escape or survive the chase
3. **Escape Methods**:
   * **Distance**: Get 250+ meters away from chasers
   * **Line of Sight**: Lose line of sight and gain extra distance (100m bonus)
4. **Surviving Chase**: If you survive without being caught, you receive:
   * **Chase Bonus**: Extra money (default: $150)
   * **Bonus Items**: Additional items if configured
5. **Chaser Behavior**: Chasers will:
   * Shoot at your vehicle (25% accuracy)
   * Follow aggressively
   * Retreat peacefully if you escape

**Warning**: Illegal missions are risky but rewarding. Drive carefully during chases!

***

#### 🎯 Advanced Features

**Analog Taximeter**

1. **Activate Taximeter**: Press **CTRL** (default) while driving a customer to start the taximeter
2. **Real-Time Fare**: Watch the fare increase as you drive:
   * **Day Rate**: $3.50 per kilometer (default)
   * **Night Rate**: $4.50 per kilometer (22:00 - 06:00)
   * **Special Rate**: 1.4x multiplier (if enabled)
3. **Taximeter Display**: Shows current fare, distance, and rate type
4. **Stop Taximeter**: Press **CTRL** again to pause/stop the taximeter

**Client Escape System**

Some customers may try to escape without paying (12% chance by default):

1. **Escape Triggered**: Customer exits vehicle unexpectedly and starts running
2. **Red Arrow Marker**: A red arrow appears above the escaping customer
3. **Chase the Customer**: You have 35 seconds to catch them
4. **Tackle**: Get within 3.5 meters and press **E** to tackle the customer
5. **Success Rewards**:
   * **Base Bonus**: $20-$50 extra payment
   * **Percentage Bonus**: 30% of original fare
   * Customer pays and then runs away

**Pro Tip**: Keep an eye on suspicious customers - they might try to escape!

**Speed Warnings**

If you drive too fast (over 100 km/h by default):

1. **Customer Complains**: The passenger will complain about your speed
2. **Warning Message**: You'll see messages like "Slow down please!"
3. **Tip Penalty**: Speed violations count as wrong answers, reducing your tip multiplier
4. **Multiple Warnings**: Continuous speeding may cause the customer to exit angrily

**Pro Tip**: Drive professionally - slower, safer driving = better tips!

**Vehicle Damage Reactions**

If your vehicle takes too much damage (below 750/1000 health):

1. **Customer Panics**: The customer will become scared
2. **Exit Warning**: They'll complain about the vehicle condition
3. **Customer Exits**: After 1.5 seconds, they'll exit and run away
4. **No Payment**: You won't receive payment if the customer exits due to damage

**Pro Tip**: Maintain your vehicle - regular repairs prevent lost customers!

***

#### 📊 Player Metrics

The script tracks your performance:

* **Trips Completed**: Total number of successful trips
* **Distance Traveled**: Total kilometers driven
* **Earnings**: Total money earned
* **Items Received**: Total items collected
* **Illegal Missions**: Number of illegal missions completed
* **Chases Survived**: Number of successful chase escapes

Access your metrics through the taxi menu (if enabled by server admin).

***

#### 🎮 Tips for Success

1. **Drive Professionally**: Smooth driving, respecting speed limits, and avoiding damage earns better tips
2. **Answer Conversations Thoughtfully**: Moral dilemma questions affect your tip multiplier significantly
3. **Manage Risk**: Illegal missions pay more but have chase risks - assess if it's worth it
4. **Maintain Your Vehicle**: Keep your taxi in good condition to prevent customer exits
5. **Use GPS**: Always follow GPS routes - customers appreciate efficiency
6. **Watch for Escapes**: Some customers may try to escape - be ready to chase them
7. **Night Driving**: Night rates are higher - consider working night shifts for better pay
8. **Multiple Companies**: If available, try different companies to find the best fit


---

# Agent Instructions: 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:

```
GET https://codeforge.gitbook.io/codeforge/jobs/taxi-job/work-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
