> For the complete documentation index, see [llms.txt](https://atenea.gitbook.io/atenea-store-r/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atenea.gitbook.io/atenea-store-r/weapon/one-studio.md).

# One Studio

All our weapons are compatible with the inventory

## ⚔️ Adding Custom Weapons & Items

Our inventory system uses a highly optimized, easy-to-use structure for weapon definitions. You don't need to navigate through complex server files or restart resources; you can add any weapon directly from the comfort of your game.

{% hint style="info" %}
**Good to know:** If you are familiar with `ox_inventory` formatting, our system is 100% compatible with it. You can reuse the exact same code structure!
{% endhint %}

***

### 📋 Code Structure

To add a new weapon, you just need a clean Lua block specifying its properties. Here is an example of a custom item:

```lua
['WEAPON_BRICK'] = {
    label = 'Brick',
    weight = 450,
    throwable = true,
},
['WEAPON_APPLE'] = {
    label = 'Apple',
    weight = 149,
    throwable = true,
},
['WEAPON_DECKCARDS'] = {
    label = 'Deck Cards',
    weight = 50,
    throwable = true,
},
['WEAPON_PINGPONGPADDLE'] = {
    label = 'Ping Ping Paddle',
    weight = 120,
    durability = 0.1,
},
['WEAPON_PLUGER'] = {
    label = 'Pluger',
    weight = 280,
    durability = 0.1,
},
['WEAPON_POT'] = {
    label = 'Pot',
    weight = 280,
    durability = 0.3,
},
['WEAPON_SHOVEL'] = {
    label = 'Pala',
    weight = 2300,
    durability = 0.1,
},
['WEAPON_SPANNER'] = {
    label = 'Spanner',
    weight = 280,
    durability = 0.3,
},
['WEAPON_TOYSHOVEL'] = {
    label = 'Toy Shovel',
    weight = 2300,
    durability = 0.1,
},
['WEAPON_WALKINGSTICK'] = {
    label = 'Walking Stick',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDO'] = {
    label = 'Big Dildo',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDOBLACK'] = {
    label = 'Big Dildo Black',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDOBLUE'] = {
    label = 'Big Dildo Blue',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDOGREEN'] = {
    label = 'Big Dildo Green',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDOPINK'] = {
    label = 'Big Dildo Pink',
    weight = 80,
    durability = 0.1,
},
['WEAPON_BIGDILDORED'] = {
    label = 'Big Dildo Red',
    weight = 80,
    durability = 0.1,
},
['WEAPON_CHICKEN'] = {
    label = 'Chicken',
    weight = 30,
    throwable = true,
},
['WEAPON_CONTROLLER'] = {
    label = 'Controller',
    weight = 120,
    throwable = true,
},
['WEAPON_DILDO'] = {
    label = 'Dildo',
    weight = 50,
    throwable = true,
},
['WEAPON_DILDOBLACK'] = {
    label = 'Dildo Black',
    weight = 50,
    throwable = true,
},
['WEAPON_DILDOPINK'] = {
    label = 'Dildo Pink',
    weight = 50,
    throwable = true,
},
['WEAPON_DILDORED'] = {
    label = 'Dildo Red',
    weight = 50,
    throwable = true,
},
['WEAPON_DILDOBLUE'] = {
    label = 'Dildo Blue',
    weight = 50,
    throwable = true,
},
['WEAPON_DILDOGREEN'] = {
    label = 'Dildo Green',
    weight = 50,
    throwable = true,
},
['WEAPON_HEELS'] = {
    label = 'Heels',
    weight = 80,
    throwable = true,
},
['WEAPON_PAINTROLLER'] = {
    label = 'Paint Roller',
    weight = 500,
    durability = 0.2,
},
['WEAPON_PANTIES'] = {
    label = 'Panties',
    weight = 8,
    throwable = true,
},
['WEAPON_RCSHOVEL'] = {
    label = 'RC Shovel',
    weight = 900,
    durability = 0.1,
},
['WEAPON_TORQUEWRENCH'] = {
    label = 'Torque Wrench',
    weight = 500,
    durability = 0.3,
},
['WEAPON_WOODENSWORD'] = {
    label = 'Wooden Sword',
    weight = 80,
    durability = 0.3,
},
['WEAPON_BIGHAMMER'] = {
    label = 'Big Hammer',
    weight = 520,
    durability = 0.1,
},
['WEAPON_BROOM'] = {
    label = 'Broom',
    weight = 520,
    durability = 0.1,
},
['WEAPON_PICKAXE'] = {
    label = 'Pickaxe',
    weight = 220,
    durability = 0.1,
},
['WEAPON_PLIERS'] = {
    label = 'Pliers',
    weight = 280,
    throwable = true,
},
['WEAPON_POOLBALL'] = {
    label = 'Poolball',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL1'] = {
    label = 'Poolball 1',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL2'] = {
    label = 'Poolball 2',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL3'] = {
    label = 'Poolball 3',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL4'] = {
    label = 'Poolball 4',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL5'] = {
    label = 'Poolball 5',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL6'] = {
    label = 'Poolball 6',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL7'] = {
    label = 'Poolball 7',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL8'] = {
    label = 'Poolball 8',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL9'] = {
    label = 'Poolball 9',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL10'] = {
    label = 'Poolball 10',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL11'] = {
    label = 'Poolball 11',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL12'] = {
    label = 'Poolball 12',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL13'] = {
    label = 'Poolball 13',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL14'] = {
    label = 'Poolball 14',
    weight = 80,
    throwable = true,
},
['WEAPON_POOLBALL15'] = {
    label = 'Poolball 15',
    weight = 80,
    throwable = true,
},
['WEAPON_RAKE'] = {
    label = 'Rake',
    weight = 220,
    durability = 0.1,
},
['WEAPON_ROULETTERAKE'] = {
    label = 'Roulette Rake',
    weight = 220,
    durability = 0.1,
},
['WEAPON_SHOES'] = {
    label = 'Shoes',
    weight = 80,
    throwable = true,
},
['WEAPON_TVCONTROL'] = {
    label = 'TV Control',
    weight = 80,
    throwable = true,
},
['WEAPON_WATERBOTTLE'] = {
    label = 'Water Bottle',
    weight = 80,
    throwable = true,
},
['WEAPON_CASHROLL'] = {
    label = 'Cash Roll',
    weight = 280,
    throwable = true,
},
['WEAPON_DOUBLEAXE'] = {
    label = 'Double Axe',
    weight = 520,
    durability = 0.1,
},
['WEAPON_HOCKEYSTICK'] = {
    label = 'Hockey Stick',
    weight = 520,
    durability = 0.1,
},
['WEAPON_LAPTOP'] = {
    label = 'Laptop',
    weight = 280,
    throwable = true,
},
['WEAPON_MOP'] = {
    label = 'Mop',
    weight = 120,
    durability = 0.1,
},
['WEAPON_SICKLE'] = {
    label = 'Sickle',
    weight = 120,
    durability = 0.1,
},
['WEAPON_SPANKINGPADDLE'] = {
    label = 'Spanking Paddle',
    weight = 520,
    durability = 0.1,
},
['WEAPON_SPANKINGPADDLE2'] = {
    label = 'Spanking Paddle 2',
    weight = 520,
    durability = 0.1,
},
['WEAPON_WHIP'] = {
    label = 'Whip',
    weight = 520,
    durability = 0.1,
},
['WEAPON_WHIP2'] = {
    label = 'Whip 2',
    weight = 520,
    durability = 0.1,
},
['WEAPON_DRYER'] = {
    label = 'Dryer',
    weight = 280,
    throwable = true,
},
['WEAPON_KEYBOARD'] = {
    label = 'Keyboard',
    weight = 280,
    throwable = true,
},
['WEAPON_MALLET'] = {
    label = 'Mallet',
    weight = 520,
    durability = 0.1,
},
['WEAPON_MOUSE'] = {
    label = 'Mouse',
    weight = 280,
    throwable = true,
},
['WEAPON_PEYOTE'] = {
    label = 'Peyote',
    weight = 280,
    throwable = true,
},
['WEAPON_RAT'] = {
    label = 'Rat',
    weight = 280,
    throwable = true,
},
['WEAPON_RASP'] = {
    label = 'Rasp',
    weight = 520,
    durability = 0.1,
},
['WEAPON_ROWING'] = {
    label = 'Rowing',
    weight = 520,
    durability = 0.1,
},
['WEAPON_SPONGE'] = {
    label = 'Sponge',
    weight = 280,
    throwable = true,
},
['WEAPON_SPRAY'] = {
    label = 'Spray',
    weight = 280,
    throwable = true,
},
['WEAPON_SCREWDVR'] = {
    label = 'Screwdvr',
    weight = 520,
    durability = 0.1,
}
```

{% hint style="warning" %}
**Syntax Rule:** When pasting your code into the admin panel, make sure to **remove any comment lines** (such as `//` or `--`) and do not include the main table header (`data.weapons =`). The importer only reads the clean object block.
{% endhint %}

***

#### 🛠️ How to Add Weapons In-Game

Instead of editing backend script files, everything is done directly through the **in-game UI** following this simple path: **In-Game Admin Panel ➔ Weapons ➔ "Import from File"**

1. **Prepare your Code** Copy the clean weapon definition block (from the bracketed name `['WEAPON_...']` down to its closing brace `, }`).
2. **Open the Panel** Log into your FiveM server with an admin account and open the **Admin Panel**.
3. **Go to Weapons** Navigate to the **Weapons** section in the menu.
4. **Import** Click the **"Import from File"** button, paste your code block into the NUI text box, and hit **Confirm/Save**.

{% hint style="success" %}
**Done!** Your custom weapon is now live and registered on the server instantly without needing a resource restart.
{% endhint %}
