🎒 ns-kits — Configurable kit menu with Discord-role gating for RedM
Ten kit categories out of the box — three free (Starter / Daily / Weekly), three Discord-role-gated (Member / Streamer / Booster) and four premium-rank tiers (VIP / Gold / Premium / Diamond). Per-kit cooldowns persisted
in MySQL, Discord role checks via the ns-lib bot, RDR2-styled menu built in React. Cross-framework — auto-detected through ns-lib on VORP, RSG-Core, RedEM:RP, ESX or QBCore.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎁 10 kit categories — Starter (once per character), Daily, Weekly, Member, Streamer, Booster, VIP, Gold, Premium, Diamond
⏳ Per-kit cooldowns — set in seconds (24h, 7d, "once per character", whatever you want), persisted in MySQL
🛡️ Discord role gating — role IDs map to kit IDs in config; players without the role never see locked kits as available
🤖 Shared Discord bot via ns-lib — token and guild ID configured once, every Native Scripts resource reuses it
💰 Cash + items per kit — give weapons, ammo, food, consumables, money in any mix
🎨 Western RDR2-themed menu — Rye + Crimson Text + JetBrains Mono fonts, parchment background, 10 SVG icons, 9 accent rail colors
⚛️ React 18 menu, zero CDN — React, ReactDOM and all fonts ship locally under html/vendor/ and html/fonts/, works on offline servers
🗄️ MySQL persistence — ns_kits_claims table auto-created on first start; reset queries documented in README
🛠️ Toggle any kit off — set enabled = false in config and the menu hides it, server rejects claims
⌨️ Configurable command — /kit by default, override via Config.OpenCommand
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛠️ EASY TO CUSTOMIZE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ One config file — config.lua — holds every kit (id, label, cooldown, items, money, accent, icon, role gate)
✅ Copy-paste template at the top of Config.Kits, plus a field reference for every key
✅ Item keys are plain strings — swap VORP defaults for your RSG / QBCore / ESX / RedEM:RP item names directly
✅ Add new SVG icons or accent colors by following the html/README.md instructions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 WHAT YOU GET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔒 Escrow-protected on FiveM Keymaster
📁 Open config files for full customization (config.lua, utils, discord wiring, db, NUI styles)
📘 Detailed README + Discord setup guide + html/README.md for NUI customization
🆓 Free lifetime updates
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ INSTALLATION (60 seconds)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1️⃣ Install ns-lib first (free dependency) — configure the Discord bot token and guild ID once
2️⃣ Drop ns-kits/ into resources/
3️⃣ Add ensure ns-lib then ensure ns-kits to server.cfg
4️⃣ Edit config.lua — paste Discord role IDs, tune kit contents, disable kits you don't run
5️⃣ Restart — done!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧰 COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔥 RedM — VORP, RSG-Core, RedEM:RP, ESX, QBCore (auto-detected via ns-lib)
🔥 Requires ns-lib — free, included in the Native Scripts catalogue
🔥 Requires oxmysql or mysql-async — for cooldown persistence
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Need help? Join our Discord:
👉 https://discord.gg/UyyngemnF8
