Advanced Blackmarket System

The DevNation Blackmarket System allows players to access an immersive and configurable illegal marketplace featuring randomized locations, nighttime access control, item pickups, warehouses, and a wide variety of contraband and equipment.

---

⚙️ General Configuration

Option	Description	Value
Framework	Game framework to use.	"ESX" / "QBCore"
Ped	Ped model for the blackmarket NPC.	"a_m_y_gencaspat_01"
PedType	Ped type ID (4 = male civilian).	4
ShopLocation	Default spawn location for the blackmarket.	vector4(...)
EnableOnlyAtNight	Restrict market access to nighttime only.	false

---

🔄 Randomized Locations

Option	Description
Randomizer	Enables random locations for the market.
RandomCoords	List of potential random spawn locations.

---

📦 Pickup System

Option	Description	Value
PickupLocation	Enables pickup location functionality.	false
Cutscene	Enables cutscene during pickup.	false
PickupType	Distance unit for location info.	"km" / "mile"
PickupLocationPed	Ped model used at pickup spot.	"a_m_y_gencaspat_01"
PickupLocations	List of available pickup locations.

---

🏭 Warehouse System

Option	Description	Value
Warehouse	Enables warehouse-based pickups.	true
WereLocationType	Unit of measure used.	"mile"
WarehouseIPL	Warehouse entrance coordinates.	vector4(...)
WarehouseExit	Player exit point inside warehouse.	vector3(...)
Prop	Object used inside warehouse.	"prop_box_wood05a"
PropCoords	Position of prop inside warehouse.	vector4(...)
WarehouseLocation	Locations to deliver items from warehouse.

---

🔠 UI & Message Configuration

📛 Labels

Label	Text
BlackMarketTitle	BLACKMARKET
TitleWarehouse	Warehouse
ExitWarehouse	Exit warehouse
ClaimPickup	Claim items
CollectItems	Claim items

📢 Notifications

ID	Message
ErrorTime	Blackmarket opens soon
Error1	Check config there's something wrong
Error2	You already ordered something
PickupMSG	Go pick up your stuff at marked location
WarehouseMSG	Go to marked location to pickup items

---

🛍️ Store Inventory

The blackmarket supports multiple categories of items with their own properties, such as weight, price, and descriptions. Below are the available categories:

---

💊 DRUGS

Includes various narcotics and drug-related materials:

• Cocaine (Leaf, Baggy, Bricks)

• Crack

• Meth (Baggy, Tray)

• Oxycodone

• Weed (Baggy, Brick, Seeds, Nutrition)

• Ecstasy

---

🔧 EQUIPMENT

Tools and components useful for other illegal operations:

• Cryptostick

• Drill

• Ephedrine

• Thermite

• Tunerchip

• USB Devices

---

🔫 GUNS

A variety of firearms for different scenarios:

• Advanced Rifle

• Assault SMG

• Shotguns (Auto, Bullpup)

• Carbine Rifle Mk2

• Heavy Pistols, PDWs

• Special Carbines

---

💣 TROWABLES

Throwable weapons used in combat:

• Tear Gas

• Grenades

---

🧩 ATTACHMENTS

Weapon upgrades and customizations:

• Muzzle Brakes

• Scopes

• Camos (Zebra, Wood, Sessanta, etc.)

---

🎨 SPRAYS

Cosmetic tints for firearms:

• Army, Black, Gold, Green, LSPD, Orange, Pink, Platinum

---

🔋 AMMO

Ammunition for all weapon types:

• MG, Rifle, Shotgun, SMG, Pistol

---

🪓 MELEE WEAPONS

Close-range combat tools:

• Stone Hatchet

• Switchblade

• Wrench

---

🧪 Example Product Entry

Here’s a sample product structure:

luaCopyEdit{
    productname = "Advanced Rifle",
    itemname = "weapon_advancedrifle",
    productprice = 1,
    weight = "3.5kg",
    productAbout = "High-precision rifle for tactical and combat operations.",
    image = "weapon_advancedrifle.png"
}

Each product is defined with:

• productname — Display name

• itemname — Actual in-game item ID

• productprice — Price in your currency

• weight — Displayed weight (for immersion)

• productAbout — Description of the item

• image — Icon or preview path