Studios
Audio Propshouse-3.jpg

Examples

SoonAudio PropsQbox
PAGE 04 OF 07  ·  CONFIGURATION → EXAMPLES → TROUBLESHOOTINGdocs.glitchstudios.dev
Browse docs
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.