Features

Anon

Notices, the hacker terminal and anonymous rooms on the GhostNet card.

Anon is an underground app that only opens with the second SIM. Every player who has one reads the announcements board (the Notices tab) and, by default, can write on it. Players with the hacker permission also get a terminal with a code breaking game and commands that find, check and trace phone numbers. Anonymous chat rooms can be switched on as well; they are off by default.

Part Who sees it What it is
Notices Everyone with a working second SIM A board of short announcements. By default every player with a handle can write on it; Notes.Everyone = false keeps writing to hackers
Terminal Hackers only (Config.Anon.Hacker) The crack game, ranks, and the scan, ping, lookup and trace commands
Rooms Everyone with a working second SIM, only with Config.Anon.Rooms.Enabled = true Anonymous chats that stay open for a set time, or for good

With the default config a normal player sees one tab, Notices. A hacker sees Notices and Terminal. With rooms switched on, Rooms is added as the first tab and the app opens on it.

Everything is in Config.Anon. How the second SIM itself works (the GhostNet card: the item, the days, putting it in from Settings > SIM) is in SIM cards.

#Access

#The second SIM

anon is in Config.SecondSim.Apps by default. Without a working second SIM the app shows SIM Not Authorized instead of opening, and the server refuses every Anon request. When the card expires or is switched off, the app closes again.

Remove 'anon' from Config.SecondSim.Apps and Anon opens for everyone, with no card needed.

Anon is not installed on new phones (default = false in Config.Apps). Players install it from the App Store.

#The handle

The first time a player opens Anon they pick a handle, the name the network knows them by: 3 to 16 characters, letters, digits and _. It is stored in lower case, must be unique, and cannot be changed later. Rooms, notices and the terminal all use the same handle. Nothing else about the player is shown.

#Who is a hacker

luaHacker = { Jobs = { 'hacker' }, Ace = 'fxphone.hacker', Admins = true, Everyone = false },

A player is a hacker when any of these is true:

Field Default Meaning
Jobs { 'hacker' } The player's job is in this list
Ace 'fxphone.hacker' The player has this ace, e.g. add_ace group.hacker fxphone.hacker allow in server.cfg
Admins true Admins count as hackers: the fxphone.admin ace, or a framework admin
Everyone false true: every player with the second SIM gets the terminal

It is checked on every request, so a job change counts at once. A player who loses the permission while the terminal is open is sent back to the first tab.

Hackers also have extra powers outside the terminal: they can take down anyone's notice, their own notices do not count toward the per-player limit, and, when rooms are on, they can close any room.

#Rooms

Rooms are off by default (Rooms.Enabled = false). Set Config.Anon.Rooms.Enabled = true to bring the Rooms tab back. While they are off, the tab is not shown and the server refuses every request to open, enter or write in a room.

A room is an anonymous chat with a topic. Everyone writes under their handle.

  1. On the Rooms tab the player taps Open a Room, types a topic (3 to 60 characters) and picks how long it stays open: one of Rooms.Durations (in minutes, from 15 minutes up to 5 days by default), or Permanent when Rooms.Permanent is on.
  2. The room shows in every Anon player's list with its owner's handle, the time left and the number of messages.
  3. Anyone can enter and write. A message is up to Rooms.MessageMax characters. Entering a room shows its last Rooms.History messages.
  4. When the time is up, the room closes for everyone.

Instead of text, a player can share a Darkchat channel: its tag and, if they want, its password. The room shows it as a card the readers can copy from. This is how a Darkchat channel gets passed around.

#Closing and deleting

  • A timed room closes when its time is up. Rooms are checked once a minute, so it can stay open up to a minute longer.
  • The owner can close their room at any time with Close Room. A hacker can close any room.
  • A permanent room stays until its owner or a hacker closes it, or until nobody has written in it for Rooms.PermanentIdleDays days. With PermanentIdleDays = 0 a quiet permanent room is never closed.
  • A closed room and everything written in it are deleted Rooms.KeepClosedHours hours later.

