First Test (5 minutes)

Grab one friend, a second account or a staff member. Five minutes and you will have seen the whole loop: scan, memory, quick recognition, disguise, and the admin view.

#Before you start

• Both of you on foot, outdoors, in daylight. Night, rain and fog make scans slower on purpose.
• Both of you within 5 metres, and you facing your friend (they may look anywhere, but their face is only learned while they look at you).
• Access to the server console, or a third person with recognition.admin (see Installation step 7). The admin panel never shows a pair that includes your own character.

#1. The menu

Walk up to your friend and face them.

• Press F3. A small menu opens on the left: Scan person to memory · Recognize · Camera recordings · Stop looking.
• Scan person to memory is already marked: press ENTER. A small orange arrow appears over your friend's head.
• If other people are standing around, the arrows over them are grey. ← and → switch between them, and SPACE picks up to three people at once.

Nothing on that menu or those arrows ever changes depending on whether you already know the person. That is deliberate: the screen must never leak what your character knows.

#2. The scan

Press ENTER to start on the orange arrow.

• After about two seconds your character plays a thinking pose. The other player can see it, so they know they are being studied.
• The HUD in the top-right wakes up: four cue icons and a ring. A small ring with the % also sits above your friend's head.

The ring is the reliability %. With the default weights, any two of voice, clothing and face at 100 % give you 80: the act line.

Let it run. When it finishes you will see one of:

The first time, it will say Noted.

#3. The live result

Stay near them. For the next 10 minutes the HUD keeps showing their card and updates it live while they are around. Walk 20 metres away or break line of sight for half a minute and it ends.

Try to scan them again right away and you are asked to wait: after a full scan the same pair has a 60-second cooldown (Config.Scan.PairCooldownSeconds).

#4. The quick look

Wait a minute. Then press F3, move down to Recognize with the arrow keys, press ENTER, and ENTER again on the orange arrow.

• After 2–3 seconds the answer shows: Recognized with the line your character remembers them by. No pose, no full scan.
• On somebody you have never scanned, the same look ends with You don't know him, and nothing is saved.

#5. The disguise

Now the interesting part.

1. Your friend puts on a full mask (and ideally changes their top).
2. Walk apart, come back, and scan them with Scan person to memory.

What you should see:

• The result is Noted, not Recognized, with a new line such as "Met a masked guy on Vinewood Blvd in the afternoon".
• Your original memory of them is untouched.
• You now hold a second memory: the disguised look.

That is the whole point of the script. Your character did not recognize them, and nothing on the HUD hinted that they might be someone you know.

Now scan them once more with the mask on, and have them take it off while the scan runs. It ends as Recognized, and the disguise memory folds back into the real one.

#6. Check it as staff

The quickest check is the server console. It prints what each of you remembers about the other:

recognition:check <yourId> <friendId>

For the full picture, a third staff member opens the pair view in game:

/recognition:admin <yourId> <friendId>

The panel opens on the pair. You should see:

• Both directions: what you know about them and what they know about you. They are never the same number.
• For each side, a % ring, the four cue bars, the best memory, the familiarity level and the last scan with its result.
• Small chips that tell you more, for example CAMERA for a hidden-camera scan or DISGUISE for a memory learned behind a mask.
• Three tabs: Trend (how the number moved over time), Memories (each memory, where it came from and how long it lasts) and Proofs.

#7. Optional: the mirror

Either of you can run:

/recognition:mirror

It shows how recognizable you are right now: which cues are readable, which are hidden, and the highest reliability someone could reach on you at this moment. It is the fastest way to check whether a mask, a helmet or a pair of gloves is doing what you think it is doing.

#If something did not work

Full list: Troubleshooting.