flowchart LR
P["Player at the controls"] -->|"act (rate limited)"| S["Serverstate per system"]
S -->|"patches, once per change"| A["Audienceplayers in range, same bucket"]
A --> C["Clientstreams systems in and out"]
C --> N["NUI audio enginedecks, mixer, effects"]
S -.->|"optional"| Y["yt-dlp + R2song conversion"]
The server keeps the truth for every system. Each deck is a position anchored to the server clock (pos, at, rate), and clients sync their clock to it. A player walking into range fetches the full state and replays any patch that arrived while it loaded, so they join on the beat. After a resource restart, every client drops its old state and loads it again.
Who gets each system's patches is worked out once a second, out to the same distance a client keeps a system loaded, and only for players in the same routing bucket.
Security#
| Area | What the server does |
|---|---|
| Controls | Checks distance, the system's access rules, dead or downed players, car seat permissions and routing buckets on every action. |
| Flooding | 20 actions a second per player, with bursts of 40. A dropped action is followed by a full state refresh for that player. |
| Library | Song adds and playlist imports are capped per hour, and link checks have a cooldown. Track analysis is only accepted from players who have that track playing near them. |
| Pasted links | Fetched only from public addresses and checked again at every redirect. Private, loopback and cloud metadata addresses are refused, and mirrored files must really be audio. A start-up self-test prints a red line if that check is ever wrong. |
| Items | Placing and picking up are ordered so a crash cannot duplicate an item, with one placement at a time per player. |
| Map TVs | Capped per player and city-wide. A player's map TVs go when they leave. |
Performance#
- With nothing near, a client checks for systems once a second. With one near it checks ten times a second, and sound levels go to the browser only when they change.
- Lights, smoke, effects and TVs follow each player's show quality.
- The server ticker skips systems with nothing playing, and the library list is built once and reused.
Open files#
Under Tebex escrow these stay readable and editable: config.lua, config.site.lua, shared/util.lua, client/dataview.lua, server/convert.js, server/r2.js and install/. server/r2.json (your keys) is never sent to players.
Stuck on a step?Ask in the Discord →