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 changelog below reflects the features present in each known version of V-Extended and V-Extended Mobile, as documented in the respective _polymod_meta.json files. Both modpacks target Polymod API version 0.8.0 and are authored by misterfnflover787.
The modpack source code is hosted on GitHub. The repository README will be updated with detailed patch notes as future versions are released.

V-Extended (PC)

v1.4.5 (current)

The current PC release. All features listed below are present and configurable from the in-game Options → V-Extended preferences page.
  • Ghost Tapping — Prevents empty direction presses from registering as misses. Enabled by default. Migrated automatically from the legacy ghostTapping.enabled save key if present.
  • Options in Pause Menu — Adds an Options entry to the standard pause menu. Opening Options from pause fades in the Freaky Menu music and returns the player to the current song on exit.
  • Botplay in Pause — Adds an Enable Botplay / Disable Botplay toggle to the standard pause menu. Selecting it restarts the song with botplay flipped; in botplay mode the song navigates to Freeplay on completion instead of showing the results screen.
  • Middlescroll — Centers the player strumline horizontally and splits the opponent strumline across the far left and far right of the screen, with opponent notes and hold covers repositioned to match.
  • Opponent Notes Opacity — Scales the alpha of all opponent receptors, notes, sustain trails, and hold covers. Configurable from 0 % to 100 % in steps of 5 %.
  • Strumline Background — Renders a dark grey (#2B2B2B) lane background behind each strumline at z-index 700 (opponent) and 701 (player). Width tracks the live receptor positions each frame. Hidden automatically behind the opponent strumline when Middlescroll is active.
    • Strumline BG Opacity — Configurable from 0 % to 100 %, default 35 %.
  • Time Bar — Draws a song progress bar near the strumline (above on upscroll, below on downscroll). Supports five display modes for the label text:
    ModeLabel
    0Song Name
    1Song Name + Difficulty
    2Time Left
    3Time Elapsed
    4Nothing
    • Width — 320 px – 760 px, default 520 px.
    • Height — 8 px – 24 px, default 14 px.
    • Vertical Offset — 0 px – 24 px additional downward offset, default 8 px.
    • Background Opacity — 20 % – 100 %, default 72 %.
    • Migrated automatically from the legacy vslice-time-bar.displayMode save key if present.
  • Detailed Score Counter — Replaces the standard FNF score text with a three-part VCR bitmap font display showing score, missed notes, accuracy percentage, and a Freeplay-style rank letter. Rank letters and their thresholds:
    LetterCondition
    P (gold)All Sicks
    P (pink)Full completion (no misses, non-all-Sick)
    E≥ 90 % completion
    G≥ 80 % completion
    G (orange)≥ 60 % completion
    LBelow 60 %
  • Score Counter Outline — Adds a black FlxTextBorderStyle.OUTLINE to all three score text objects.
    • Score Outline Size — 1 px – 4 px, default 2 px.
  • Accuracy Precision — Selects how many decimal places are shown for the accuracy percentage: 0, 1, or 2 decimals (default 2).

V-Extended Mobile

v1.2.1 (current)

The current Mobile release. All features listed below are configurable from the in-game Options → V-Extended preferences page. Ghost Tapping and Middlescroll are not present in the Mobile edition.
  • Options in Pause Menu — Same behaviour as the PC edition. The Mobile options module also calls fitMobilePauseMenu() after injecting entries, redistributing item positions to prevent overflow on smaller screens.
  • Botplay in Pause — Same behaviour as the PC edition, including the Freeplay redirect on song completion.
  • Alternative Note Input — Switches the active controls scheme to "Four Lanes" (full-screen four-lane touch input) while keeping both strumlines rendered in their standard desktop positions. The previous controls scheme is saved to previousControlsScheme and restored when the option is disabled. Changes take effect on the next song start or restart.
  • Opponent Notes Opacity — Identical to the PC edition (0 % – 100 %, step 5 %). When Alternative Note Input is disabled, the opponent strumline is also shifted 48 px to the left each frame to account for the mobile layout.
  • Strumline Background — Same functionality as the PC edition with an additional configurable padding option:
    • Strumline BG Opacity — 0 % – 100 %, default 35 %.
    • Strumline Background Padding — How far the background extends beyond the outermost receptor on each side. 0 px – 40 px, default 14 px. (The PC edition uses a fixed 16 px padding.)
  • Time Bar — Full configuration identical to the PC edition (five display modes, width, height, vertical offset, background opacity). The Mobile implementation caches the last rendered label string and only rebuilds the FlxBitmapText when the label changes, reducing per-frame allocation on mobile hardware.
  • Detailed Score Counter — Same rank letter system and three-part layout as the PC edition.
    • Score counter updates are throttled to once every 50 ms and driven by a scoreDirty flag set by onNoteHit and onNoteMiss, reducing per-frame string allocation on mobile hardware.
  • Score Counter Outline — Identical to the PC edition.
    • Score Outline Size — 1 px – 4 px, default 2 px.
  • Accuracy Precision — Identical to the PC edition (0, 1, or 2 decimal places, default 2).
  • Mobile Pause Menu Spacing — When Options or Botplay entries are injected, fitMobilePauseMenu() recalculates vertical spacing so all entries fit between y = 82 and y = (screen height − 92), with a maximum gap of 92 px per item.
See Installation for how to update your modpack folder.

Build docs developers (and LLMs) love