fluXis exposes a comprehensive set of configuration options through its settings panel, allowing you to tailor every aspect of the game to your hardware, preferences, and playstyle. Settings are persisted in an INI-format config file managed by theDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/InventiveRhythm/fluXis/llms.txt
Use this file to discover all available pages before exploring further.
FluXisConfig class. Each setting has a sensible default value so the game is playable out of the box, but dialing in your scroll speed, audio offset, and visual preferences will meaningfully improve your experience. The categories below mirror how settings are organized internally.
Gameplay
These settings directly affect how the game feels and looks during an active play session.Scroll Direction
Scroll Direction
Setting:
Default:
Options:
ScrollDirectionDefault:
DownOptions:
Down, UpControls the direction notes travel on the playfield. Down scrolls notes from the top of the screen toward the bottom, where the judgement line sits. Up reverses this, with notes rising from the bottom toward the top. Choose whichever feels most natural — it does not affect timing windows or scoring.Scroll Speed
Scroll Speed
Setting:
Default:
Range: 2.0 – 8.0 (step 0.1)Determines how quickly notes approach the judgement line. A higher value makes notes appear closer together and move faster across the screen, requiring quicker visual processing. A lower value spreads notes further apart, giving more lead time but potentially making dense patterns harder to read. This setting does not alter the actual timing windows — it is purely visual.
ScrollSpeedDefault:
3.0Range: 2.0 – 8.0 (step 0.1)Determines how quickly notes approach the judgement line. A higher value makes notes appear closer together and move faster across the screen, requiring quicker visual processing. A lower value spreads notes further apart, giving more lead time but potentially making dense patterns harder to read. This setting does not alter the actual timing windows — it is purely visual.
Snap Coloring
Snap Coloring
Setting:
Default:
SnapColoringDefault:
falseWhen enabled, note colors change based on their beat snap division (e.g., 1/4 notes are one color, 1/8 notes another). This is helpful for reading rhythmically complex patterns, especially during charting review or practice of difficult sections.Timing Lines
Timing Lines
Setting:
Default:
TimingLinesDefault:
trueToggles the display of horizontal guide lines that travel down the playfield in sync with the beat. These lines provide a visual rhythm reference and can help you internalize the beat before notes arrive. Disable them if you find them distracting.Hide Flawless Judgements
Hide Flawless Judgements
Setting:
Default:
HideFlawlessDefault:
falseWhen enabled, the on-screen judgement splash will not appear for Flawless hits — the highest tier judgement. This keeps the playfield cleaner for players who consistently achieve Flawless hits and do not need the visual confirmation. Misses and lower judgements still display.Show Early / Late Indicator
Show Early / Late Indicator
Setting:
Default:
ShowEarlyLateDefault:
falseDisplays an “Early” or “Late” label alongside each judgement splash to indicate which direction your timing error fell. This is extremely useful for diagnosing and correcting a consistent offset bias. If you see mostly “Late” labels, try lowering your global audio offset.Judgement Splash
Judgement Splash
Setting:
Default:
JudgementSplashDefault:
trueControls whether an animated splash graphic appears near the judgement line whenever you hit a note. Disable this for a cleaner, more minimal HUD — though you will lose the instant per-note feedback that splashes provide.Lane Cover — Top
Lane Cover — Top
Setting:
Default:
Range: 0.0 – 1.5 (step 0.01)Adds an opaque cover that hides the upper portion of the playfield from view. A value of 0.0 means no cover. A value of 0.5 covers the top half of the lanes. Advanced players use this to force reading closer to the judgement line rather than tracking notes from far away.
LaneCoverTopDefault:
0.0Range: 0.0 – 1.5 (step 0.01)Adds an opaque cover that hides the upper portion of the playfield from view. A value of 0.0 means no cover. A value of 0.5 covers the top half of the lanes. Advanced players use this to force reading closer to the judgement line rather than tracking notes from far away.
Lane Cover — Bottom
Lane Cover — Bottom
Setting:
Default:
Range: 0.0 – 1.5 (step 0.01)Adds an opaque cover to the lower portion of the playfield, hiding notes just before they reach the judgement line. This is a high-difficulty technique used by experienced players to practice reading by rhythm alone. Values above 0.0 can make the game significantly harder.
LaneCoverBottomDefault:
0.0Range: 0.0 – 1.5 (step 0.01)Adds an opaque cover to the lower portion of the playfield, hiding notes just before they reach the judgement line. This is a high-difficulty technique used by experienced players to practice reading by rhythm alone. Values above 0.0 can make the game significantly harder.
Dim and Fade
Dim and Fade
Setting:
Default:
DimAndFadeDefault:
trueWhen enabled, notes fade out slightly as they travel past the judgement line, and the area around the line receives a subtle dimming effect to draw focus. Disabling this creates a more uniform playfield appearance.Hitsounding
Hitsounding
Setting:
Default:
HitsoundingDefault:
trueToggles whether hit sounds play when notes are struck. Hitsounds provide immediate auditory feedback on your timing and are an important part of the rhythm game experience for many players. The volume is controlled separately by Hit Sound Volume in the Audio section.Background Video
Background Video
Setting:
Default:
BackgroundVideoDefault:
trueEnables or disables playback of background videos embedded in maps. Disabling this can improve performance on lower-end hardware or reduce distraction during gameplay.Background Dim
Background Dim
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)Controls how darkened the background image or video becomes during gameplay. A value of 0.0 shows the background at full brightness, while 1.0 makes it completely black. The default of 0.40 provides a good balance between atmosphere and note visibility.
BackgroundDimDefault:
0.40Range: 0.0 – 1.0 (step 0.01)Controls how darkened the background image or video becomes during gameplay. A value of 0.0 shows the background at full brightness, while 1.0 makes it completely black. The default of 0.40 provides a good balance between atmosphere and note visibility.
Background Blur
Background Blur
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)Applies a blur filter to the gameplay background. Higher values create a frosted-glass effect that softens the background, which can improve note contrast on visually busy backgrounds.
BackgroundBlurDefault:
0.0Range: 0.0 – 1.0 (step 0.01)Applies a blur filter to the gameplay background. Higher values create a frosted-glass effect that softens the background, which can improve note contrast on visually busy backgrounds.
Background Pulse
Background Pulse
Setting:
Default:
BackgroundPulseDefault:
falseWhen enabled, the background subtly pulses in sync with the beat of the music. This is a purely cosmetic effect and has no impact on gameplay or performance.Lane Switch Alerts
Lane Switch Alerts
Setting:
Default:
LaneSwitchAlertsDefault:
trueDisplays a brief on-screen notification when a map’s key count changes mid-song (a lane switch event). Disable this if you find the alerts disruptive on maps you already know well.HUD Visibility
HUD Visibility
Setting:
Default:
Options:
HudVisibilityDefault:
AlwaysOptions:
Always, HideInBreaks, NeverControls when the gameplay HUD (score, combo, accuracy, etc.) is visible. HideInBreaks hides the HUD during break sections with no notes. Never hides it entirely for a clean, cinematic experience.Gameplay Leaderboard
Gameplay Leaderboard
Setting:
Defaults: Visible:
GameplayLeaderboardVisible / GameplayLeaderboardModeDefaults: Visible:
true, Mode: ScoreThe in-game leaderboard shows other players’ scores in real time during a play. GameplayLeaderboardVisible toggles it on or off. GameplayLeaderboardMode controls how entries are sorted — by Score or by Accuracy.UI
UI Scale
UI Scale
Setting:
Default:
Range: 1.0 – 1.25 (step 0.01)Scales the overall size of the game’s user interface. Useful on high-DPI displays or for accessibility. Values above 1.0 enlarge menus, buttons, and text proportionally.
UIScaleDefault:
1.0Range: 1.0 – 1.25 (step 0.01)Scales the overall size of the game’s user interface. Useful on high-DPI displays or for accessibility. Values above 1.0 enlarge menus, buttons, and text proportionally.
Hold to Confirm
Hold to Confirm
Setting:
Default:
Range: 0 – 1000 ms (step 200 ms)Sets the duration you must hold a confirm button to execute certain actions (such as deleting content or confirming an irreversible choice). Setting this to 0 disables hold-to-confirm entirely and triggers actions on a single press.
HoldToConfirmDefault:
400 msRange: 0 – 1000 ms (step 200 ms)Sets the duration you must hold a confirm button to execute certain actions (such as deleting content or confirming an irreversible choice). Setting this to 0 disables hold-to-confirm entirely and triggers actions on a single press.
Skip Intro
Skip Intro
Setting:
Default:
SkipIntroDefault:
falseWhen enabled, the animated intro sequence that plays when the game launches is skipped, taking you directly to the main menu. Recommended if you start fluXis frequently and find the intro repetitive.Parallax
Parallax
Setting:
Default:
ParallaxDefault:
trueEnables a subtle parallax depth effect on background images as you move your cursor. Disabling this creates a flatter, static background and may slightly reduce CPU usage.Show Storyboard Video
Show Storyboard Video
Setting:
Default:
ShowStoryboardVideoDefault:
trueToggles storyboard video layers within maps that include visual scripting. Disabling this turns off storyboard-driven video elements while still allowing background images to display.Show Background Shaders
Show Background Shaders
Setting:
Default:
ShowBackgroundShadersDefault:
falseEnables post-processing shader effects applied to the game background. These can be resource-intensive on lower-end systems. Disabled by default to ensure broad hardware compatibility.Audio
Global Offset
Global Offset
Setting:
Default:
Range: −1000 – +1000 ms (step 1 ms)Shifts the timing window for all notes globally, compensating for audio latency introduced by your sound system, DAC, or wireless headphones. A positive value delays the timing window (hits are accepted later), while a negative value advances it. If you consistently get “Late” judgements, increase this value; if you get “Early” judgements, decrease it.
GlobalOffsetDefault:
0 msRange: −1000 – +1000 ms (step 1 ms)Shifts the timing window for all notes globally, compensating for audio latency introduced by your sound system, DAC, or wireless headphones. A positive value delays the timing window (hits are accepted later), while a negative value advances it. If you consistently get “Late” judgements, increase this value; if you get “Early” judgements, decrease it.
Inactive Volume
Inactive Volume
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)The audio volume level when the fluXis window is not focused. Setting this to 0 will mute the game entirely when you tab away. The default of 0.50 keeps music audible at half volume in the background.
InactiveVolumeDefault:
0.50Range: 0.0 – 1.0 (step 0.01)The audio volume level when the fluXis window is not focused. Setting this to 0 will mute the game entirely when you tab away. The default of 0.50 keeps music audible at half volume in the background.
Hit Sound Volume
Hit Sound Volume
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)Controls the volume of hit sound effects independently of the main audio track. Lowering this lets you hear the music more clearly while still getting some auditory feedback from keypresses. Set to 0.0 to silence hitsounds without disabling them entirely.
HitSoundVolumeDefault:
1.0Range: 0.0 – 1.0 (step 0.01)Controls the volume of hit sound effects independently of the main audio track. Lowering this lets you hear the music more clearly while still getting some auditory feedback from keypresses. Set to 0.0 to silence hitsounds without disabling them entirely.
UI Panning
UI Panning
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)Controls the stereo panning width of UI sound effects (button clicks, menu transitions, etc.). A value of 1.0 uses the full stereo field; 0.0 centers all UI audio to mono. This does not affect gameplay hitsounds.
UIPanningDefault:
0.75Range: 0.0 – 1.0 (step 0.01)Controls the stereo panning width of UI sound effects (button clicks, menu transitions, etc.). A value of 1.0 uses the full stereo field; 0.0 centers all UI audio to mono. This does not affect gameplay hitsounds.
Hitsound Panning
Hitsound Panning
Setting:
Default:
Range: 0.0 – 1.0 (step 0.01)Controls the stereo panning width of gameplay hitsounds. At 1.0, hitsounds for notes in the leftmost lane come from the left speaker and rightmost from the right. Reducing this towards 0.0 moves all hitsounds toward the center channel.
HitsoundPanningDefault:
1.0Range: 0.0 – 1.0 (step 0.01)Controls the stereo panning width of gameplay hitsounds. At 1.0, hitsounds for notes in the leftmost lane come from the left speaker and rightmost from the right. Reducing this towards 0.0 moves all hitsounds toward the center channel.
Graphics
Show FPS
Show FPS
Setting:
Default:
ShowFpsDefault:
falseDisplays a real-time frames-per-second counter in the corner of the screen. Useful when diagnosing performance issues or monitoring the effect of visual settings on framerate.Disable Bloom
Disable Bloom
Setting:
Default:
DisableBloomDefault:
falseDisables the bloom post-processing effect that creates a soft glow around bright UI elements and notes. Disabling bloom can noticeably improve performance on integrated graphics or low-end GPUs, and some players prefer the sharper look without it.Account
Username
Username
Setting:
Default: (empty)Stores your fluXis account username, populated automatically on successful login.
UsernameDefault: (empty)Stores your fluXis account username, populated automatically on successful login.
Token
Token
Setting:
Default: (empty)Stores your authentication token for the fluXis online service. This token is used to authorize all online interactions including score submission and profile updates.
TokenDefault: (empty)Stores your authentication token for the fluXis online service. This token is used to authorize all online interactions including score submission and profile updates.
Server URL
Server URL
Setting:
Default:
ServerUrlDefault:
https://fluxis.flux.moe/apiThe base URL of the fluXis API server. This should only be changed if you are running a self-hosted or development instance of the fluXis backend.