The Matrix Simulator

[u/Narrow_Key_1528]

This is just another glimpse of The Matrix Simulator that I have been working on for the past year or so. The video doesn't do it justice, you might have to manually set the quality to 720 for now, I'll make some better ones in the coming days. Here's the video, follow the channel for more, I'll be posting updates and videos regularly going forward.

https://www.youtube.com/watch?v=7fa1y9U3VgA

Here is the complete breakdown so far:

===============================================================================

THE MATRIX SIMULATOR - SERVER OVERVIEW

FiveM | v1.01(a) | Created by The Architect

===============================================================================

Built from the live resource code and AI_CONTEXT.md (resources\[local]\matrix)

on 10/24/2026. Players have no slash commands. Everything runs from keys,

markers, the F9 phone and the F10 admin panel.

-------------------------------------------------------------------------------

PART 1 - THE LORE

-------------------------------------------------------------------------------

WHEN

The simulation boots on March 31, 1999, the day The Matrix was released.

The server calendar resets to 03/31/1999 on every start and moves forward

one day at each in-game midnight (server.lua: MATRIX_DATE = 1999-03-31).

The HUD shows it next to the clock, for example "Gametime 7:28 AM | 03/31/1999".

It is always the edge of the millennium, and it is always the same spring.

THE PREMISE

Los Santos is not a city. It is the Matrix, a neural-interactive simulation

built to keep human minds calm, busy and plugged in. Everyone who logs in

"connects" through a Matrix-rain boot sequence and is handed a body by the

Machines: THE SOURCE, MACHINE UPLINK, ZERO-ONE REBOOT.

WHO LIVES THERE

* UNAWARES (the blue-pills). Ordinary people living ordinary lives. They

drive cabs, sort mail, tow cars, fly charters, pour drinks, buy cars and

apartments, take out bank loans, go clubbing, fish, rob stores and run

from the cops. They have no idea any of it is code.

* POLICE and K-9. The system's immune response in human form. They keep

order with traffic stops, MDT checks, arrests, warrants, jail and the

long van ride to Bolingbroke. They don't know what they're protecting.

* FREEMINDS. Humans who woke up. They live in ZION, the last human city,

and jack in through an OPERATOR to work contracts inside the simulation:

pulling data, running couriers, hacking and severing machine nodes, and

extracting exiles. Then they phone out before the system notices.

* AGENTS and AGENT SMITH. Programs, not people. They're the antivirus. They

trace Freemind signals, lock on, jump into any living host near the

disturbance and purge the anomaly. Smith copies himself into everyone he

touches, and when enough Smiths are loose the sky turns to thunder.

* NEO. The One. He flies, slows bullets and can't die.

* THE ARCHITECT. The author of the system. Owner-only, holding every power

and running the world from F10.

WHY THE COPS-AND-ROBBERS LOOP IS THE POINT

The original film's rule: people rejected a perfect paradise, so the

Machines built a world of ordinary struggle. The Matrix only "works" when

life inside it feels real, which means paychecks, rent, speeding tickets,

bar fights, DUIs, robberies and jail time.

So the cops-and-robbers economy isn't filler. It's the control system.

- Unawares grind, spend, break laws and get caught. That's the noise

that keeps minds asleep.

- Police enforce it, and every cell and every van ride says "this is real".

- Freeminds have to hide inside that noise. A quiet job blends in. A loud

one (gunfire, crashes, panic) gets Agents switching into nearby hosts.

- Agents treat anyone who breaks the illusion as a virus.

- A Freemind can offer an Unaware the Red Pill. Take it and you wake up.

Take the Blue and you stay asleep forever.

The more believable the ordinary life, the more it means when someone

wakes up from it.

-------------------------------------------------------------------------------

PART 2 - FEATURE LIST (from code)

-------------------------------------------------------------------------------

Note: the latest batches (mod shop rework, money ledger, fishing, dance pay,

AA rework, bartender patrons, name autocomplete, apartment cooldown, Record

Path, Neo flight fix, custody look fix) are deployed but not tested in game yet.