#Limits

  • A player can have Rooms.PerPlayer rooms open at a time.
  • At most Rooms.MaxOpen rooms can be open on the server.
  • Permanent rooms count toward both limits like any other room.

When a limit is reached the player gets "limit reached. try again later."

#Notices

The Notices tab is a board of short announcements (3 to 280 characters each). Every Anon player reads them. With Notes.Everyone = true (the shipped value) every player with a handle can write one; with false only hackers can. A player can take their own notice down, and a hacker can take down anyone's. Notices work whether rooms are on or off; with rooms off, Anon opens on this tab.

A notice stays up Notes.Hours hours. One player can have Notes.PerPlayer notices up at a time (hackers are not counted), and at most Notes.Max notices can be up in total; after that, new ones are refused until one runs out or is deleted.

#The terminal

Hackers get an extra tab, Terminal. Commands are typed or tapped from the row of buttons under the screen. Commands the player's rank has not opened yet are shown locked.

#Ranks and XP

XP raises the player's rank. Ranks lists the XP each rank needs, lowest first; everyone starts on the first one. Each command needs a rank, so a new rank opens new commands. The terminal header shows the rank and a bar to the next one.

Rank XP Title (default)
1 0 Script Kiddie
2 25 Operator
3 75 Ghost
4 150 Phantom
5 300 Architect

XP comes from the code game and from every successful command. Other scripts can pay XP too, for example after a heist, with AddAnonXp; GetAnonProfile reads a player's handle, rank and XP. See Server exports: SIM.

#The code game (crack)

crack starts a code of Crack.Digits digits, all different. The player has Crack.Tries guesses. After each guess every digit box changes colour:

Colour Meaning
Green Right digit, right place
Yellow The digit is in the code, but somewhere else
Dim The digit is not in the code
  • Solved: the player earns Crack.Xp plus one XP for every guess left over.
  • Failed: the code is shown and the player earns Crack.FailXp.
  • A player can start Crack.PerHour games in any hour. Typing exit leaves the code waiting; the next guess carries on. An open code is lost when the player leaves the server.

Digits is kept between 3 and 6 and Tries between 3 and 12, whatever the config says.

#Commands

Command Default rank Cooldown XP What it does
scan 1 60 s 1 Lists the phones within Radius metres (default 30.0) with their distance, nearest first, at most 12. Below the Reveal rank (default 3) the last three digits of each number are hidden
ping <number> 2 30 s 1 Says whether that number's phone is on. A phone in airplane mode, or whose owner is offline, does not answer
lookup <number> 3 300 s 3 Shows the name the number is registered to, and whether they are on the network. With SIM cards on (Config.Sim.Enabled) that is the SIM's registered owner, and a prepaid SIM shows "unregistered line"; without them it is the character the number belongs to
trace <number> 4 900 s 6 Puts a zone on the map that the phone is somewhere inside, for Seconds seconds

Other commands, always available to hackers: help, whoami (handle, rank, XP, codes broken), ranks (every rank and what it opens), top (the ten handles with the most XP), sim (the line and its time left), clear.

A cooldown starts only after a command worked. Commands that fail (no such number, target offline) cost nothing.

#trace in detail

luatrace = { rank = 4, cooldown = 900, xp = 6, Radius = 120.0, Jitter = 70.0, Seconds = 60, WarnTarget = true },
  • The target must be online. A phone that is off the server gives "the target is off the network."
  • The zone is a circle of Radius metres. Its centre is moved away from the phone by up to Jitter metres, so the phone is inside the circle but not in the middle of it. Jitter is never more than 80 % of Radius, and Radius is at least 20.
  • The circle is green on the pause map and the minimap, with a Trace Zone pin. It fades over its last ten seconds and disappears after Seconds seconds. Only the hacker who ran the trace sees it.
  • With WarnTarget = true the traced player gets a Security Alert notification: "Unusual activity was detected on your line. Someone may be looking for your location." The hacker's terminal then also says the target may have seen a warning; with WarnTarget = false it says nothing about one.
  • With fx-3dmap running, the zone's pin is also shown on the 3D map in the Config.Map3D.TempCategory category. fx-3dmap has no circles, so there it is only the pin. See Map integration.

