> For the complete documentation index, see [llms.txt](https://docs.elixirfw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elixirfw.com/resources/vendings.md).

# Vending Machines

Welcome to the installation and documentation page for the Player Owned Vending Machines script.

<figure><img src="https://1944405286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWx1Ztk7QyXiPbW3VvqZA%2Fuploads%2F5Js0S4VTrSQQhKWfKsCk%2Fdmca.png?alt=media&amp;token=1153e025-1a79-4d5f-aa9d-785b29bacd37" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Version 2.0 — The Business Update.** AI customers, hireable AI employees, a full crime loop, and real profit accounting. See what's new →
{% endhint %}

Most vending scripts give you a prop that dispenses a soda. This one gives players a **business to run** — one they staff, defend, and actually have to make profitable.

***

## Why this one

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🤖 AI Customers</strong></td><td>NPCs walk up, buy, and pay the owner. Machines earn even when nobody is shopping.</td><td></td></tr><tr><td><strong>👔 AI Employees</strong></td><td>Hire NPC staff who restock, clean and pay the bills — for a salary. Underpay them and they quit.</td><td></td></tr><tr><td><strong>🕵️ Crime &#x26; Defence</strong></td><td>Tamper, rob, police requirements, repairs — and machines that shock thieves.</td><td></td></tr><tr><td><strong>📈 Real Economy</strong></td><td>Tax, commission, dynamic pricing, happy hour — with earnings caps that protect your server.</td><td></td></tr></tbody></table>

***

## Compatibility

<table><thead><tr><th width="180">Type</th><th>Supported</th></tr></thead><tbody><tr><td><strong>Frameworks</strong></td><td>QBCore · QBox (qbx_core) · ESX — <em>auto-detected, one build</em></td></tr><tr><td><strong>Inventories</strong></td><td>ox_inventory · qb-inventory · qs-inventory · codem · ESX inventories</td></tr><tr><td><strong>Targets</strong></td><td>ox_target · qb-target · qtarget — <em>or keyless textui / 3dtext modes</em></td></tr><tr><td><strong>Dispatch</strong></td><td>ps-dispatch · cd_dispatch · qs-dispatch · core_dispatch · rcore_dispatch · linden_outlawalert</td></tr><tr><td><strong>Required</strong></td><td>ox_lib · oxmysql</td></tr></tbody></table>

{% hint style="info" %}
**One purchase, every framework.** There are no separate QB/ESX versions to buy — the resource detects your framework at runtime.
{% endhint %}

***

## Performance

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>~0.01 ms idle</strong></td><td>State is pushed to clients on change instead of polled. The interaction thread only runs in the mode you use. NPCs are proximity-gated and capped.</td></tr><tr><td><strong>Server-authoritative</strong></td><td>Money, stock, prices and payouts are resolved server-side. Client input is treated as hostile on every action.</td></tr></tbody></table>

***

## Get started

***

{% hint style="warning" %}
This software is protected by DMCA. Illegal sale or distribution is prohibited.
{% endhint %}