> For the complete documentation index, see [llms.txt](https://rickys-organization-6.gitbook.io/hwc-documentions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rickys-organization-6.gitbook.io/hwc-documentions/bl-job-center.md).

# BL Job Center

BL Job Center Install & configure guide

### 📥 Downloading Your Resource

After purchasing **BL Job Center**, you must download it via the **CFX Portal**:

1. Go to: <https://portal.cfx.re/>
2. Log in with the account used to purchase
3. Navigate to:

```
Granted Assets
```

4. Locate:

```
BL Job Center
```

5. Click **Download**

***

### 📂 Installing The Resource

#### 1️⃣ Extract The Download

* Extract the `.zip` file
* You will get a folder:

```
BL-JobCenter
```

***

#### 2️⃣ Add To Your Server

Place the folder inside your resources directory:

```
resources/[standalone]/BL-JobCenter
```

***

#### 3️⃣ Import The Database

⚠️ **IMPORTANT – REQUIRED STEP**

Run the SQL file included in the resource:

```
sql/complete_install.sql
```

👉 This will:

* Create all required tables
* Set up indexes for performance
* Enable automatic cleanup

***

#### 4️⃣ Start The Resource

Add this to your `server.cfg`:

```
ensure BL-JobCenter
```

***

#### 5️⃣ Restart Your Server

```
restart qb-core
ensure BL-JobCenter
```

***

### ⚙️ Configuration

All configuration is done inside:

```
config.lua
```

***

#### 🧠 Framework Requirement

This resource **ONLY works with QBCore**

Make sure:

* `qb-core` is installed
* `qb-core` starts BEFORE this resource

***

#### 📍 Job Center Location (NPC)

You can change where the job center is located:

```
Config.NPC = {
    model = 'cs_bankman',
    coords = vector4(117.42, -750.66, 45.75, 96.8)
}
```

***

#### 💼 Jobs Configuration

Jobs are fully configurable:

* Job name
* Description
* Salary
* Whitelisted / non-whitelisted

***

**✅ Instant Jobs (No Application)**

```
whitelisted = false
```

Players can take these instantly.

***

**📄 Application Jobs (Whitelist)**

```
whitelisted = true
```

Players must apply and be approved.

***

#### 🚕 Side Jobs System

Enable or disable side jobs:

```
Config.EnableSideJobs = true
```

Players can:

* Take a side job
* Switch between jobs using a key

***

#### 🎮 Duty Toggle Key

Players can press:

```
9
```

To switch between:

* Main job
* Side job

***

#### 📊 XP & Progression

Enable progression system:

```
Config.EnableProgressionSystem = true
```

Players can:

* Gain XP
* Level up in side jobs

***

#### 💰 Currency

Set currency style:

```
Config.CurrencySymbol = '£'
```

* `£` → UK style
* `$` → US style

***

#### 📩 Discord Webhooks (Optional)

You can receive job applications via Discord:

```
Config.DiscordWebhooks = {
    ['police'] = 'YOUR_WEBHOOK_URL'
}
```

***

### 🎮 How Players Use It

***

#### 📍 Opening The Job Center

* Go to the Job Center NPC
* Press:

```
E
```

***

#### 💼 Getting a Job

1. Open Job Center
2. Browse available jobs
3. Select a job
4. Click:
   * **Take Job** (instant jobs)
   * **Apply** (whitelisted jobs)

***

#### 🚕 Using Side Jobs

1. Open Job Center
2. Select a side job
3. Start working

***

#### 🔄 Switching Jobs (IMPORTANT)

Press:

```
9
```

Then:

* Choose **Main Job** or **Side Job**
* Press **Enter**

👉 Only ONE job can be active at a time

***

#### 👤 Player Features

Players can:

* View profile
* Track job history
* See applications
* Monitor XP (if enabled)

***

### 👔 Boss Features

Bosses can:

* Review job applications
* Approve or reject players

📍 This is done at configured locations in `config.lua`

***

### 🧪 Troubleshooting

***

#### ❌ Jobs Not Showing

* Ensure job exists in:

```
qb-core/shared/jobs.lua
```

* Check it is added in `config.lua`

***

#### ❌ Job Not Applying

* Check job name matches QBCore job
* Check server console

***

#### ❌ UI Not Opening

* Ensure resource is started:

```
ensure BL-JobCenter
```

***

#### ❌ Duty Toggle Not Working

* Ensure player has a side job
* Check:

```
Config.EnableSideJobs = true
```

***

#### ❌ Database Issues

* Ensure SQL was imported
* Check tables exist:

```
bl_job_applications
bl_job_history
bl_side_job_duty
```

***

### ⚠️ Important Notes

* This resource is **QBCore ONLY**
* SQL must be installed **once only**
* Do NOT edit qb-core files
* Match paycheck settings with qb-core
* Images are optional (place in `html/images/`)

***

### ✅ You're Ready!

Your **BL Job Center** is now installed and ready to use.

***

### 💬 Support

If you need help:

* Check your server console
* Verify config settings
* Ensure all dependencies are installed
* Contact support via your Discord