Settings File Reference

Settings File Reference

Settings.json lives in your GokuTrap installation folder. See File-Locations.

Close GokuTrap before editing. A hand edit is a valid thing to do, but the running app will overwrite it on save.

Values shown are the defaults. Every setting is optional — a missing or invalid value is replaced with its default at startup rather than causing a failure.

General

Key	Type	Default	Meaning
AllowCookieAccess	bool	false	Permit authenticated Roblox requests. See Bootstrapper-Behaviour#Cookie access
Theme	enum	Default	Default, Light, Dark. See Appearance
Locale	string	nil	Interface language. See Localization
ForceRobloxLanguage	bool	false	Allow unsupported Roblox languages
DeveloperMode	bool	false	Extra diagnostics. Omitted from the file when false
WPFSoftwareRender	bool	false	Force software rendering for GokuTrap's own UI
EnableAnalytics	bool	false	Analytics, opt-in
StaticDirectory	bool	false	BinaryType install directories. See Deployment-and-Channel

Appearance

Key	Type	Default
UseAcrylicBackground	bool	false
AcrylicBackgroundOpacity	byte	165
BootstrapperStyle	enum	FluentAeroDialog
BootstrapperIcon	enum	IconGokuTrap
BootstrapperIconCustomLocation	string	""
BootstrapperTitle	string	"GokuTrap"
RobloxIcon	enum	IconDefault
RobloxIconCustomLocation	string	""
RobloxTitle	string	"Roblox"
SelectedCustomTheme	string or null	null

Bootstrapper behaviour

Key	Type	Default
ConfirmLaunches	bool	true
CheckForUpdates	bool	true
BackgroundUpdatesEnabled	bool	false
DebugDisableVersionPackageCleanup	bool	false
EnableRobloxBackgroundApp	bool	false

Deployment

Key	Type	Default
Channel	string	"production"
RobloxDomain	string	"roblox.com"
ChannelChangeMode	enum	Automatic (Automatic, Prompt, Ignore)
DistributorType	enum	Global
WebEnvironment	enum	Production

FastFlags

Key	Type	Default
UseFastFlagManager	bool	true

Integrations

Key	Type	Default
EnableActivityTracking	bool	true
UseDiscordRichPresence	bool	true
RichPresenceStatusDisplayType	enum	Name
HideRPCButtons	bool	true
ShowAccountOnRichPresence	bool	false
ShowServerDetails	bool	false
EnableWindowManipulation	bool	false
FakeBorderlessFullscreen	bool	false
CustomIntegrations	array	empty

Cleaner

Key	Type	Default
CleanerOptions	enum	TwoWeeks (Never, OneDay, OneWeek, TwoWeeks, OneMonth, TwoMonths)
CleanerDirectories	array	["RobloxCache", "RobloxStudioCache", "RobloxLogs", "GokuTrapLogs"]

Mods

Key	Type	Default
UseDisableAppPatch	bool	false

Feature tools

These are nested objects, deliberately kept separate so an installation that predates them deserialises with safe defaults rather than failing.

SaiyanMode

Key	Type	Default
Enabled	bool	false
Priority	enum	WindowsDefault (WindowsDefault, AboveNormal, High)
AffinityMask	hex string or null	null
AutomaticEfficiencySelection	bool	false

Overlay

Key	Type	Default
Enabled	bool	false
Style	enum	Cross (Cross, Dot, Circle)
Color	string	"#FFFFFFFF"
Size	number	18
Opacity	number	0.85
ToggleHotkey	string	"Ctrl+Shift+X"
ShowTelemetry	bool	false
OffsetX	number	0
OffsetY	number	0

SoundPacks

An array of slots. Each has Id, Name, Target, AssetFileName, SourceFileName, Sha256 and Enabled. Slots with an unrecognised Target are dropped on load.

AccountProfiles

An array of profiles. Each has Id, RobloxUserId, Username, Nickname, DisplayName, AvatarThumbnailUrl, LastValidatedUtc and ValidationStatus.

Plus SelectedAccountProfileId.

Two normalisations happen here every startup: ValidationStatus is reset to "NotValidated" so a stale label is never trusted, and AvatarThumbnailUrl is cleared unless it is HTTPS and ends in .rbxcdn.com. Profiles without a positive RobloxUserId are removed.

FastFlagCatalog

Key	Type	Purpose
LastCatalogVersion	string	Version of the last validated catalog
LastRefreshedUtc	timestamp	When it was last refreshed
PreviousValues	map	Values to restore, for Community-Hub revert
AppliedValues	map	Values GokuTrap applied

Update

Key	Type	Default
IncludePrerelease	bool	false
CheckIntervalHours	int	24 — clamped to 1–168

What is deliberately not in this file

• Any credential, cookie or token. There is no field for one, by design.
• Your FastFlag values — regenerated into Roblox's client settings at each launch rather than duplicated here.
• Roblox's own state, which lives in State.json and Roblox's directories.

See Security-and-Privacy and Settings-Overview.