What is FR Thief?

FR Thief (v1.0.0) is FiveRank's professional mugging and robbery system for FiveM. The first to integrate all four FR libraries at once: fr_interact for the floating prompt, fr_menu for the action selector, fr_progressbar for the progress bar, and fr_notify for result feedback. Compatible with ESX, QBCore and standalone.

Four FR libraries. One robbery system.

---

How it works

1. Player walks near an NPC or player (within Config.ScanDistance).
2. The floating "Press E" prompt from fr_interact appears.
3. Pressing E opens the fr_menu action selector.
4. Player selects an action → fr_progressbar shows the animated bar.
5. Bar completes → server validates, gives loot, fr_notify shows result.

---

Five robbery actions

Action	Duration	Loot
Search pockets	4 s	Cash + items (chance)
Steal wallet	6 s	Guaranteed cash
Search everything	10 s	Maximum loot
Rob cash (players)	5 s	% of player's cash
Take items (players)	7 s	Items from inventory

Key features

• Automatic scan for nearby NPCs and players — no commands needed
• Blocked model list — police and security NPCs are never valid targets
• Per-ped (5 min) and per-player (2 min) cooldowns to prevent spam
• Server-side validation with 10-second debounce anti-spam
• Player robbery: steals a random % of their cash — notifies both parties
• Configurable police alert: flashing blip + GTA crime after robbery
• Compatible with ESX, QBCore and standalone
• Fully bilingual: EN and ES included

---

Dependencies

Resource	Role
fr_interact	Floating "Press E" prompt on the target
fr_menu	Action selection menu
fr_progressbar	Robbery progress bar
fr_notify	Result notifications

All four are required. They are part of the [fr] group — ensure [fr] loads all of them.

---

Credits

• Author: FiveRank Team · License: Free for community use
• Website: https://fiverank.gg · Docs: https://docs.fiverank.gg