DXS STORES

A versatile and easy-to-configure multi-location store system for the VORP framework on RedM.

Features

• Multiple Store Locations: Configure as many stores as you want across the map.

• Buy & Sell System: Players can buy items from and sell items to the stores.

• NPC-based Shops: Each store is operated by an NPC.

• Customizable Blips: Each store can have a custom blip on the map.

• Highly Configurable: Almost every aspect of the stores can be configured in the config.lua file, from items and prices to NPC models and locations.

• Sleek UI: A modern and intuitive user interface for a smooth player experience.

• VORP Framework: Built for the VORP framework.

Dependencies

• vorp_core

• vorp_inventory

Installation

1. Download the script.

2. Place DXS_store into your resources/[vorp] directory.

3. Execute the .sql files:

   • Run the queries from Extra/items.sql in your database to add the general items.

   • Run the queries from Extra/weapon_ammo.sql in your database to add weapons and ammunition.

4. Add to your server.cfg:

   ensure DXS_store

5. Restart your server.

Configuration

The main configuration file is config.lua. Here you can change general settings and manage your shops.

General Settings

Config.Debug = false
Config.Notify = "vorp" -- "okok", "vorp", "default"
Config.SellPercentage = 0.5 -- The percentage of the original price at which items are sold back
Config.OpenKey = 0xCEFD9220 -- E Key

Shop Configuration

You can add or modify shops in the Config.Shops table. Here is an example of a single shop configuration:

["valentine_general"] = {
    label = "Valentine General Store", -- Name of the store
    store_type = "both", -- "both", "buy", or "sell"
    blip  = { show = true, sprite = 1475879922, name = "General Store" }, -- Map blip settings
    npc = {
        enabled = true,
        model   = "U_M_M_StrGenStoreOwner_01", -- NPC model
        coords  = vector3(-324.5, 803.2, 115.9), -- NPC location
        heading = 97.5 -- NPC heading
    },
    categories = { -- Item categories for this store
        { name = "food", label = "Food" },
        { name = "drinks", label = "Drinks" }
    },
    items = { -- Items sold in this store
        -- Food
        { name = "bread", label = "Bread", category = "food", price = 2 },
        { name = "meat", label = "Cooked Meat", category = "food", price = 5 },
        -- Drinks
        { name = "water", label = "Bottle of Water", category = "drinks", price = 2 },
        { name = "coffee", label = "Coffee Cup", category = "drinks", price = 4 }
    }
},

Usage

Players can find the stores by looking for the configured blips on the map. Once they are near a store NPC, they can press the E key (by default) to open the store menu and start buying or selling items.