> 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 ### ๐Ÿ“ฅ Downloading Your Resource After purchasing **BL Job Center**, you must download it via the **CFX Portal**: 1. Go to: 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://rickys-organization-6.gitbook.io/hwc-documentions/bl-job-center.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.