Skip to content

VNS USB System

A hack-and-fight mission script for FiveM. Players use a colored USB item, hack a network through a hacking minigame, then drive to a marked location, fight off armed NPC guards and steal the loot for item rewards. Each USB color is its own mission tier with its own location pool, NPC strength and rewards.

One resource runs on QBCore, QBox and ESX. Framework, inventory, usable items, progress bar and notification support comes from vns-core. The hack uses mhacking by default.

Feature overview

  • Per-color missions - every USB item in Config.Reward is a usable item that starts its own mission: which location pool it draws from, which ped models spawn, which weapon tier they carry, whether headshots kill them, and which items it pays out.
  • Location pools - three built-in position categories with 44 hand-placed locations, each with its own NPC spawn points. A location in use by another player is skipped.
  • Weapon tiers - three NPC weapon pools, from pistols up to military rifles and the combat MG.
  • Loot rules per color - either every item on the list is given (with a random amount between min and max), or one random item from the list.
  • Shared cooldown - one per-player cooldown across all USB colors, enforced on the server and started only once a mission really begins.
  • Server-side rewards - the server only pays the reward of the USB it registered for that player's mission, once, and only near the mission location.
  • Swappable minigame - replace mhacking with any hacking resource through one hook.
  • Multi-language - all player-facing strings live in locales/.

How a mission plays out

  1. The player uses a USB item. If their cooldown is still running or a mission is already active, they are told to try later.
  2. A free location is picked and the USB is consumed. An 8-second "Connecting" phase runs, then the hacking minigame starts.
  3. On a successful hack the mission begins: the cooldown starts and a blip with a GPS route appears at the location. A failed hack ends it - the USB is gone, but no cooldown is applied.
  4. When the player gets within 150 m, the area is cleared and armed NPCs spawn at the location's spawn points. They guard the loot and attack the nearest player.
  5. At the marker the player presses E and steals for 5 seconds, then the server rolls the reward items and the location is freed.

The USB is consumed before the hack

The USB item is removed as soon as a free location is found - before the minigame. Failing the hack means the USB is lost. Price your USBs with that in mind.

Open vs Encrypted

The script ships in an Open and an Encrypted variant. In the Encrypted variant config.lua, the locales folder, client/client_open.lua and server/server_open.lua stay editable - missions, rewards, locations, NPC tuning, texts and the minigame hook live there.