> For the complete documentation index, see [llms.txt](https://visionstore.gitbook.io/visionstore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visionstore.gitbook.io/visionstore-docs/scripts/weaponhub.md).

# Vision Weapon Hub

A 3D weapon workbench for ox\_inventory. Every GTA attachment, tint and MK II camo colour, previewed live.

**Vision Weapon Hub** is a 3D weapon workbench for ox\_inventory. Players walk up to a bench and their gun floats in front of them in a lit studio. They fit scopes, suppressors, grips, magazines, special ammo, finishes, tints and MK II camo colours, and see every change on the real GTA model before anything is used up.

**Every base-game weapon and every one of its attachments is built in:** 95 weapons and 414 parts, read straight from the game files. Add-on weapons take one entry in a config file, or none by hand: a helper reads the pack's `.meta` files and writes the entries for you.

{% hint style="success" %}
**Get it on the** [**Vision Store**](https://www.vision-store.site/) · Questions? [Join our Discord](https://discord.gg/ZvHtyhyBp4)
{% endhint %}

{% hint style="info" %}
**Version 1.0.0** · Qbox · QBCore · ESX · ox\_core · Standalone · OneSync · ox\_lib · ox\_inventory
{% endhint %}

## Features at a glance

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>🔫 Real 3D workbench</strong></td><td>The actual weapon model in a studio with a backdrop, lights and depth of field. Drag to rotate, scroll to zoom.</td></tr><tr><td><strong>🎯 Preview before you fit</strong></td><td>Try any part on the model. Damage, fire rate, accuracy, range, capacity, magazine and weight update as you stage changes.</td></tr><tr><td><strong>🧰 Every GTA part built in</strong></td><td>95 weapons and 414 parts: optics, suppressors, grips, flashlights, barrels, clips, drums, MK II ammo, camos and slides.</td></tr><tr><td><strong>🎨 Tints and camo colours</strong></td><td>8 standard and 32 MK II tints, your own palettes, and 32 MK II camo colours. Rename and price each one.</td></tr><tr><td><strong>📦 Plain ox_inventory items</strong></td><td>Attachments are normal items. 22 extra items and 92 icons included for parts ox_inventory has no item for.</td></tr><tr><td><strong>🧩 Add-on weapons in one command</strong></td><td>A helper reads a pack's <code>.meta</code> files and writes every slot, factory part, tint palette and stat for you.</td></tr><tr><td><strong>🏪 Workbenches with rules</strong></td><td>Job and grade rules, required tools, open or per-change fees, blips and an optional bench prop.</td></tr><tr><td><strong>🛡️ Issued equipment</strong></td><td>Weapons and parts your armory marks can only be changed by their department.</td></tr><tr><td><strong>🔒 Server-checked saves</strong></td><td>Distance, ownership, compatibility, money and rate limits checked on the server. A failed save rolls everything back.</td></tr></tbody></table>

## How a change is applied

```mermaid
flowchart TD
    A[Player uses a workbench] --> B{Server checks bench rules}
    B -- refused --> X[Notification with the reason]
    B -- ok --> C[Pick a weapon from the inventory]
    C --> D[Preview and stage parts, tint, camo colour]
    D --> E[Apply Changes]
    E --> F{Server checks items, distance, money}
    F -- fails --> R[Everything rolled back]
    F -- ok --> G[Fees taken, parts used up or returned]
    G --> H[Saved on the weapon in ox_inventory]
    H --> I[Draw the gun: the parts are on it]
```

## Where to go next

| I want to...                        | Go to                                                                          |
| ----------------------------------- | ------------------------------------------------------------------------------ |
| Install the script                  | [Installation](/visionstore-docs/scripts/weaponhub/installation.md)            |
| Fit my first scope in 5 minutes     | [Quick start](/visionstore-docs/scripts/weaponhub/quick-start.md)              |
| Change benches, prices, colours...  | [Configuration](/visionstore-docs/scripts/weaponhub/configuration.md)          |
| Add my add-on weapon pack           | [Add-on weapons](/visionstore-docs/scripts/weaponhub/guides/add-on-weapons.md) |
| Learn how players and admins use it | [Guides](/visionstore-docs/scripts/weaponhub/guides.md)                        |
| Open the hub from my own scripts    | [Developers](/visionstore-docs/scripts/weaponhub/developers.md)                |
| Fix a problem                       | [Troubleshooting](/visionstore-docs/scripts/weaponhub/troubleshooting.md)      |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://visionstore.gitbook.io/visionstore-docs/scripts/weaponhub.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.