#Protected jobs

ProtectedJobs lists jobs that cannot be looked up or traced, for example { 'police' }. A lookup or trace on someone with such a job answers "the target is on an encrypted line. no access." This holds whether they are online or not: for an offline player the job the phone last saw them in is used. With SIM cards on, a lookup is also refused when the SIM is registered to someone with a protected job. Their phones still appear in a scan, but always with hidden digits, whatever the hacker's rank. ping still works on them.

#Changing a command

Each command's rank, cooldown and xp can be changed, and so can the extra fields shown above. Set a command to false (or give it enabled = false) to remove it from the terminal. New commands cannot be added from the config: only scan, ping, lookup and trace exist.

#Options

Option Default What it does
Hacker see Who is a hacker above Who gets the terminal
Rooms.Enabled false true adds the Rooms tab. false: notices only (and the terminal for hackers)
Rooms.Durations { 15, 60, 360, 1440, 4320, 7200 } Minutes a room can be opened for (1440 = 1 day, 4320 = 3 days, 7200 = 5 days)
Rooms.Permanent true Also offer rooms that never run out
Rooms.PermanentIdleDays 14 A permanent room nobody writes in for this many days is closed. 0: never
Rooms.PerPlayer 2 Open rooms per player
Rooms.MaxOpen 30 Open rooms on the server
Rooms.MessageMax 300 Characters per message (kept between 40 and 500)
Rooms.History 80 Messages shown when a room is entered (kept between 20 and 200)
Rooms.KeepClosedHours 24 Hours before a closed room and its messages are deleted
Notes.Hours 24 Hours a notice stays up
Notes.Everyone true Every player with a handle can write notices. false: only hackers
Notes.Max 100 Notices up at once, in total
Notes.PerPlayer 3 Notices one player can have up at a time. Hackers are not counted
Ranks five ranks, 0 to 300 XP { xp, title } per rank, lowest first
Crack.Digits 4 Digits in a code
Crack.Tries 7 Guesses per code
Crack.Xp 6 XP for a solved code, plus one per guess left
Crack.FailXp 1 XP for a failed code
Crack.PerHour 6 Codes a player can start per hour
Commands scan, ping, lookup, trace Rank, cooldown, XP and settings per command, see above
ProtectedJobs {} Jobs that cannot be looked up or traced

#Setting it up

  1. Set up the second SIM (the GhostNet card) and its item: SIM cards.
  2. Decide who gets the terminal. Either create a hacker job, or use the ace: add_ace group.hacker fxphone.hacker allow and add the players to that group. Or set Everyone = true.
  3. If police should be safe from lookups and traces, set ProtectedJobs = { 'police' }.
  4. If you want anonymous chat rooms, set Rooms.Enabled = true.

#Good to know

  • "There is no Rooms tab." Rooms are off by default. Set Config.Anon.Rooms.Enabled = true and restart.
  • "The terminal tab is missing." The player is not a hacker. Check their job against Hacker.Jobs, the ace, or set Everyone = true.
  • "SIM Not Authorized" on opening. The player has no GhostNet card in either SIM slot, it is switched off, or it has expired.
  • lookup says "unregistered line". SIM cards are on (Config.Sim.Enabled = true) and the number is on a prepaid SIM, which carries no name.
  • Cooldowns and open codes live in memory. A server restart clears every cooldown and the hourly crack count.
  • An offline officer is protected by their last job. For a player who is not online, ProtectedJobs is checked against the job the phone last saw them in. A job change made while they were offline counts from their next login.
  • A room message or a notice can be blocked by another resource through AddCheck on message sending.
  • Rooms update live only for players who have Anon open.