CN-ShopPVP — PvP Weapon Shop System (QB-Core + QS-Inventory)

⚔️ CN-ShopPVP — PvP Weapon Shop System for QB-Core

Deliver a smooth and balanced shopping experience for your PvP server with NPC vendors, real-time stock, and admin tools.

🎥 Showcase Video

🔑 Key Features

• Multiple configurable shops (locations, NPCs, inventories)

• Automatic restock with configurable timers

• Modern NUI (weapon images, search, categories)

• Cash payment (QB-Core integrated)

• Sell-back system (60%)

• Admin commands (manual restock)

• qb-target integration (optional)

🧩 Dependencies

• qb-core

• qs-inventory

• qb-target (optional)

🗺️ Default Shops

Black Market Weapons – Legion Square

📍 844.35, -1033.25, 28.19

Underground Arsenal – Sandy Shores

📍 -1117.32, 2698.61, 18.55

🛠️ Installation

1. Drop cn-shoppvp into your resources folder

2. Add to server.cfg: ensure cn-shoppvp

3. Put weapon images in: nui/images/ (example: weapon_pistol.png)

⚙️ Configuration (config.lua)

• Shops & NPCs

• Items, prices & stock

• Restock timers

• Sell-back percentage

• Debug mode: Config.Debug = true

🧰 Admin Command

/restockshop [shopid]

📦 Resource Structure

cn-shoppvp/

├── client/

├── server/

├── nui/

│   ├── index.html

│   ├── style.css

│   ├── script.js

│   └── images/

├── config.lua

└── fxmanifest.lua

❓ FAQ

Q: NPCs not spawning?

A: Check coords, models, and qb-target if enabled.

Q: Images not loading?

A: Filenames MUST match item names exactly.

Q: Shop won't open?

A: Ensure Config.UseTarget = true if you rely on qb-target.

📜 License

Provided as-is for FiveM servers using the QB-Core framework.