Hack Types

A hack type is the surface a hack point uses. Each one is a preset in cfg.hacks.types that binds a world prop, an animation, a placement mode and a set of on-screen behaviour. Six ship in, and adding a seventh is a config entry not a code change.

Every type is picked from the dropdown in /create_minigame, or referenced by its key in a hand-written data/saved_minigames.lua entry.

---

fingerprint

Fullscreen minigame with a USB and phone sync-scene playing in front of the player.

cfg.hacks.types.fingerprint = {
    propModel = 'ch_prop_fingerprint_scanner_01e',
    animDict  = 'anim_heist@hs3f@ig1_hack_keypad@arcade@male@',
    objects   = { 'ch_prop_ch_usb_drive01x', 'prop_phone_ing' },
    scenes    = { ... 4 scenes ... },
    timings   = { intro = 4000, loop = 2000, outcome = 5000 },
    placement = 'screen',
}

The scenes list drives a four-stage NetworkSynchronisedScene:

1. intro (action_var_01), USB goes in, minigame is not visible yet.

2. loop (hack_loop_var_01), phone and USB idle, minigame is on screen.

3. success (success_react_exit_var_01), player pulls the USB back out.

4. fail (fail_react), player throws the USB and swears.

timings.intro/loop/outcome control how long the ped stays in each pose. The minigame runs during loop, so the outcome anim only starts once the player succeeds or fails.

Use it for: classic hack-into-a-terminal moments where you want a full scene, not just a UI.

---

laptop

Same idea as fingerprint, but heavier. Wall panel, laptop, bag and hack card, with a three-stage scene.

cfg.hacks.types.laptop = {
    propModel = 'hei_prop_hei_securitypanel',
    animDict  = 'anim@heists@ornate_bank@hack',
    objects   = { 'hei_p_m_bag_var22_arm_s', 'hei_prop_hst_laptop', 'hei_prop_heist_card_hack_02' },
    scenes    = { ... 3 scenes ... },
    timings   = { intro = 6300, loop = 2000, outcome = 4600 },
    placement = 'screen',
}

Player drops a bag, sets up the laptop, plays the minigame, then packs everything back up. Longer intro means it feels weightier than fingerprint, so use it for the payoff hack in a heist rather than every terminal.

---

tablet

The player's own tablet pops out on E and the minigame is drawn onto the tablet screen. No fullscreen overlay, no sync-scene, just the player standing in place holding a tablet.

cfg.hacks.types.tablet = {
    propModel = 'ch_prop_fingerprint_scanner_01e',
    placement = 'prop',
    preset    = 'tablet',
}

The world marker (propModel) is only there for the interaction range. Once the player presses E, the tablet from cfg.propPresets.tablet takes over.

Use it for: discreet hacks that should not attract attention, or for handheld reads on a device (guard's tablet, delivery scanner, and so on).

---

tablet_wall

A wall-mounted tablet, drawn onto the world prop itself instead of pulled into the player's hand. Camera slides in for a close read, minigame lives on the wall.

cfg.hacks.types.tablet_wall = {
    propModel     = 'rm_tablet_02',
    placement     = 'monitor',
    monitorPreset = 'tabletWall',
}

Uses renderMode = 'quad' under the hood, so no texture is globally replaced and every rm_tablet_02 in the world stays untouched.

Use it for: control-room panels, apartment door tablets, mounted diagnostics screens.

---

laptop_open

A closed laptop sits in the world. On E, it opens, the camera slides in, and the minigame appears on the screen.

cfg.hacks.types.laptop_open = {
    propModel       = 'p_laptop_02_s',
    networked       = true,
    animDict        = 'switch@franklin@on_laptop',
    animName        = '001927_01_fras_v2_4_on_laptop_exit_laptop',
    defaultAnimTime = 1.0,   -- 1 = closed
    hackAnimTime    = 0.0,   -- 0 = open
    replaceTexture  = 'script_rt_tvscreen',
    placement       = 'monitor',
    monitorPreset   = 'laptop',
}

defaultAnimTime and hackAnimTime are anim phase values, not durations. The laptop lives frozen at defaultAnimTime until a player interacts, at which point it slides to hackAnimTime and back on close.

networked = true means the server spawns the prop and syncs it to every client through a state bag, so all players see the same open / closed state.

Use it for: desktop workstations, tech-lab machines, anywhere the laptop should be part of the scenery until someone uses it.

---

monitor

A world monitor. E slides the camera in, the screen turns into the minigame via AddReplaceTexture.

cfg.hacks.types.monitor = {
    propModel      = 'sf_prop_sf_monitor_01a',
    networked      = true,
    replaceTexture = 'prop_monitor_fib_01_d',
    placement      = 'monitor',
}

Use it for: CCTV consoles, security desks, arcade machines, dispatch terminals.

AddReplaceTexture is model-global. Every instance of sf_prop_sf_monitor_01a in the streamed world will show the minigame while the hack is running. That is fine when only one instance is placed per area, and it is why the shipped tablet_wall type uses quad-render instead.

---

Field reference

Field	Applies to	Meaning
propModel	all	World prop hash
placement	all	screen, prop or monitor
preset	prop	Key in cfg.propPresets
monitorPreset	monitor	Key in cfg.monitorPresets
networked	monitor	true = server-spawned + state-bag synced
animDict/animName	fingerprint, laptop, laptop_open	Prop or ped anim
defaultAnimTime	laptop_open	Phase 0..1 when idle
hackAnimTime	laptop_open	Phase 0..1 while hacking
replaceTexture	monitor (non-quad)	Texture key on the model to overwrite
objects	fingerprint, laptop	Extra props spawned for the sync-scene
scenes	fingerprint, laptop	Ordered list of animation names per scene
timings	fingerprint, laptop	intro, loop, outcome durations in ms
onSuccess/onFail	all	Per-type default hooks. Per-point overrides win

---

Adding a new type

1. Add a new key under cfg.hacks.types with the fields above.

2. Add { value = 'yourType', label = 'Your Type' } to the HACK_TYPES list at the top of client/creator.lua so it appears in the dropdown.

3. Restart the resource.

The framework picks it up automatically. Server-spawned entities only need networked = true, the server handles the spawn and state bag on its own.

If you need a placement that is not screen, prop or monitor, you also need a branch in runMinigame in client/client.lua.