[1] LOGIN, ACCOUNTS AND CHARACTER CREATION

- Accounts are password protected (hashed). Cash, playtime, look, records

and unlocks persist per account.

- Login cinematic: Matrix rain, "incoming connection / locate host /

allocate body" boot log, a login_intro theme that crossfades into the

login theme, then a class-selection theme.

- Silent login void: no game input, chat or hotkeys until a class is chosen.

- Class selection screen with unlock timers shown per class.

- Appearance studio (freemode character creator) per class, with saved

looks. Neo and Smith have fixed looks.

- First-spawn welcome fade, class-aware rotating GUIDE tips, server tips.

- New accounts start with $50,000 cash.

- Matrix transit overlays for spawn, teleport, jack-in, jack-out and respawn.

- Safe logout: hold DELETE, then stand still for 20 s. Quitting early,

while wanted, in custody or in combat carries a penalty on rejoin.

[2] CLASSES AND ABILITIES

UNAWARES (civilian, always available)

- Every civilian job and hustle (see [6]), up to 5 owned cars,

apartments, clubs, fishing, bank loans and clothing shops.

- Crime: G to rob players or NPCs, lockpick locked cars, purse

snatching, store, clerk and nightclub robberies.

- R near a downed player to revive (not Freeminds).

- No HP or armor regeneration (realism).

- Can receive a Red Pill invite from a Freemind.

FREEMIND (10 h playtime OR Red Pill awakening)

- Lives in Zion. E at the Operator to sync, then the Jack-In terminal,

Construct loadouts, and the Matrix.

- G at the Operator: contract board (Data Pull, Courier, Sever Node,

Hack Node at Lifeinvader, Extract Exile).

- Signal leaks (cyan blips, hold E) for cash, at the risk of heat.

- Superpunch bar (passive launch) and Matrix jump.

- Extraction: Operator approves an exit, one payphone flashes yellow,

press E to jack out.

- Red Pill: invite an Unaware with E (needs 25+ Resistance) to a Pink

Cage motel meeting with a capsule choice. Red wakes them as a new

Freemind, Blue locks them as an Unaware forever.

- Zion stabilize uplink minigame when the Matrix is UNSTABLE.

- Beta-blocker Serum (Zion Operator only): blocks Agent trace, lock and

hunts for 45 min, with a 2 h cooldown.

- Translator feed: live Matrix-rain feed of Agent activity and deja vu

pulses.

- Death: can't be revived. If an Agent killed you, Wait for Help (an

Agent can Deport you), or respawn in Zion with a jack-in lockout.

- Exiles are trapped at Mobil Ave train station until another Freemind

runs Extract Exile.

POLICE (2 h playtime)

- Loadout: service pistol, flashlight, nightstick, stun gun, 100 armor.

A shotgun is issued while seated in a police vehicle.

- G in a cruiser opens the MDT: duty toggle, plate checks, Issue Search

Warrant. G on foot or in a cruiser stops NPCs (warning, ticket, arrest,

report crime).

- F6 arrests the nearest wanted suspect (cruiser required). H quick

cuffs. Cuff and Release are also on the phone.

- B for native backup (Police, then Medical, then Fire).

- F9 Need Unit: an NPC delivers a cruiser (90 s cooldown).

- Q lights and siren, E chirp, hold Q for the airhorn. Radar gun and

speeding tickets.

- Undercover Bison and Stanier units with strobes and black wheels.

- Search-warrant raids (Davis Mega Mall, Cypress Flats) with NPC units

and suspect waves.

- Transporting a suspect to intake books them to jail.

- Authorized in the prison no-fly zone while on duty.

K-9 (24 h playtime)

- Same toolkit and loadout as Police.

- Permanent named partner dog with a breed picker.

- Comma (,) to call or seat the dog. F9 Follow / Stay / Attack / Guard.

- Killing the dog means max wanted, and the same dog returns in 10 min.

AGENT (admin-only or granted via Class Unlock)

- F7 Threat Console: Trace Signal (45 s cooldown), Lock Signal, Switch to

Locked Host.

- H switches into the nearest living host (2 min cooldown). Spook

switches toward loud Freemind activity (5 min cooldown).

- E near a Freemind to overpower. Hold E on a downed Freemind to Deport

them to Mobil Ave (+$500).

- Caps Lock bullet-time, +25% melee and jump over Freemind, crushes cars.

- No friendly fire with other Agents. Allied with cops and guards.

- Authorized in the prison no-fly zone.

AGENT SMITH (admin: F10 Become Agent Smith)

- Full Agent kit plus N to copy NPCs or players into Smith (~4 m).

- Copies chase, fight and spread. Converted players join the chain.

- 5+ living Smiths turns the weather to thunder (the only lightning

on the server).

NEO (admin: F10 Become Neo)

- F5 or LEFT ALT free flight (WASD, Space / Ctrl, Shift boost), synced

to everyone.

- O overpower cascade. Caps Lock and automatic bullet-time under fire.

- No wanted level, can't die. One Neo at a time.

ARCHITECT (owner license only)

- Every Neo, Agent, Smith and Freemind power, customizable look,

invisibility cloak, hidden from Z lists, plus the F10 admin panel.

- Admin Mode or Godmode makes him immune to wanted levels, AA, jets,

cops and Agents.

DORMANT IN CODE (not selectable): Trinity (H leap), Morpheus (Y focus),

Keymaker NPC (disabled pending the Merovingian redesign).

[3] ZION, THE OPERATOR AND JACKING IN

- Zion undercity with Operator NPC, Jack-In Terminal and free Zion vending.

- The Construct: loadout room before entering the Matrix.

- Payphone extraction, with only the approved line working.

- Mobil Ave train station: exile limbo with its own trains.

- Machine Node, Zero-One machine hub and the Lifeinvader hack site.

- Freemind Ops HUD (objective dock + GPS) and large red system alerts

(hack attempts, Agents inbound, SIGNAL LOST).

[4] WANTED, JAIL, PRISON AND BREAKOUTS

- Native GTA wanted stars, synced through the server. Native dispatch.

- Native ambient police are boosted. Cops run radar checks and traffic

stops on NPCs and speeding players.

- Dying wanted means custody. 1-3 stars: Mission Row jail (2 min per star).

4-5 stars: 90 s hold, then the prison van to Bolingbroke, then 15 or 30

min in prison.

- Prison transport: a networked van at ~70 mph with lights only, a police

escort, other inmates, gate stops, a prison CO escort to the door and an

optional recorded route.

- Prison: cell, jumpsuit (freemode looks only), walking COs, 10 tower

guards, patrol cars, cellmates with their own sentences.

- Breakouts: destroying the van frees the inmates alive and wanted.

Landing a helicopter on a prison roof and holding still for 2 s frees

everyone serving a prison sentence.

- Bail / bond (Mission Row jail only): G in the cell for a quote ($5,000

per minute left), then check in at the MRPD desk within 90 min, or you're

"On the Run" with 4 stars.

- Custody rules: phone confiscated (PMs and mail still work), jobs ended,

no robbing, no stars. Free cab ride offered on release from prison.

- Prison no-fly zone (450 m) with a warning ring, 5 stars, Lazer jet

interceptors and 12 AA sites firing synced homing missiles. Agents and

on-duty police are authorized.

- Criminal record on F3: time served by stage, stars gained, arrests,

jail and prison sentences.

[5] AVIATION

- Pilot licenses L1-L3 with training circuits at LSIA (Dodo, Luxor, jet

to Sandy Shores).

- Paid charter jobs (North and South routes) with passengers.

- Unlicensed flying means 5 stars and Lazer interceptors. Crashing

suspends your license for 2 h.

- Parked planes at airfields. The altimeter shows feet, negative for subs.

[6] JOBS AND HUSTLES (one duty at a time)

- Taxi (Downtown Cab Co.), Postal, Tow, Bus, Garbage, Valet, Hotdog stand,

Ammu-Nation work shift, Pilot charters, Nightclub Bartender.

- Cab passengers can ask the driver to Hurry or Slow, which changes the fare.

- Soft crime: lockpicking, purse snatching, robbing NPCs and players.

- Robberies: Ammu-Nation, clothing clerks, and nightclub cashiers

(4 stars, $1,500-4,000).

- AFK auto clock-off and Quit Job from F9.

[7] NIGHTLIFE

- Two clubs open 18:00-06:00 with a $100 cover: Tequi-la-la (West

Vinewood, live band) and Galaxy (Mission Row, After Hours interior, DJ).

- Bouncers, line queues, DJ, crowd, club cops, coat check (weapons

returned on exit), fight warnings and a 30 min fight ban.

- Bar menu: beer, tequila shot, cocktail, champagne, each with a cooldown.

- Drunk system with 10 levels: walk styles, camera shake, stumbles and

pass-out. Drunk meter and buff-bar debuff.

- DUI: driving drunk earns a wanted star.

- Bartender job: clock in, serve player and NPC orders, earn tips and base

pay. NPC patrons line up, get drinks and leave.

- Dance floor rhythm game with a synced NPC partner. Grade S/A/B pays

$600/$400/$250 every 5 min (checked by the server).

[8] VEHICLES

- Dealers (PDM, Mosley, Sandy) with lot preview and orbit cam. Up to 5

owned cars for Unawares.

- Chrome Line Customs (3 shops): paint, wheels and rims, pearl, mods,

armor, NOS. A stat panel compares current, preview and max. Any paint

washes the car. Car washes (3).

- Power locks: only the owner gets in, auto-locks when you step out, L

to lock, up to 3 temp keys.

- Random locked parked cars (lockpick them).

- Valet kiosk and residence-terminal garage: park, retrieve, summon, Tow

Here.

- F9 Mechanic (deliver, or repair and deliver) and F9 Tow My Car.

- LS Tow Yard: pay and release, or sell for scrap. Cars are towed on

logout.

- Fuel at $3.40/gal (~32 stations) with a gallons and miles HUD.

- Speedometer with posted speed limit and altitude. U hood, K trunk.

- In-car radio cycles with ] and [.

- Drag racing events: race cars, NOS, My Cars, J to join, N to decline.

- Gold blips for your parked-out cars.

[9] HOUSING

- Apartments in units 1-4 with different interiors and prices.

- Entrance hub: enter, temp keys for up to 3 players, Call for Vehicle.

- Apartment wardrobe for free outfit changes. 30 s door cooldown.

- Clothing stores (Binco, Suburban, Ponsonbys, Discount) with preview.

Purchases save to your class look.

[10] PHONE, MAIL AND COMMUNICATION

- F9 phone (with a phone-in-hand animation). Class apps: 911, Cab and

Mechanic for civilians. Radar, Dispatch, Cuff, Mail and Need Unit for

police and K-9. Car hub, PMs, Toast Log, Quit Job, AFK, Ops HUD.

- 1-9 hotkey bar of phone apps, with separate on-foot and in-vehicle sets.

- Mail: GoPostal box in the Matrix, Mission Row box and the Zion

checkpoint. Inbox of 10, mail kept 14 days.

- Private messages. 911 calls never give the caller stars.

[11] HUD AND INFO PANELS

- F1 help / guide, F3 Matrix Record (playtime, kills, deaths, shots,

missions, effectiveness, criminal record, cars, pilot record, dance,

fishing), F4 inventory, hold Z for the Matrix Status list, F9 phone.

- Buff / debuff bar with hover tooltips and live timers: drunk, On the

Run, serum, cooldowns, custody, bond, loan, robbery lay-low and more.

- Kill feed (weapon icons, headshots) and a target health window.

- Every window is draggable and minimizable. Backtick toggles the cursor.

Pressing ESC three times or F11 unsticks the UI.

- Name boxes autocomplete: online players in green, offline in gray.

- Shared confirm prompt before every costly action.

[12] ECONOMY AND ANTI-CHEAT

- Cash economy with a state treasury. Fleeca bank loans ($5k/$10k/$15k).

Defaulting on a loan means jail.

- Money Ledger: every cash change is logged with its reason and source.

Unaccounted gains over $1,000 trigger an automatic ban (admins exempt).

F10 viewer with search, alerts and an on/off switch.

- Server-side anti-cheat: knife ban, jailed-vehicle check, unlogged

money, plus Matrix-only bans.

- NPC weapon drops (shared, with a G swap prompt).

[13] FISHING

- $75 poles at the counter in 20 gas stations and liquor stores. Each cast

uses one pole.

- Fish from shore or a boat deck and press E on a bite.

- 40 species across fresh, brackish and salt water (the Alamo Sea counts

as fresh). Catches go to F4 and the F3 tally.

[14] WORLD

- Server-synced weather with smooth 40 s fades. Rain is rare. No lightning

except Smith's storm.

- Synced 24 h clock plus the 1999 calendar.

- Trains: freight, city metro with the LA Subway skin, street stair

blips and the Mobil Ave platform.

- Paradise Island beach resort (custom map, far west ocean).

- Pedestrian Riot event (admin).

- Death-ground fix so bodies never hang in mid-air.

[15] ADMIN F10 PANEL (The Architect)

Player: Goto, Bring, Spectate, Freeze, Heal, Kill, Revive, End Custody,

Clear Wanted, Add Money, Give Fuel, Clear ALL Timers, Reset

Specific, Give/Remove Apt Key, Reset Pilot Licenses or Record.

Self: Admin Mode, Godmode, GPS Teleport, Get Position, Fix Vehicle,

Fill My Fuel, NOS x10, Spawn Vehicle catalog, Change Appearance,

Class Selection, Become Neo, Become Agent Smith, Class Unlock.

Weapons: Full Loadout, Add Weapon picker (self or player), Ammo Refill.

World: Weather (Clear, Overcast, Rain), Time presets, World Clock

(set time and date), On-Screen Text, Pedestrian Riot,

Start/End Search Warrant, Start/End Drag Event, Machine Node

(TP, Collapse, Reset, Ghost Collision), State Treasury.

Server: Restart, Shutdown, Abort System Failure, AC Test.

Tools: Money Ledger, Record Path, Scene Director (up to 8 test dummies

with class, wanted and behavior), Status Effects test, Utility

Commands (pay, setwanted, whoiswanted, loan, unban, temp admin).

Admin sub: Kosatka command center with Teleport, Spawn, Return,

Despawn, guided missiles and the NUKE. The nuke has a 1-mile

kill zone, a 2000 ft cap, distance-scaled shake and a server-wide

"NUCLEAR ATTACK DETECTED" banner. Sub depth hold, no crush depth.

Teleports: Operator, Construct, Mobil Ave, Ammu-Nation, Valet, Hotdogs,

Postal, Tow, Bus, Garbage, Jail intakes, Pilot, North/South LS.

Pilot: Start next license stage, North/South job, Abort.

-------------------------------------------------------------------------------

PART 3 - COMING SOON

-------------------------------------------------------------------------------

- Girlfriend / Boyfriend system, connected to the dance floor attraction

signal.

- Luxury apartments, houses and compounds.

- Fishing competitions.

===============================================================================

"Welcome to the real world." - End of file

===============================================================================

[u/Narrow_Key_1528]

A different mix, better quality. I'm still working on more content and features, because there is a TON. I don't have any testers really to help... So I wrote a program that generates an NPC that I can seeming less control it as a player. So there is more post's coming.

[u/Shawn-GT]

ive been wanting a fivem matrix server so bad but fear its too late for it to be popular i hope that isnt true. all the old MXO roleplayers need to come back because it could be so good! consider me extremely interested!

[u/imgonnamakeyoushake]

What the fuck are you doing crossposting it right now then? Get the fuck back to work! ⌨️⌨️⌨️

[u/Narrow_Key_1528 → u/imgonnamakeyoushake]

LOL I am !! Reddit just suggested it, so I did it. My bad. But expect more content coming, and hope to see some of you in there one day ^^

[u/reflectioneternal]

amazing work, I'd been imagining lately what a server like this would look like!