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.
- 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 whenRooms.Permanentis on. - The room shows in every Anon player's list with its owner's handle, the time left and the number of messages.
- Anyone can enter and write. A message is up to
Rooms.MessageMaxcharacters. Entering a room shows its lastRooms.Historymessages. - 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.PermanentIdleDaysdays. WithPermanentIdleDays = 0a quiet permanent room is never closed. - A closed room and everything written in it are deleted
Rooms.KeepClosedHourshours later.
#Limits
- A player can have
Rooms.PerPlayerrooms open at a time. - At most
Rooms.MaxOpenrooms 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.Xpplus one XP for every guess left over. - Failed: the code is shown and the player earns
Crack.FailXp. - A player can start
Crack.PerHourgames in any hour. Typingexitleaves 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
Radiusmetres. Its centre is moved away from the phone by up toJittermetres, so the phone is inside the circle but not in the middle of it.Jitteris never more than 80 % ofRadius, andRadiusis 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
Secondsseconds. Only the hacker who ran the trace sees it. - With
WarnTarget = truethe 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; withWarnTarget = falseit says nothing about one. - With fx-3dmap running, the zone's pin is also shown on the 3D map in the
Config.Map3D.TempCategorycategory. 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
- Set up the second SIM (the GhostNet card) and its item: SIM cards.
- Decide who gets the terminal. Either create a
hackerjob, or use the ace:add_ace group.hacker fxphone.hacker allowand add the players to that group. Or setEveryone = true. - If police should be safe from lookups and traces, set
ProtectedJobs = { 'police' }. - 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 = trueand restart. - "The terminal tab is missing." The player is not a hacker. Check their job against
Hacker.Jobs, the ace, or setEveryone = true. - "SIM Not Authorized" on opening. The player has no GhostNet card in either SIM slot, it is switched off, or it has expired.
lookupsays "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
crackcount. - An offline officer is protected by their last job. For a player who is not online,
ProtectedJobsis 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
AddCheckon message sending. - Rooms update live only for players who have Anon open.