Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/misterfnflover787/v-extended-fnf/llms.txt

Use this file to discover all available pages before exploring further.

The HUD options page controls two visual overlays that sit on top of the gameplay scene: a gray lane background drawn beneath the strumline, and a song-progress time bar displayed near the strumline. Both are optional, and each exposes a set of fine-tuning controls for size, opacity, and content.

Strumline Background

The Strumline Background draws a solid dark-gray (0xFF2B2B2B) panel spanning the full screen height behind each strumline column. It sits above the game scene (camera layer) but below the HUD, so it frames the note lanes without covering health bars or the score display.
Strumline Background
checkbox
default:"false"
Adds a gray lane background behind the player and opponent strumlines. The panel is drawn on the HUD camera and sized dynamically to match the width of each strumline, with a small horizontal padding on each side.
Strumline BG Opacity
number
default:"35"
Changes the opacity of the gray strumline background. Accepts values from 0 to 100 in steps of 5, displayed as a percentage (e.g. 35%). Has no effect when Strumline Background is disabled.
  • Min: 0%
  • Max: 100%
  • Step: 5

Time Bar

The Time Bar is a thin progress bar anchored near the player strumline that fills left-to-right as the song advances. It consists of a dark semi-transparent background, a white fill strip, and an optional text label rendered in the VCR font.
The time bar automatically detects whether Downscroll is active by checking the first receptor’s Y position against the screen midpoint. In Upscroll mode the bar appears above the strumline; in Downscroll mode it appears below the strumline. The Time Bar Vertical Offset shifts the bar downward from the auto-calculated position in both modes — see that option for details on how the gap between bar and strumline is affected.
Time Bar
checkbox
default:"true"
Shows the current song progress near the strumline. When disabled, no bar, fill, or label is drawn and the remaining Time Bar options have no visible effect.
Time Bar Text
string
default:"Song Name"
Selects which information is displayed in the center of the time bar. Choose from five modes:
ValueDisplay example
Song NameBopeebo
Song + DifficultyBopeebo [HARD]
Time LeftTime Left: 1:23
Time ElapsedTime Elapsed: 0:45
Nothing(bar only — no text rendered)
The difficulty string is automatically uppercased and has hyphens replaced with spaces (e.g. erect-remixERECT REMIX).
Time Bar Width
number
default:"520"
Changes the width of the time bar in pixels. The bar is always centered horizontally on screen.
  • Min: 320 px
  • Max: 760 px
  • Step: 20
Time Bar Height
number
default:"14"
Changes the height of the time bar in pixels. A 2 px border is added around the fill area, so the visible background is always height + 4 px tall.
  • Min: 8 px
  • Max: 24 px
  • Step: 2
Time Bar Vertical Offset
number
default:"8"
Nudges the time bar downward from its auto-calculated position. Values are displayed with a leading + sign (e.g. +8 px).The effect on gap between the bar and the strumline depends on scroll direction: in Downscroll, the bar sits below the receptors, so increasing this value widens the gap. In Upscroll, the bar sits above the receptors, so increasing this value shrinks the gap (moves the bar toward the receptors). A value of 0 places the bar at the minimum vertical distance from the strumline in both modes.
  • Min: 0 px
  • Max: 24 px
  • Step: 2
Time Bar Opacity
number
default:"72"
Changes the opacity of the dark time bar background panel. The white fill strip and text label are always fully opaque regardless of this setting.
  • Min: 20%
  • Max: 100%
  • Step: 5

Build docs developers (and LLMs) love