🛒 ns-shops — Cross-framework vendor shops for RedM
Walk up to a shopkeeper NPC, press G, and buy items with cash or gold. Nine default shops (three general stores, three gunsmiths, three saloons) drop in immediately — keep them, move them, replace them, the choice is in
one config file. Open-source SKU: every Lua, HTML, CSS and JS file ships plaintext, edit freely.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏪 9 default shops out of the box — 3 general stores, 3 gunsmiths, 3 saloons, all spread across the map
🎯 G prompt or rsg-target eye — pick the interaction style per server in Config.Target
💵 Cash and gold pricing — each item carries both prices, hide gold if you don't use it
🕒 Per-shop opening hours — set globally in Config.Hours or override on a single shop's entry
📦 Per-shop stock — every shop has its own catalog and stock counts, no shared inventory between locations
🤝 Auto VORP ↔ RSG-Core item key mapping — default items resolve automatically on both frameworks
🪟 Modern glassmorphism shop UI — RDR2 visual language, parchment + brass + frosted glass
🔓 Open source — no escrow, edit any file directly
⚛️ React-based menu — prebuilt UI ships in html/, rebuild from ui/ only if you change the source
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛠️ EASY TO CUSTOMIZE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ One config file — config.lua — holds every shop (id, coords, ped, categories, hours) and every item (price.cash, price.gold)
✅ Copy any shop entry and tweak id + coords to spin up a new location in seconds
✅ Per-item VORP↔RSG mapping lives in server/itemmeta.lua — add your custom items there
✅ Rebuild the UI only if you touch the React source — npm run build writes back into html/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 WHAT YOU GET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔓 Open source — every Lua, HTML, CSS, JS file plaintext, modify any part of the script
📁 No escrow encryption — adapt to your server without limits
📘 Detailed README + per-shop config reference
🆓 Free lifetime updates
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ INSTALLATION (60 seconds)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1️⃣ Install ns-lib first (free dependency)
2️⃣ Drop ns-shops/ into resources/
3️⃣ Add ensure ns-lib then ensure ns-shops to server.cfg
4️⃣ (Optional) Edit config.lua — move shops, change prices, set hours
5️⃣ Restart — done!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧰 COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔥 RedM — VORP or RSG-Core (auto-detected via ns-lib)
🔥 Requires ns-lib — free, included in the Native Scripts catalogue
🔥 Optional: rsg-target — switch the G prompt to an eye-target interaction
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Need help? Join our Discord:
👉 https://discord.gg/UyyngemnF8
