Settings

The two files

Nothing else in the package is meant to be edited. Both files are replicated to ReplicatedStorage, so every value in them is readable by any client.

The map

Debug and Studio data

Debug = true,
StudioMode = false,

Debug ships on and prints routine activity to Output. Turn it off before you publish; warnings and errors are printed either way.

StudioMode decides whether the profile DataStore is used.

The shipped value is false, which means your Studio tests write to the same store as your live game. Change it to "auto" before you start building.

The profile

Everything a player owns is one DataStore entry, keyed on their user id.

There is no session lock. Two servers holding the same player at once would each save their own copy, and the last write wins. In practice Roblox does not put one player in two servers, so this only matters if you are moving players between places quickly.

The world folder

WorldFolder = "uxrVehicleSystemWorkspace",
VehicleFolder = "Vehicles",
ShowroomFolder = "Showroom",

WorldFolder is the one place in Workspace this system looks. Dealership prompt parts, spawn pads, gas stations, chargers, radars and the garage model all live inside it, at any depth.

VehicleFolder and ShowroomFolder name folders inside Storage. Vehicles are the models the catalog spawns; the showroom is scenery that is moved into the world folder at startup and tagged as runtime, so it is rebuilt every restart.

The garage preview

Preview = {
    Enabled = true,
    ModelName = "GarageModel",
    SpawnFolderName = "SpawnPart",
    PadIndex = 1,
    RadiusScale = 1.6,
    MinPitch = -20,
    MaxPitch = 60,
    OrbitSensitivity = 0.01,
    Zoom = { Enabled = true, Min = 8, Max = 35, Step = 3 },
    CameraTween = 0.4,
    FreezeCharacter = true,
    CameraHeight = { Enabled = true, Min = -235.09, Max = -190.76 },
},

The selected car is spawned client side on a pad inside GarageModel and the camera orbits it while the dealership is open. Nobody else sees it.

FreezeCharacter pins the player in place while previewing, which stops them walking away from their own camera.

Messages

Every line of text the system generates is a template in Settings.Messages. Around a hundred of them: toast titles, purchase results, filter captions, button captions, fuel labels, auction rows and radar banners.

Tokens are written with a leading $ and replaced at display time.

A token with no value is left in place rather than blanked, so a typo shows up on screen as $vehicle instead of vanishing.

Translating the system is editing this one block. Static button captions that never change live on the ScreenGui in Studio instead.

Notification style

NotifyStyle = {
    Font = Enum.Font.GothamMedium,
    TextSize = 18,
    Stroke = false,
},

Notifications are rendered by the companion notify system. Colours come from each message's kind rather than from here; these three control the text.

The folder layout

Everything except the first is recreated at runtime. Edits made to the replicas at runtime are lost on the next server start.

The remotes

One RemoteEvent and one RemoteFunction, under Core/vspEvents, multiplexed by a leading string.

The RemoteEvent has no server-side listener at all, so there is no path for a client to fire an event the server acts on. Every request is a function call the server validates.

Where to start