Weapon attachments in ox_inventory

#The default attachment items

#How an attachment item is defined

['at_suppressor_light'] = {
    label = 'Suppressor',
    weight = 280,
    type = 'muzzle',
    client = {
        image = 'at_suppressor.png',
        component = {
            `COMPONENT_AT_PI_SUPP`,
            `COMPONENT_AT_PI_SUPP_02`,
            `COMPONENT_CERAMICPISTOL_SUPP`,
            `COMPONENT_PISTOLXM3_SUPP`,
        },
        usetime = 2500,
    },
},

• type groups attachments; a weapon holds one attachment of each type.
• client.component lists every GTA component this item may apply. When used on a weapon, the first entry the weapon accepts is attached.
• usetime is how long attaching takes, in milliseconds.
• client.image lets several items share one icon.

#Attachments for addon weapons

An addon weapon usually has its own component names (for example COMPONENT_MYRIFLE_CLIP_02). The existing item will not attach them until you list them:

1. Find the component names in the weapon’s weaponcomponents.meta and its AttachPoints in weapons.meta.
2. Add each hash to the matching item’s client.component list (for example the extended clip to at_clip_extended_rifle).
3. Or create a new item if the attachment is unique to that weapon.
4. Restart ox_inventory.

['at_clip_extended_rifle'] = {
    label = 'Extended Rifle Clip',
    type = 'magazine',
    client = {
        component = {
            -- …existing vanilla hashes…
            `COMPONENT_MYRIFLE_CLIP_02`,
        },
        usetime = 2500,
    },
},

If the weapon’s own weapons.meta does not list the component in its AttachPoints, no item can attach it — see weapons.meta explained.

#When an attachment will not attach

The component system itself — natives and naming — is covered in weapon components.