Warehouse Jobs (for Bilgeco Corp)

The logistics jobs let players earn money in the warehouse through two main activities. Box packing has players build and fold boxes at stations, place them on the conveyor, and get paid per box. Forklift delivery has players pick up pallets, move them to delivery points, and get paid per pallet. The packed boxes and pallets feed a shared box economy that other scripts (trucking, deliveries, etc.) can use for loading and deliveries.

Part of the Bilgeco HQ & Warehouse

https://youtu.be/naf0o4BcGXIyoutu.be

Configuration

Payment & Framework

Framework is auto-detected on startup. Force one manually if needed.

Config.framework  = 'auto'       -- 'auto' | 'qbcore' | 'qbox' | 'esx' | 'standalone'
Config.moneyType  = 'bank'       -- 'bank' | 'cash'

Config.money = {
    enabled           = true,
    payPerBoxPackaged = 50,       -- paid per box packed
    payPerPalletMoved = 75,       -- paid per forklift delivery
}

Job Restriction

Gate the job behind a framework job check. Disabled by default.

Config.jobRestriction = {
    enabled       = false,        -- set true to require a job
    jobName       = 'logistics',  -- must match your framework's job name
    requireOnDuty = false,        -- QBCore/QBox only
}

Box Economy

Config.economy = {
    mode            = 'infinite', -- 'infinite' | 'limited'
    maxStockPerType = 20,         -- cap per product type (limited only)
}

Mode	Behaviour
infinite	Workers can always pack. No cap. Default.
limited	Each product type caps at maxStockPerType. Packing blocked when full. Frees up as boxes are collected.

Toggles

Config	Effect
Config.enableLogisticsJob = false	Disables all jobs
Config.allowPalletBoxPickup = false	Disables hand-carry pickup only — economy still runs
Config.debug = true	Prints debug messages to server console

Standalone Payment

If no framework is detected (or you set Config.framework = 'standalone'), open prompt_logistics_corp_script/dist/server/money.lua and fill in the -- STANDALONE block inside AddMoney():

-- Examples:
exports['okokBanking']:AddMoney(source, amount, reason)
exports['ox_economy']:addBalance(source, { amount = amount })
TriggerEvent('my_money:add', source, amount)

source, amount, and reason are already in scope.

Vehicle Keys (Forklift)

Automatically gives forklift keys when a shift starts and removes them when it ends. Supports popular key-lock scripts out of the box.

Config.vehicleKeys = {
    enabled = true,
    system  = 'auto',  -- 'auto' | 'qbx_vehiclekeys' | 'wasabi_carlock' | 'custom' | 'none'
}

System	Notes
auto	Detects installed key script automatically (default)
qbx_vehiclekeys	Force QBox vehicle keys
wasabi_carlock	Force Wasabi Car Lock
custom	Define your own logic in dist/server/server.lua
none	Disable key management entirely

For custom, open prompt_logistics_corp_script/dist/server/keys.lua and fill in the -- CUSTOM blocks inside GiveVehicleKey() and RemoveVehicleKey(). Variables src (player id), vehicle (entity handle), and plate (license plate string) are already in scope.

---

Warehouse Jobs

Packing Job

How it works

1. Walk up to a packing station and press E to claim it.

2. A random product type is chosen (Impotent Rage, Pisswasser, or Phones).

3. Place items into the box using the mouse, press E to seal.

4. The box rides the conveyor out — payment fires when it leaves.

5. The box is added to warehouse stock (visible on pickup pallets).

Economy flow:

Pack box → conveyor → submitPackage → stock +1
                                          ↓
                              Player picks up → takePackage → stock -1

Boxes must be produced before they can be collected. Stock starts at 0 each server boot and increases only when workers pack boxes. Counts survive /restart but reset on full server reboot.

Server Exports

All exports are server-side only.

getBoxCount(packageName) → number

local count = exports['prompt_logistics_corp']:getBoxCount('beer_package')

getAvailableStock() → table

local stock = exports['prompt_logistics_corp']:getAvailableStock()
-- { impotent_rage_package = 5, beer_package = 12, phone_package = 3 }

takeBoxes(packageName, amount) → boolean Atomically removes boxes from stock. Returns false if not enough (nothing removed).

local ok = exports['prompt_logistics_corp']:takeBoxes('beer_package', 5)

addBoxes(packageName, amount) → boolean Adds boxes back to stock. Returns false if it would exceed the cap in limited mode.

