Goldstrapdocsdownload

Set up Goldstrap
and keep it working.

How to install it, which settings actually raise your frame rate, how to stay on a Roblox build that works, and what to do when an update breaks everything.

Quick start

four steps, about two minutes

  1. Download and run Goldstrap.exe
  2. Get past the Windows warning
  3. Open Global settings and raise the frame cap
  4. Hit Launch Roblox

Install

Windows 10 or later. No account, nothing to pay for.

  1. Download Goldstrap.exe from the latest release.
  2. Run it. SmartScreen will warn you — More info → Run anyway.
  3. Goldstrap installs to %LOCALAPPDATA%\Goldstrap and registers itself as the handler for Roblox launch links. You can pick a different folder during setup.
  4. If Bloxstrap is already on the machine, the installer offers to import its settings.
Only this repository. The build is not code-signed, so Windows cannot verify who made it — and neither can you, unless you build it yourself from the source. Any other site offering "Goldstrap" is not us.

macOS and Linux are not supported and are not planned. For those, look at AppleBlox or Sober.

First launch

The first launch has to download the Roblox client, so it takes a while. After that it only grabs the parts that changed, and it is quick.

Two things are worth setting right away:

  • Frame cap — in Global settings, not in FastFlags. See global settings.
  • Check for updates — on by default, leave it on. A Goldstrap build that lags behind a Roblox update is the usual cause of "it stopped launching".
Goldstrap is a launcher. It writes configuration the Roblox client reads while starting. It does not inject code and does not touch the running game, so it cannot give you flight, aimbot, or an anti-cheat bypass — and anything sold under this name claiming otherwise is not ours.

Files and folders

Everything lives in one folder, %LOCALAPPDATA%\Goldstrap unless you picked somewhere else. Paste that into the Explorer address bar to open it.

NameWhat is in it
Settings.jsonEverything you changed in the app
State.jsonWindow position, last page and other app state
RobloxState.jsonWhich Roblox versions you have installed
Data.jsonCached remote configuration, refreshed in the background
Versions\The Roblox clients you have downloaded
Downloads\Cached Roblox packages, so a repair skips re-downloading
Logs\Launch logs. Attach the newest one when reporting a bug
Modifications\File mods and your custom font
CustomThemes\Themes you installed for the loading window

Global settings

The frame cap and quality level are here, not in FastFlags.

Roblox stores your in-game options in a file it rewrites all the time, which is why editing it by hand never sticks. Goldstrap writes to it properly, so your changes stay.

SettingWhat it doesWorth knowing
Frame capLifts the 60 fps ceiling so a 144 Hz or 240 Hz monitor is actually used.Leave it alone to keep Roblox's own limit
Quality levelLocks the graphics slider between 1 and 21 instead of letting Roblox move it.Under 5 gets rid of most of the lighting cost
Max qualityThe slider's maximum switch, kept in step with the level above.—
Mouse sensitivityType an exact number instead of dragging the in-game slider.—
UI transparency, reduced motion, text sizeAccessibility options that are awkward to find in Roblox.Reduced motion also calms the grass
VRTurns VR on or off outright.—
Try this before touching any flags. The frame cap and the quality level give you most of what people go hunting for in long flag lists.

FastFlags

A FastFlag is a switch inside the Roblox engine. There are hundreds of them and Roblox shows you almost none. Goldstrap writes the ones you pick into the client before it starts.

Reading a flag name

PrefixTypeValue
FFlag, DFFlagon / offTrue, False
FInt, DFIntwhole number240
FString, DFStringtextVulkan
FLog, DFLoglog level7

A D at the front means Roblox's servers can change that value too, so it might be overridden while you are playing.

The allowlist decides what works. The Roblox player only honours the eighteen flags Roblox published in its allowlist — everything else is ignored, however confidently a video claims otherwise. The list is reproduced in full below. It does not apply to Roblox Studio.

Editing

  1. Open FastFlags. Toggle the presets, or switch to the raw editor for anything else.
  2. Save. Flags are applied at launch, never mid-game.
  3. Keep a copy of a setup you like as a JSON file, so you can bring it back later.

Importing someone's preset

Presets are plain JSON:

