Scanning & Scoring

Two tables run the core loop: Config.Scan decides when and how fast the bars fill, Config.Scoring decides what they are worth.

#How a scan starts

#The menu (menu mode)

1. Press F3. A small box opens on the left with four options: Scan person to memory, Recognize, Camera recordings and Stop looking. Choose with the UP / DOWN arrows and press Enter. The number keys do nothing here: on most servers 1-5 are the inventory hotbar.
2. After Scan person to memory or Recognize, arrows appear over the people you face. LEFT / RIGHT move the orange one, SPACE picks up to Scan.MaxParallel people (green), ENTER starts them all at once — with nobody picked, the orange one. BACKSPACE goes back, then closes. You can keep walking while the menu is open.
3. Scan person to memory runs the normal scan (a quick recognition first, then the learning). Recognize is the 2–3 second look only: if you know the person the answer shows above their head, otherwise "You don't know him" — it never turns into a full scan and never saves anything. Recognize is not available when Config.QuickLook.Enabled = false.
4. Camera recordings lists what your hidden camera recorded in the last 24 hours, ready to print. See Devices & Reports.
5. Stop looking ends every scan and quiet look of yours at once. What was learned is saved as usual. The option is gray while nothing is running.

To start, only you have to face the person (within 90°); they may look anywhere — their face is simply not learned until they look at you.

Players can rebind all of these in GTA Settings → Key Bindings → FiveM.

#Config.Scan — conditions

AngleBands = {
    { upTo = 25, speed = 1.0 },   -- 0-25 deg: full speed
    { upTo = 70, speed = 0.5 },   -- 25-70 deg: half
    { upTo = 90, speed = 0.25 },  -- 70-90 deg: a quarter
},                                -- over 90 deg: seeing stops

#Config.Scan — speed

CueSeconds = { face = 90, clothing = 60, tattoo = 60, voice = 45 },

Seconds for one bar to go from 0 to 100 %, for a stranger, in daylight, with no camera. Set a cue to false to switch it off for the whole server — it then shows as not available rather than empty.

Everything that makes a scan slower (night, rain, fog, distance) is Config.Environment, further down this page. Everything that makes it faster is familiarity (Memory & Familiarity) and the hidden camera (Devices & Reports).

#Config.Scan — ending and saving

#Config.Scan — anti-spam

#Config.QuickLook — recognizing someone you remember

Somebody your character already remembers is recognized after a short look instead of a full scan: for about two seconds it looks like any scan, then the answer shows — Recognized with the memory's label at 80 % or more, Not sure with only the % below that. After the answer the look goes quiet (no bars, no pose): the person's voice is added when they talk, and what you keep seeing is learned and saved. A stranger, or a masked person no memory matches, gets the normal full scan. The thinking pose only plays while memorizing someone new.

Worked example. You met Bob bare-faced (face 100 + clothes 100 = 80 %). Today he wears a cap and sunglasses: Not sure 54 % (50 % for a woman) — the cap and glasses hide half the face and also count as a clothing change (Config.Clothing.FaceItemsOnce = false). He takes the glasses off: 70 %. The cap too: Recognized 80 %. Or he just starts talking and you remember his voice: +10 points every half second of speech, Recognized after about 1.5 s.

#Config.Scan — technical timings

#Config.Scoring

Points = { voice = 40, clothing = 40, face = 40, tattoo = 20 },

Reliability R = the sum of each cue's points × that cue's %, capped at Cap. With the defaults, any two of voice, clothing and face at 100 % give exactly 80 — the act line.

#The fake-voice rule in practice

FakeVoiceFactor = 0.50 means a voice heard through a changer is worth 20 of the 40 voice points. But:

• The voice bar still fills to 100. Bars show what you observed, and you observed a voice.
• The device still links two crimes to each other — one changer, one fake voice, forever.
• Only the score and the memory saved from it use the halved points.

#The recall rule in practice

RecallFullPct = 50 is what lets a second, better meeting upgrade a weak memory. A cue you remembered at 50 % or better can be fully confirmed by a clear look now; a cue you barely caught confirms proportionally less. Combined with Config.Memory.UpgradeOnRecognize, a 66 % / 2-hour memory becomes a 100 % / 5-day memory the moment you get a proper look at the person.

#Prompt and arrows

#Emotes

Each entry takes command (the emote name for your emote script, or false to always use the animation), dict, clip and flag (49 = loop, upper body only, the player can still walk).

#Weather and light — Config.Environment

Scanning is slower at night, in rain or fog, and at the edge of the scan distance. A flashlight helps. Only the visual cues slow down — the voice is never slowed.

A factor of 0.60 means the bars fill at 60 % speed, so the scan takes 1.67× longer.

Worst case with the defaults — night, rain and fog together — hits the MinFactor floor at 257 s, comfortably inside the 300 s MaxSeconds.

#Non-freemode peds

Players using a ped-menu or addon model instead of a normal MP character: