🤠 ns-pedrobbery — Aim-based NPC robbery system for RedM
Aim a non-blacklisted weapon at any NPC and they pick one of three reactions on the spot — hands up, run, or draw. Surrendered or downed peds open a western-themed search NUI that reveals items one by one. Every loot
mutation is server-authoritative: distance checks, NetworkId-bound stash records, per-loot mutex to stop double-looting. Cross-framework — VORP, RSG-Core or RedEM:RP auto-detected through ns-lib.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔫 Aim-based reactions — surrender / flee / fight, weighted percentages that sum to 100, with optional aim-hold delay for deliberate hold-ups
🚓 Aggressive models always fight — lawmen, deputies, sheriffs, Pinkertons skip the random roll; list extendable by model name or hash
🏹 Weapon blacklist — knife, bow, lasso, torch, unarmed → no reaction (hunt with a bow without holding up every civilian)
🐎 Mount and coach aware — peds dismount before surrendering, stay mounted to ride away or shoot from horseback
🎒 Animated search NUI — grid layout, per-item reveal timer, take-one or take-all, inventory icons auto-detected (VORP / RSG / ox)
🎭 Configurable search animations — anim or scenario kind, list multiple per state (alive vs dead/hogtied), random one rolled per robbery
🎁 Per-model loot overrides — lawmen drop medicine + coal, gang members drop ammo + cash, civilians drop the default pool
🎲 Two loot modes auto-detected — chance-based (each entry rolls independently) or pick-1-to-3 (random items from the pool)
🛡️ Server-authoritative anti-cheat — every requestLoot / takeItem / takeAll runs a server-side distance check against the ped's NetworkId
🔒 NetworkId-bound loot record — same ped resolves to the same items across all clients; concurrent looters blocked by lockedBy mutex
🤝 Surrender auto-release — released when the player walks away or the stash is fully looted
⚙️ Per-source cooldown — stops loot spam without breaking legit play
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛠️ EASY TO CUSTOMIZE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ One config file — config.lua — holds reaction odds, aggressive model list, weapon blacklist, loot tables, search anims, distances, cooldowns
✅ Per-model loot via Config.ModelLoots — drop in any model name or hash with its own loot pool
✅ Switch search animations to scenarios (bench, lean, inspect) or back to clip-based animations in one config line
✅ No SQL required — loot state is in-memory only, server restart is a clean reset
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 WHAT YOU GET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔒 Escrow-protected on FiveM Keymaster
📁 Open config file (config.lua) — every tunable knob editable
📘 Detailed README + config reference + scenario list link
🆓 Free lifetime updates
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ INSTALLATION (60 seconds)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1️⃣ Install ns-lib first (free dependency)
2️⃣ Drop ns-pedrobbery/ into resources/
3️⃣ Add ensure ns-lib then ensure ns-pedrobbery to server.cfg
4️⃣ (Optional) Edit config.lua — reaction odds, loot tables, anims
5️⃣ Restart — done!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧰 COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔥 RedM — VORP, RSG-Core, RedEM:RP (auto-detected via ns-lib)
🔥 Requires ns-lib — free, included in the Native Scripts catalogue
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Need help? Join our Discord:
👉 https://discord.gg/UyyngemnF8
