GUNSHOP

FiveM Gun Shop, FiveM Weapon Shop, FiveM Gun Store, FiveM Weapon Store, FiveM Ammunition Shop, FiveM Firearms Shop Secondary Keywords: FiveM Weapon Configurations, FiveM Gun Shop

Weapon Shop Configuration Guide

This guide provides instructions on how to configure weapon shops in your script, similar to how you configure garages. It includes examples and explanations for setting up shop locations, blips, and additional details.

1. General Customization

You can add weapon shops by defining their locations, blips (map icons), and other relevant details. Each shop can be customized with its own position and label.

Example Weapon Shop Configuration

2. Adding New Weapon Shops

To add a new weapon shop, follow the structure provided in the example above. Each shop should have a unique identifier (e.g., shop3) and include the following elements:

• Blips: Define the position and appearance of the shop's blip on the map.

  • Position: Coordinates for the blip's location.

  • Label: The name that will appear on the map.

  • Sprite: The icon used for the blip.

  • Display: Display settings for the blip.

  • Scale: The size of the blip.

  • Color: The color of the blip.

• ShopPosition: Define the coordinates for the shop's physical location.

Example of Adding a New Weapon Shop

Customize.Shops = {
    ['shop1'] = {
        Blips = {
            Position = vector3(18.62, -1109.64, 29.8),
            Label = "Weapon Store",
            Sprite = 43,
            Display = 4,
            Scale = 0.6,
            Color = 4,
        },
        ShopPosition = vector3(18.62, -1109.64, 29.6),
    },
    ['shop2'] = {
        Blips = {
            Position = vector3(-37.93, -1114.6, 26.44),
            Label = "Weapon Store",
            Sprite = 43,
            Display = 4,
            Scale = 0.6,
            Color = 4,
        },
        ShopPosition = vector3(-37.93, -1114.6, 26.44),
    }
}

3. Detailed Example Breakdown

• Blips: Each shop has a blip that appears on the map to help players locate it.

  • Position: This is the exact location where the blip will appear on the map (e.g., vector3(18.62, -1109.64, 29.8)).

  • Label: This is the name that will show up on the map when a player hovers over the blip (e.g., "Weapon Store").

  • Sprite: This is the icon used for the blip (e.g., 43).

  • Display: This determines how the blip will be displayed on the map (e.g., 4).

  • Scale: This is the size of the blip (e.g., 0.6).

  • Color: This is the color of the blip (e.g., 4).

• ShopPosition: This defines where the actual shop is located in the game world (e.g., vector3(18.62, -1109.64, 29.6)).

1. Adding Weapons to the Shop

To add weapons to the shop, you need to define each weapon with its properties and configurations. Below is a detailed breakdown and example of how to configure weapons in your script.

Example Weapon Configuration

Customize.Weapons = {
    {
        item = 'weapon_autoshotgun',
        name = 'Auto Shotgun',
        price = 699,
        image = 'weapon_autoshotgun',
        category = 4,
        shop = {'shop1', 'shop2'},

        ammo_item = 'shotgun_ammo',
        ammo_price = 100,

        upgrade = {
            ['sight'] = {},
            ['silencer'] = {},
            ['flashlight'] = {},
            ['magazine'] = {}
        }
    },
    {
        item = 'weapon_pumpshotgun_mk2',
        name = 'Pumpshotgun Mk II',
        price = 870,
        image = 'weapon_pumpshotgun_mk2',
        category = 4,
        shop = {'shop1', 'shop2'},

        ammo_item = 'shotgun_ammo',
        ammo_price = 100,

        upgrade = {
            ['sight'] = {},
            ['silencer'] = {},
            ['flashlight'] = {},
            ['magazine'] = {}
        }
    },
    {
        item = 'weapon_assaultrifle',
        name = 'Assault Rifle',
        price = 1200,
        image = 'weapon_assaultrifle',
        category = 6,
        shop = {'shop1', 'shop2'},

        ammo_item = 'rifle_ammo',
        ammo_price = 100,

        upgrade = {
            ['sight'] = {
                {
                    item = 'sight1',
                    image = 'sight',
                    price = 250
                },
            },
            ['silencer'] = {
                {
                    item = 'silencer1',
                    image = 'silencer',
                    price = 400
                },
                {
                    item = 'silencer2',
                    image = 'silencer',
                    price = 100
                },
                {
                    item = 'silencer3',
                    image = 'silencer',
                    price = 1500
                }
            },
            ['flashlight'] = {
                {
                    item = 'flashlight',
                    image = 'flashlight',
                    price = 250
                },
            },
            ['magazine'] = {
                {
                    item = 'magazine',
                    image = 'magazine',
                    price = 250
                },
            }
        }
    }
}

2. Detailed Breakdown of Weapon Configuration

• item: The unique identifier for the weapon (e.g., 'weapon_autoshotgun').

• name: The display name of the weapon (e.g., 'Auto Shotgun').

• price: The cost of the weapon in the shop (e.g., 699).

• image: The image filename for the weapon (e.g., 'weapon_autoshotgun').

• category: The category ID for the weapon (e.g., 4 for shotguns, 6 for assault rifles).

• shop: An array of shop identifiers where the weapon is available (e.g., {'shop1', 'shop2'}).

• ammo_item: The unique identifier for the weapon's ammo (e.g., 'shotgun_ammo').

• ammo_price: The cost of the ammo (e.g., 100).

• upgrade: A table containing upgrade options for the weapon.

3. Adding Upgrades to Weapons

Upgrades are additional items that can be attached to weapons. Each upgrade has its own properties, such as item ID, image, and price.

Example of Adding Upgrades

upgrade = {
    ['sight'] = {
        {
            item = 'sight1',
            image = 'sight',
            price = 250
        },
    },
    ['silencer'] = {
        {
            item = 'silencer1',
            image = 'silencer',
            price = 400
        },
        {
            item = 'silencer2',
            image = 'silencer',
            price = 100
        },
        {
            item = 'silencer3',
            image = 'silencer',
            price = 1500
        }
    },
    ['flashlight'] = {
        {
            item = 'flashlight',
            image = 'flashlight',
            price = 250
        },
    },
    ['magazine'] = {
        {
            item = 'magazine',
            image = 'magazine',
            price = 250
        },
    }
}

Step-by-Step Setup Instructions

1. Open your weapon shop script file.

2. Locate the Customize.Weapons section.

3. Add a new weapon configuration following the provided examples.

   • Define the weapon's properties: item, name, price, image, category, shop, ammo_item, ammo_price, and upgrade.

4. Save the script file.

5. Restart your server or resource to apply the changes.

Summary

This guide helps you configure weapon shops by providing detailed examples for adding weapons, their properties, and upgrades. Customize each weapon's position, price, and additional features to fit your server's needs. Integrate these configurations into your GitBook documentation for clear and comprehensive instructions for your users.