a small, honest preset
{
  "FFlagDebugGraphicsPreferD3D11": "True",
  "DFIntDebugFRMQualityLevelOverride": "5",
  "FIntFRMMaxGrassDistance": "0"
}
Read every line before importing. A preset is a list of engine switches from a stranger. An unknown flag can cost you frames or stop the client from starting. Change one thing at a time and launch in between — six changes at once tell you nothing.

The allowlist, in full

Eighteen of them. Anything else is ignored by Roblox, no matter what you read.

Source: Allowlist for local client configuration via fast flags, posted by Roblox on the developer forum.

Rendering

FlagEffect
FFlagDebugGraphicsPreferD3D11Force DirectX 11. The safe choice when anything looks wrong.
FFlagDebugGraphicsPreferVulkanForce Vulkan. Often faster on AMD, occasionally unstable.
FFlagDebugGraphicsPreferOpenGLForce OpenGL. Last resort on very old hardware.
DFIntDebugFRMQualityLevelOverridePin the render quality level instead of letting Roblox scale it.
DFFlagTextureQualityOverrideEnabledTurn the texture quality override on.
DFIntTextureQualityOverrideThe texture detail level it then uses. Helps low-VRAM cards.
FIntDebugForceMSAASamplesAnti-aliasing samples — 1, 2 or 4. Higher costs frames.
FIntFRMMaxGrassDistanceHow far grass renders. Zero removes it.
FIntFRMMinGrassDistanceWhere grass starts. Set both to zero to be rid of it.
DFFlagDebugPauseVoxelizerFreeze voxel lighting updates. Large saving, visibly wrong shadows.
FFlagDebugSkyGrayFlat grey sky instead of the skybox.
DFFlagDisableDPIScaleIgnore Windows display scaling.
FFlagHandleAltEnterFullscreenManuallyAlt+Enter handled outside Roblox.

Geometry

FlagEffect
DFIntCSGLevelOfDetailSwitchingDistanceDistance at which meshes drop to the next detail level.
DFIntCSGLevelOfDetailSwitchingDistanceL12Level 1 to 2 switch distance.
DFIntCSGLevelOfDetailSwitchingDistanceL23Level 2 to 3 switch distance.
DFIntCSGLevelOfDetailSwitchingDistanceL34Level 3 to 4 switch distance.

Interface

FlagEffect
FIntGrassMovementReducedMotionFactorHow much grass sways. Lower is calmer and slightly cheaper.
Two of Goldstrap's toggles sit outside this list. The texture quality switch is written as DFIntTextureQualityOverrideEnabled while the allowlist names it DFFlagTextureQualityOverrideEnabled, and the static mesh detail toggle writes DFIntCSGLevelOfDetailSwitchingDistanceStatic, which is not on the list at all. If either appears to do nothing, that is why — it is worth reporting.

Roblox can change this list at any time. If one of these stops doing anything, check the forum post before you go hunting through your own setup.

Channels & rollback

Roblox releases clients on channels. You are on production by default, which means whatever shipped that morning. Goldstrap can point somewhere else, or at a different Roblox domain entirely.

Custom Roblox domain

On the same page you can point Goldstrap at a different Roblox domain (the default is roblox.com). Only change it if you know why — a wrong domain breaks launching, and an untrusted one can expose your session. There is also a static directory switch, which names the install folder after the client type instead of its version, for software that expects Roblox in a predictable place.

When the channel changes

You get three choices in the app:

  • Automatic — go along with it, no questions.
  • Prompt — ask you first.
  • Ignore — stay put.

Rolling back

Old clients sit in Versions\ until the cleaner clears them out, so dropping back to yesterday's build downloads nothing at all.

A pin has an expiry date. Roblox blocks outdated clients from joining after a while. Pinning is a way to finish today's session, not a permanent home.

BetterMatchmaking

This one is off by default and still marked experimental. Turn it on and Goldstrap chooses which server you land in rather than Roblox, going for the closest one to you — usually the lowest ping.

There is a second switch that randomises the choice between the good servers, so everyone running Goldstrap does not end up in the same one. And if a friend is already in the game, it asks whether you want to join them instead.

It turns itself off for launches where it cannot help, like a direct join link.

Roblox Studio

Studio launches through Goldstrap too, with its own version and its own cache. The flag allowlist does not apply there, so flags the player refuses can still work in Studio.

Integrations

Roblox app settings