exports['prompt_logistics_corp']:addBoxes('beer_package', 5)

Valid package names:

'impotent_rage_package'
'beer_package'
'phone_package'

Server Events

-- Submit a box externally
TriggerEvent("prompt_logistics:submitPackage", "beer_package")

-- Remove a box externally
TriggerEvent("prompt_logistics:takePackage", "beer_package")

GlobalState Keys

Readable from any resource, client or server side:

GlobalState.impotentBoxCount  -- number
GlobalState.beerBoxCount      -- number
GlobalState.phoneBoxCount     -- number

Integration Example

A trucking script that picks up boxes from the warehouse:

-- server.lua of your trucking script
RegisterNetEvent('mytrucking:loadCargo', function(packageName, amount)
    local src = source
    local ok = exports['prompt_logistics_corp']:takeBoxes(packageName, amount)
    if not ok then
        TriggerClientEvent('mytrucking:notify', src, 'Not enough stock.')
        return
    end
    TruckCargo[src] = { package = packageName, amount = amount }
    TriggerClientEvent('mytrucking:notify', src, 'Loaded ' .. amount .. ' boxes.')
end)

-- Return boxes on cancel
RegisterNetEvent('mytrucking:cancelDelivery', function()
    local src = source
    local cargo = TruckCargo[src]
    if cargo then
        exports['prompt_logistics_corp']:addBoxes(cargo.package, cargo.amount)
        TruckCargo[src] = nil
    end
end)
```<div data-gb-custom-block data-tag="hint" data-style='info'>`takeBoxes` is atomic. If two scripts try to grab the last 5 boxes at the same time, only one succeeds. The other gets `false`.</div></details>

***

### Forklift Job

<details>
<summary>How it works</summary>

1. Walk to a forklift start marker and press **E** to begin. A forklift spawns.
2. Drive to a pickup pallet (orange marker), align the forks, and attach it.
3. Deliver the pallet to the drop zone (green marker).
4. Payment fires on each successful delivery.
5. Return to the start marker and press **X** to end the job.

**Job variants:**

| Variant | Pickup | Drop-off |
| ------- | ------ | -------- |
| **Load Deliveries** | Upstairs shelving (20 locations) | Loading zone downstairs (4 locations) |
| **Stock Storage** | Ground floor (4 locations) | Upstairs shelf locations (20 locations) |<div data-gb-custom-block data-tag="hint" data-style='info'>Forklift pallets are **independent from the box economy** — they are static warehouse props, not tied to stock counts. The forklift job is purely a pickup-deliver-get paid cycle.</div>

</details>

<details>
<summary>Custom Forklifts</summary>

Add your own forklift models in `config.lua`:

```lua
Config.customForklifts = {
    { modelName = `myforklift`, forksAttachBoneName = 'forks_attach' }
}

---

Forklift Job

How it works

1. Walk to a forklift start marker and press E to begin. A forklift spawns automatically.

2. Drive to a pickup pallet (orange marker), align the forks, and attach it.

3. Transport the pallet to the drop zone (green marker, visible from distance).

4. Payment of payPerPalletMoved fires on each successful delivery.

5. Return to the start marker and press X to end the job and despawn the forklift.

Job Variants

There are two separate forklift jobs, each with its own start marker:

Variant	What you do	Pickup	Drop-off
Load Deliveries	Move pallets from shelves to trucks	Upstairs shelving (20 locations)	Loading zone downstairs (4 locations)
Stock Storage	Move pallets from ground to shelves	Ground floor (4 locations)	Upstairs shelf locations (20 locations)

Both variants pay the same amount per delivery (Config.money.payPerPalletMoved).

Forklift Pallets vs Box Economy

Forklift pallets are **completely independent** from the box packing economy. They are static warehouse props placed at fixed shelf and floor locations — not tied to `GlobalState` stock counts.

The packing job produces boxes → the forklift job moves pallets. They are two separate gameplay loops that happen to exist in the same warehouse.

Payment Config

Config.money = {
    enabled           = true,
    payPerPalletMoved = 75,       -- paid per forklift delivery
}

Payment uses the same framework auto-detection and Config.moneyType as the packing job. No separate config needed.

Custom Forklifts

The resource ships with a default forklift model. To add your own custom forklift vehicles:

Config.customForklifts = {
    { modelName = `myforklift`, forksAttachBoneName = 'forks_attach' }
}

• modelName — the hashed model name of your custom vehicle

• forksAttachBoneName — the bone on your vehicle model where pallets attach

---