> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thecruxstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bean Machine Job: FiveM Coffee Shop Script for RP Servers

> Install the Bean Machine barista job on your FiveM RP server. Craft coffee, baked goods, and manage society banking on QBCore, QBOX, and ESX.

The Bean Machine Job script brings an immersive coffee shop experience to your FiveM roleplay server. Players take on the role of a barista, crafting and serving a wide menu of drinks and baked goods — from cappuccinos and espressos to Turkish coffee and fresh-glazed donuts. The script supports **QBCore**, **QBOX**, and **ESX** frameworks and includes everything you need to run a fully operational café job, complete with inventory items, job grades, and a delivery livery.

## Supported Maps

You can use this script with any map — it comes preconfigured for the maps listed below. If your map isn't listed, open a ticket on the Crux Studio Discord server and the team will add support for it.

* Crux Studio
* FM Shop
* Gabz
* Uncle Just
* Brambi Shop
* Wasabi
* Souda
* SLTH

## Installation

<Steps>
  <Step title="Install Dependencies">
    Install the required dependencies before adding this script to your server:

    * [ox\_lib v3.30.6](https://github.com/overextended/ox_lib/releases/tag/v3.30.6)
    * [oxmysql v2.12.0](https://github.com/overextended/oxmysql/releases/tag/v2.12.0)
    * `crux_lib` — included with your script download
  </Step>

  <Step title="Configure the Script">
    Open `config/config.lua` and adjust the settings for your server.
  </Step>

  <Step title="Add Job Grades">
    Add the Bean Machine job grades for your framework:

    <Tabs>
      <Tab title="QBCore">
        Copy the job grade block from `README` into `qb-core/shared/jobs.lua`.
      </Tab>

      <Tab title="QBOX">
        Copy the job grade block from `README` into `qbx_core/shared/jobs.lua`.
      </Tab>

      <Tab title="ESX">
        Copy the job grade block from `install_ESX.md` and run it in your database.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Add Inventory Items">
    Open the `install` folder and add the items and images to your inventory system. Refer to the `README` for the full item list specific to this script.

    The Bean Machine item list includes finished drinks and baked goods (cappuccino, espresso, latte, hot chocolate, Turkish coffee, green tea, jasmine tea, mint tea, chocolate donut, classic donut, pink donut, vanilla donut), raw materials (coffee beans, Turkish coffee beans, milk, cream, sugar, chocolate, toppings, greenleaf, jasmine, mint, flour), and utility items (cup, dirty cup, plate, dirty plate).
  </Step>

  <Step title="Start the Resources">
    Add the following to your `server.cfg`:

    ```
    ensure ox_lib
    ensure crux_lib
    ensure crux-beanmachinejob
    ```
  </Step>
</Steps>

## Integrations

All Crux Studio scripts use the following status legend:

| Symbol | Meaning                                                      |
| ------ | ------------------------------------------------------------ |
| ✅      | Officially Supported — fully tested and confirmed functional |
| ☑️     | Supported — untested or may require additional configuration |
| ⚠️     | Issues — known issues on our end or with the third-party     |

### 👁️ Eye Target

| Script     | Status                 |
| ---------- | ---------------------- |
| ox\_target | ✅ Officially Supported |
| qb-target  | ✅ Officially Supported |
| qtarget    | ☑️ Supported           |

### 🪧 Notify

| Script                     | Status                 |
| -------------------------- | ---------------------- |
| crux\_notify               | ✅ Officially Supported |
| qb                         | ✅ Officially Supported |
| ox                         | ✅ Officially Supported |
| esx                        | ✅ Officially Supported |
| wasabi\_notify             | ☑️ Supported           |
| vzn-notify                 | ☑️ Supported           |
| vms\_notifyv2              | ☑️ Supported           |
| v42-notify                 | ☑️ Supported           |
| sd-notify                  | ☑️ Supported           |
| RxNotify                   | ☑️ Supported           |
| qf\_notify                 | ☑️ Supported           |
| prism\_uipack              | ☑️ Supported           |
| origen\_notify             | ☑️ Supported           |
| op-hud                     | ☑️ Supported           |
| okokNotify                 | ☑️ Supported           |
| JustNotify                 | ☑️ Supported           |
| is\_ui                     | ☑️ Supported           |
| frkn-uikit                 | ☑️ Supported           |
| ef                         | ☑️ Supported           |
| DoItDigital\_notifications | ☑️ Supported           |
| cs:notify                  | ☑️ Supported           |
| codeo-notification         | ☑️ Supported           |
| cdev\_notify               | ☑️ Supported           |
| brave                      | ☑️ Supported           |
| aty\_notify                | ☑️ Supported           |
| an\_notify                 | ☑️ Supported           |
| 4EV3R-Notify               | ☑️ Supported           |

### 🤔 Inventory

| Script               | Status                 |
| -------------------- | ---------------------- |
| ox\_inventory        | ✅ Officially Supported |
| qb-inventory         | ✅ Officially Supported |
| codem-inventory      | ☑️ Supported           |
| qs-inventory         | ☑️ Supported           |
| tgiann-inventory     | ☑️ Supported           |
| core\_inventory      | ☑️ Supported           |
| origen\_inventory    | ☑️ Supported           |
| ak47\_qb\_inventory  | ☑️ Supported           |
| ak47\_esx\_inventory | ☑️ Supported           |
| ps-inventory         | ☑️ Supported           |
| jpr-inventory        | ☑️ Supported           |

### 💳 Banking / Society

| Script          | Status                 |
| --------------- | ---------------------- |
| qb-banking      | ✅ Officially Supported |
| qb-management   | ✅ Officially Supported |
| wasabi\_banking | ☑️ Supported           |
| tgg-banking     | ☑️ Supported           |
| snipe-banking   | ☑️ Supported           |
| s1n\_banking    | ☑️ Supported           |
| Renewed-Banking | ☑️ Supported           |
| qs-banking      | ☑️ Supported           |
| p\_banking      | ☑️ Supported           |
| okokBanking     | ☑️ Supported           |
| nfs-billing     | ☑️ Supported           |
| kartik-banking  | ☑️ Supported           |
| JustBanks       | ☑️ Supported           |
| fd\_banking     | ☑️ Supported           |
| esx\_society    | ☑️ Supported           |
| codem-bank      | ☑️ Supported           |
| brutal\_banking | ☑️ Supported           |
| RxBanking       | ☑️ Supported           |

### 💵 Billing

| Script          | Status       |
| --------------- | ------------ |
| tgg-billing     | ☑️ Supported |
| s1n\_billing    | ☑️ Supported |
| qs-billing      | ☑️ Supported |
| okokBilling     | ☑️ Supported |
| nfs-billing     | ☑️ Supported |
| nass\_billing   | ☑️ Supported |
| jim-payments    | ☑️ Supported |
| izzy-billing    | ☑️ Supported |
| esx\_billing    | ☑️ Supported |
| dusa\_billing   | ☑️ Supported |
| cs\_billing     | ☑️ Supported |
| codem-billing   | ☑️ Supported |
| brutal\_billing | ☑️ Supported |

### 👖 Clothing

| Script              | Status                 |
| ------------------- | ---------------------- |
| qb-clothing         | ✅ Officially Supported |
| illenium-appearance | ✅ Officially Supported |
| esx\_skin           | ☑️ Supported           |
| rcore\_clothing     | ☑️ Supported           |
| vms\_clothestore    | ☑️ Supported           |
| sleek-clothestore   | ☑️ Supported           |

### 🗝️ Key Systems

| Script               | Status                 |
| -------------------- | ---------------------- |
| qb-vehiclekeys       | ✅ Officially Supported |
| jaksam-vehicles-keys | ☑️ Supported           |
| mk\_vehiclekeys      | ☑️ Supported           |
| qs-vehiclekeys       | ☑️ Supported           |
| wasabi\_carlock      | ☑️ Supported           |
| cd\_garage           | ☑️ Supported           |
| okokGarage           | ☑️ Supported           |
| t1ger\_keys          | ☑️ Supported           |
| MrNewbVehicleKeys    | ☑️ Supported           |
| Renewed-Vehiclekeys  | ☑️ Supported           |
| tgiann-hotwire       | ☑️ Supported           |
| qbx\_vehiclekeys     | ☑️ Supported           |

<Note>If your preferred script isn't listed, open a ticket on the Crux Studio Discord server.</Note>