Controls for the Roblox desktop app itself: let it run in the background — starting with Windows and staying in the tray after you close it — and choose the app's theme: Default, Light or Dark.

Activity tracking

On by default. Goldstrap follows Roblox's log to know which game and server you are in. It is what powers the activity details, the tray icon and the rich presence, and it never leaves your PC.

Discord rich presence

On by default. It shows what you are playing, and you decide how much: the game name or a status, whether your account shows, whether the join buttons appear, and whether server details are included. Those details come from RoValra's API.

Your own programs

You can have Goldstrap start anything alongside Roblox — a recorder, an overlay, a monitor. Each one takes a path and, if it needs them, some arguments, and can close itself when you quit.

Whatever you add runs with your account's permissions, so stick to programs you trust.

Window handling

There is optional control over the Roblox window, including a fake borderless fullscreen for setups where the real one misbehaves.

Appearance

The loading window comes in a few styles: the Fluent Aero one it ships with, a plain Fluent version, Byfron, a terminal look, the 2025 Roblox design, the older Vista and legacy dialogs, a bare progress bar, or one you build yourself.

  • Icon and title — change either, or use your own image.
  • Themes — drop them into CustomThemes\.
  • Launch sound — an MP3 or WAV file (up to 20 seconds) played when Roblox launches, with a volume slider and a preview button.

Mods

Goldstrap can replace a few client files using assets bundled with the app. Everything here is re-applied on launch and reversible.

  • Mouse cursor — pick a classic or alternative cursor set.
  • Old avatar editor background — the pre-2021 look.
  • Old character sounds — classic jump, walk and get-up audio.
  • Emoji set — swap the in-game emoji font.
  • Custom font — use your own font file for the interface.

An Open mods folder button handles everything else: drop files into Modifications\ and they are copied over the client on the next launch. The help link on the same page explains the folder layout.

Shortcuts

Under Shortcuts you decide which desktop and Start menu icons Goldstrap creates — Roblox, Studio and the Goldstrap menu itself. There is also a switch to pull Roblox's own icons out of the client, so your shortcuts use them instead of the generic ones.

Cache cleaner

Roblox never tidies up after itself. Goldstrap deletes anything older than an age you pick: never, a day, a week, two weeks (the default), a month, or two months.

It handles the Roblox asset cache, the Studio cache, Roblox's logs and Goldstrap's own logs, and you can switch any of them off.

Troubleshooting

Windows blocked the installer

Click More info, then Run anyway. If your antivirus grabs it instead, that is a false positive on the updater. Double-check the file came from the GitHub releases page before you allow it.

Roblox stopped launching after a Roblox update

  1. Update Goldstrap first. This is almost always the reason.
  2. Launch once with your flags turned off. If that works, a flag is the problem.
  3. Turn them back on a few at a time until it breaks again, then remove that one.

Frames got worse, not better

Nine times out of ten it is the graphics mode. Remove FFlagDebugGraphicsPreferVulkan, try FFlagDebugGraphicsPreferD3D11 instead, or clear both and let Roblox decide. Check the quality override as well — setting it high makes your GPU do work it was skipping.

A flag does nothing

It is probably not on the allowlist, or Roblox renamed it. There is nothing you can do about that from your end.

My settings disappeared

Roblox rewrites its own folder every patch. Goldstrap puts your settings back the next time it launches the game, so launch through Goldstrap rather than the Roblox shortcut.

Nothing here helped

Open an issue and include your Goldstrap version, your Windows version, what you changed, and the newest file from Logs\: report a bug.

Reset the config

If you want a clean slate without reinstalling, close Roblox and Goldstrap, then delete this file:

Win + R, then paste
%LOCALAPPDATA%\Goldstrap\Settings.json

Your downloaded clients stay where they are, so the next launch is still quick. To wipe everything instead, delete the whole %LOCALAPPDATA%\Goldstrap folder.

Uninstall

Use the uninstaller in the app. It closes Roblox if it is open, hands the launch links back to the normal Roblox launcher, removes the shortcuts and its registry entry, and deletes its folder.

It asks whether to keep your data. Say yes if you think you will come back and want your settings waiting for you.

If the app will not open at all, delete %LOCALAPPDATA%\Goldstrap and reinstall Roblox from roblox.com/download to restore the launch links.