mad-cipherheist

Introduction

Dive into an immersive heist experience unlike any other. Follow a gripping storyline as you acquire crucial components, hack into secure terminals, and decipher cryptic messages to uncover the truth behind a mysterious signal. Are you ready to embark on a daring mission filled with excitement and suspense?

Preview

Youtube

Dependencies:

• mad-map-cipherheist (included)
• qb-core
• qb-doorlock
• qb-target
• ps-ui
• pengu_digiscanner
• glow_minigames
• utk_fingerprint
• hacking (included)
• ps-dispatch for police alerts
• qb-phone (qs-smartphone is also supported)
• (Optional)Patoche-AnonymousMLO (need to move a location if you don't use this)
• (Optional)keep-crafting (for optional loot items)
• (Optional)mz-hacks (for optional loot items)
• Resource tested using qb-inventory/lj-inventory

Recommended load order

• Dependencies must load before mad-cipherheist. I recommend you setup your load order as such:
• Place all dependencies in [standalone] - as well as the included hacking folder.
• Place [mad-cipherheist] & [mad-map-cipherheist] in [madcap] folder.
• Ensure resources in server cfg:

ensure [qb]
ensure [standalone]
ensure [madcap]

INSTALL

• Copy and paste the items below into your shared items, example: qb-core/shared/items.lua

------------------------
-- MADCAP CIPHERHEIST -- 
------------------------

-- Digiscanner items
scanner_antenna         = { name = "scanner_antenna",       label = "Scanner Antenna",  weight = 500,   type = "item",                        image = "madantenna.png",                 unique = true,      useable = true,     shouldClose = true,     combinable = nil, description = "A high-frequency antenna designed for the digital scanner, enhancing signal reception." }, 
scanner_screen          = { name = "scanner_screen",        label = "Scanner Screen",   weight = 500,   type = "item",                        image = "maddigiscreen.png",              unique = true,      useable = true,     shouldClose = true,     combinable = { accept = { 'scanner_antenna' }, reward = 'weapon_digiscanner', anim = { dict = 'anim@amb@business@weed@weed_inspecting_high_dry@', lib = 'weed_inspecting_high_base_inspector', text = 'Attaching antenna', timeOut = 10000 } }, description = "An advanced digital display unit, integral to the functionality of the digital scanner." },
weapon_digiscanner      = { name = "weapon_digiscanner",    label = "Digiscanner",      weight = 1000,  type = "weapon", ammotype = nil,      image = "madweapon_digiscanner.png",      unique = true,      useable = true,     shouldClose = true,     combinable = nil, description = "A powerful Digiscanner featuring a built-in HUD for enhanced signal tracking and analysis." },

-- Hack items
terminalusb             = { name = "terminalusb",           label = "Cipher USB",      weight = 1000,  type = "item",     image = "madusb.png",      unique = true,      useable = false,     shouldClose = false,     combinable = nil,    description = "USB containing backdoor: \"://cipher_protocol_ZNCDO/\" " },

-- Heist items
cipherfragment1           = { name = "cipherfragment1",         label = "Cipher Fragment",     weight = 0,     type = "item",   image = "madcipher1.png",     unique = true,    useable = false,     shouldClose = false,   combinable = nil,   description = "Captured samples of wireless signals, essential for unlocking encrypted data",   created = nil,  decay = 0.04166666667 }, -- 1 hour
cipherfragment2           = { name = "cipherfragment2",         label = "Cipher Fragment",     weight = 0,     type = "item",   image = "madcipher2.png",     unique = true,    useable = false,     shouldClose = false,   combinable = nil,   description = "Captured samples of wireless signals, essential for unlocking encrypted data",   created = nil,  decay = 0.04166666667 }, -- 1 hour
cipherfragment3           = { name = "cipherfragment3",         label = "Cipher Fragment",     weight = 0,     type = "item",   image = "madcipher3.png",     unique = true,    useable = false,     shouldClose = false,   combinable = nil,   description = "Captured samples of wireless signals, essential for unlocking encrypted data",   created = nil,  decay = 0.04166666667 }, -- 1 hour
cipherfragment4           = { name = "cipherfragment4",         label = "Cipher Fragment",     weight = 0,     type = "item",   image = "madcipher4.png",     unique = true,    useable = false,     shouldClose = false,   combinable = nil,   description = "Captured samples of wireless signals, essential for unlocking encrypted data",   created = nil,  decay = 0.04166666667 }, -- 1 hour
decryptedtransmissions    = { name = "decryptedtransmissions",  label = "Decrypted Transmissions", weight = 0, type = "item",   image = "maddata.png",        unique = true,    useable = false,     shouldClose = false,   combinable = nil,   description = "Deciphered wireless transmissions containing valuable data.",                    created = nil, decay = 0.12500000001 }, -- 3 hours

-- Loot items
trackedloot           = { name = "trackedloot",         label = "Signal-Emitting Military Case",     weight = 50000,     type = "item",     image = "madtrackedloot.png",     unique = true,    useable = true,     shouldClose = true, combinable = nil,   description = "A military-style case emitting a signal, requiring decryption to remain undetected", created = nil, decay = 0.12500000001 }, -- 3 hours
untrackedloot         = { name = "untrackedloot",       label = "Military Case",                     weight = 50000,     type = "item",     image = "maduntrackedloot.png",     unique = true,    useable = true,     shouldClose = true, combinable = nil,   description = "A secured military case, now free of any tracking signals after successful decryption" },

• Copy and paste the weapon below into your shared weapons, example: qb-core/shared/weapons.lua

[`weapon_digiscanner`]              = { name = 'weapon_digiscanner', label = 'Digiscanner', weapontype = 'Melee', ammotype = nil, damagereason = 'Melee killed / Whacked / Executed / Beat down / Murdered / Battered' },

• Copy and paste all images the INSTALL/InventoryImages into your inventory ...html/images folder

• Copy and paste the INSTALL/qb-doorlock/mad-cipherheist.lua file into your qb-doorlock/configs folder

• Copy and paste the INSTALL/interact-sound/casebeep.ogg file into your interact-sound/client/html folder

• Add this to your ps-dispatch/client/alerts.lua

-- MadCap CipherHeist
local function MadCapCipherHeist()
  local coords = GetEntityCoords(cache.ped)
  local dispatchData = {
      message = 'Beacon Signal Activated',
      codeName = 'madcapcipherheist',
      code = '10-90',
      icon = 'fa-solid fa-tower-broadcast',
      priority = 2,
      coords = coords,
      street = GetStreetAndZone(coords),
      heading = GetPlayerHeading(),
      jobs = { 'leo' }
  }
  TriggerServerEvent('ps-dispatch:server:notify', dispatchData)
end
exports('MadCapCipherHeist', MadCapCipherHeist)

• Add this to your ps-dispatch/shared/config.lua

-- MadCap CipherHeist
['madcapcipherheist'] = {
    radius = 0,
    sprite = 767,
    color = 1,
    scale = 1.5,
    length = 2,
    sound = 'Lose_1st',
    sound2 = 'GTAO_FM_Events_Soundset',
    offset = false,
    flash = false
},

• Optional Add this to your backitems resource (example: devyn-backitems/BackItems.lua)

-- MadCap CipherHeist TrackedLoot
['trackedloot'] = {
    model='hei_prop_heist_thermite_case',
    back_bone = 24818,
    x = -0.14635964953322,
    y = -0.20835228853177,
    z = -0.030527457423312,
    x_rotation = -95.531095095841,
    y_rotation = 87.419314981763,
    z_rotation = 4.5446930554476,
},
-- MadCap CipherHeist UntrackedLoot
['untrackedloot'] = {
    model='hei_prop_heist_thermite_case',
    back_bone = 24818,
    x = -0.14635964953322,
    y = -0.20835228853177,
    z = -0.030527457423312,
    x_rotation = -95.531095095841,
    y_rotation = 87.419314981763,
    z_rotation = 4.5446930554476,
},

• Optional Edit glow_minigames/html/js/main.js startEndScreens:

line 16

start: 'Network encrypted, user bypass required..',

line 18

success: 'Network successfully decrypted.',

• You can remove the INSTALL folder once you've completed these steps if you wish.

Heist Overview:

This heist involves collecting cipher fragments, merging them, and using the result to locate and retrieve a valuable item guarded by a tracker. Players must evade police and disable the tracker through sequential hacks.

Preparation:

• Items: Acquire a Cipher USB, Scanner Antenna, Scanner Screen, Trojan USB, Electronic Kit, and Scuba Tank with Oxygen Refills.

Steps:

• Combine Scanner: Combine Antenna and Screen to create a Digiscanner.
• Hack Electric Panel: Use Trojan USB and Electronic Kit at Fort Zancudo Military Base to access the tower.
• Hack Terminal: Use the Cipher USB (consumed) at the top of the tower to receive an email with instructions and a map blip leading to the Merryweather facility.
• Find Signals: Use the Digiscanner at each location to pinpoint and hack exposed signals (4 required). Each successful hack grants a Cipher Fragment (limited to 1 hour duration).
• Merge Fragments: Go to the anonymous hacking group's den and use their computer to merge fragments. Another hack consumes the fragments and gives you "Decrypted Transmissions".
• Activate Beacon: Use Decrypted Transmissions to trigger a temporary radius blip indicating the prize location underwater.
• Retrieve Prize: Dive deep underwater to find the sunken narco submarine and its nearby crate. Interact with the Beacon to obtain the "Signal-Emitting Military Case".
• Escape and Disable Tracker: Evade police while the case emits a signal visible to them. Interact with the case to start 3 sequential hacks with a configurable cooldown in between. Successfully complete all 3 to disable the tracker.
• Enjoy the Loot: Open the case for various rewards including blueprints, weapons, and other valuable items.

Resmon:

• 0ms when heist isn't active.
• 0ms while doing heist setup.
• 0.1ms when loops are running (trackedloot blips and beep loops are active)

Note

This resource was originally created for my own FiveM Server, and I had no plans on releasing it. The code could use improving, and there are certainly better ways to do things than I have chosen. The main section that could use more work is the tracked loot blips (displaying to on duty police). The idea was always to have a blip displayed on the location of the tracked item, but I never got around to making it work properly.