Funkin Files

The v0.8.0 SPAGHETTI Collab and the v0.8.1 hotfix!

Some commit links may be broken due to internal rebasing.

[0.8.1] - 2026-01-04

Added

• Added a new "Non-scoreable" notekind to the Chart Editor that doesn't affect scores and ranks, or play miss animations.

Changed

• Changed the order in which events are dispatched in PlayState. (16f3e03) - by @ComedyLost in #6606

Fixed

• The last note of SPAGHETTI no longer counts toward scoring, allowing players to earn Perfect ranks.

[0.8.0] - 2025-12-31

The LE SSERAFIM collab update!

Added

• Added a new playable song: SPAGHETTI (feat. j-hope of BTS) (Clean ver.) by LE SSERAFIM (feat. j-hope)!
• Try it out from either Story Mode or the Freeplay Menu!
• Added subtitles for various cutscenes and songs throughout the game.
• This can be toggled in the Preferences menu.
• [MOBILE] Added support for Newgrounds logins and saving/loading from the cloud.
• [MOBILE] Added support for opening FNFC chart files through the filesystem.
• [MOBILE] Added haptics for tapping to begin on the Title Screen.
• [MOBILE] Added the back button to the Character Select menu.
• Added new function callbacks for Module scripts in Freeplay and Character Select.
• Added getOtherNotes() function for counting notes that are not of a certain notekind.
• Implemented stacked patches to JSON merging.
• This allows mods to add new variations to existing songs without any extra fuss. See the Code Cookbook for more information.
• Added the ability to import Osu!Mania and StepMania charts in the Chart Editor.
• Added Move Difficulty and Clone Difficulty buttons to the Chart Editor Difficulty window.
• Added a checkbox to hide vocal waveforms in the Chart Editor.
• Added support for SRT subtitles that can display in game. (a7fc70a) - by @PurSnake in #6206
• Added support for various render types and scripting for the Freeplay DJ. (8b38bcf) - by @PurSnake and @AbnormalPoof in #5698
• Level props can now have a flipX field. (4961d4e) - by @Starexify in #6218
• [LINUX] Added support for Feral Gamemode. (555ec09) - by @Noobz4Life in #2473
• Added support for importing charts from Osu!Mania. (0be42bf) - by @FuroYT in #6155
• Added a "No Animation" notekind to the Chart Editor. (618e093) - by @Eviethecoder in #4036
• Added a way to adjust time signature/BPM changes through the Metadata window in the Chart Editor. (b05a5c7) - by @Keoiki and @Lasercar in #4770
• Added character preview windows for the player and opponent in the Chart Editor. (9f59231) - by @PurSnake and @ComedyLost in #6221
• Added the option to view the Results Screen after Chart Editor playtests. (eeba677) - by @Lasercar in #4087
• Added the option to carry over Chart Editor volume levels into a playtest. (4dd87e7) - by @KoloInDaCrib in #6302
• Added the ability to time-travel during a Chart Editor playtest in release builds with PgUp and PgDown. (4a00429) - by @AbnormalPoof in #4209
• Added the Rift of the Necrodancer collab trailer to the pool of videos in Attract Mode.

Changed

• The mod API version is now 0.8.0. Please update your mods to ensure they work.
• Made some improvements to Polymod:
• Scripts can no longer accidentally redefine variables defined in their super class.
• Math and Std can now properly be used in static functions. (Thanks NotHyper-474!)
• Significantly improved the speed of retrieving modded assets, improving the performance of the game with a lot of mods installed. (Thanks PurSnake!)
• Replaced FlxAnimate with flixel-animate to overhaul texture atlas handling:
• Significantly improved performance in the Character Select Menu.
• Pico (holding Nene)’s game over confirm animation now plays properly.
• The camera now properly focuses on atlas characters after restarting the song.
• Atlas characters now properly display the rimlight shader.
• Implemented multiple new settings for atlas sprites.
• Fixed a ton of bugs across various menus.
• Re-exported many assets to improve memory usage and performance throughout the game.
• [MOBILE] Music from external sources now pauses when opening the game.
• [MOBILE] The game is now named “FNF” on the Home Screen.
• [DESKTOP] Reworked window resizing behavior to behave more consistently.
• Made it easier to implement custom Pause Menu substates.
• Pressing F6 (rebindable) now cycles through debug display modes.
• Boyfriend and Girlfriend’s scared animations in Week 2 now last longer.
• Added “Change difficulty” to the list of undo-able actions in the Chart Editor.
• Changed the default easing type for the Chart Editor Focus Camera event from Linear to Classic.
• The game now displays a user-friendly crash message when attempting to play without a graphics card. (5270353) - by @ACrazyTown in #6160
• Adjusted strumline confirm animations when hitting notes to feel more responsive. (62a3f73) - by @gamerbross in #6261
• The Lag Adjustment menu now displays a note splash when hitting perfectly. (342c3cd) - by @ExtraCode75 in #6602
• Freeplay song previews now fade out before restarting. (aaf5084) - by @JVNpixels in #6094
• The game's volume is now reduced when unfocused without pausing. (3040692) - by @PurSnake in #6250
• Optimized the way the windows in Week 3 are handled. (70d433d) - by @CrusherNotDrip in funkin.assets#291
• Script create events now also run after hot-reloading with F5, rather than only during initialization. (2f865a5) - by @VirtuGuy in #6084
• Hot-reloading with F5 during a Chart Editor playtest no longer returns to the Chart Editor. (c1988f1) - by @KoloInDaCrib in #6275
• Opening the Chart Editor during a song now places the playhead at the current song position. (71b4a58) - by @KoloInDaCrib in #6210
• The Easing property for Chart Editor events is now split into two separate dropdowns: type and direction. (d1d77dd) - by @PurSnake in #5612
• The Chart Editor Events window now supports collapsible groups. (9f6879e) - by @KoloInDaCrib in #6554
• Chart Editor BPM fields now support up to 3 decimal places. (c863ef3) - by @roma-perec-bp in funkin.assets#273
• Long difficulty and variation names are now shortened in the Chart Editor playbar. (2c4167b) - by @Lasercar in #6150
• The remaining time in the playbar now also shows a millisecond value in the Chart Editor. (2d5ef19) - by @JVNpixels in #6089
• Added more hotkeys to the Chart Editor user guide. (7d0d9eb) - by @afreetoplaynoob in funkin.assets#294
• The Stage Editor can now be opened from Freeplay to the selected capsule's stage. (1ff6a16) - by @Lasercar in #5264
• The Stage Editor now saves backups upon quitting or crashing. (5326c40) - by @Lasercar in #6190
• Stage Editor backups are now saved in the same folder as Chart Editor backups. (4f8da59) - by @CrusherNotDrip in #6297

Fixed

• Fixed some issues with Polymod:
• Modded assets now properly go in their respective asset libraries. (Thanks NotHyper-474!)
• Static functions and fields from imported scripted classes can now be used.
• Properties can now be used in a static context.
• Local variables in a function no longer get dropped if said function calls its own scriptCall function. (Thanks KoloInDaCrib!)
  • Local functions now properly report the class name.
• [DESKTOP] Switching audio devices no longer breaks audio processing.
• [HTML5] The Character Select Menu no longer crashes on Firefox.
• Pressing Escape and an arrow key with the Freeplay alternate instrumental selector open no longer crashes the game.
• Hot reloading with F5 on the Game Over screen no longer crashes the game.
• [HTML5] Restarting a video cutscene now properly plays the video again.
• [iOS] The navigation bar is no longer unlocked after watching an ad.
• [iOS] The “larger text” accessibility setting no longer causes the game to not fill the whole screen.
• [iOS] The game now displays error popups.
• [ANDROID] Keyboard detection and strumline positioning now work properly.
• [ANDROID] Taking a screenshot no longer pauses the game for a moment.
• The Title Screen no longer switches to Attract Mode while the Girlfriend’s Ringtone easter egg is playing.
• Holding Escape in the Main Menu no longer quickly closes the game.
• [MOBILE] Scrolling to another Week is no longer possible after entering a Story Week.
• [MOBILE] Long Freeplay capsule song names now properly scroll sideways.
• Exiting Character Select no longer allows mashing inputs in Freeplay.
• Controller inputs now register in the Character Select Menu.
• The player character in Character Select no longer slides in upon entering.
• The Character Select cursor no longer flies in from the top left corner.
• The Character Select cursor no longer continues to move without input after unfocusing the game.
• Video cutscenes no longer start at maximum volume for a split second.
• The input system now properly handles alternating between two keybinds bound to the same note.
• The camera now bops independently from the framerate during songs.
• The Pause Menu music now properly pauses when unfocusing with Pause on Unfocus enabled.
• Changing to the same difficulty as the current one during a Story Week no longer resets the Week score.
• More characters including parentheses now display properly in the Results Screen.
• [MOBILE] The rimlight for Girlfriend (Tankman Stickup) now renders properly.
• Character sprites with high global offsets no longer disappear near the edge of the screen.
• Fixed positions for Pico (Pixel) and Nene (Pixel), and removed the School (Pico) stage.
• Tweaked a few charts.
• [macOS] Fixed a crash related to notifications in the Chart Editor.
• [Windows] Opening the File Explorer no longer sometimes hangs in the Chart Editor.
• Pressing F4 to exit a debug editor before a tooltip appears no longer crashes the game.
• Changing the theme in the Chart Editor more than once no longer crashes the game.
• Unplugging a controller no longer crashes the Chart Editor.
• The Chart Editor measure ticks no longer cause a memory leak.
• Selecting multiple events by Ctrl-clicking in the Chart Editor no longer converts one into the other.
• Event tooltips now display all values including default ones.
• Pause on Unfocus now properly applies to Chart Editor playtests.
• Unfocusing while the Chart Editor is playing audio now pauses the playback.
• Fixed a memory leak with the Freeplay backing card scrolling text. (67846d6) - by @FuroYT in #5963
• Using a static pixel icon in Character Select no longer crashes the game. (96f8ee8) - by @VirtuGuy in #6171
• A-Bot's visualizer no longer causes a memory leak during gameplay or in Character Select. (6607645) - by @FuroYT in #5908
• The Credits menu no longer crashes when not using hardcoded credits. (4366fbe) - by @sphis-sinco in #5982
• The game no longer lag spikes when Darnell throws his can in 2hot. (a0bc6d6) - by @KoloInDaCrib in funkin.assets#313
• Hold note covers no longer get permanently stuck playing after a lag spike. (66882d9) - by @KoloInDaCrib in #6066
• Scrolling through Freeplay songs for the first time no longer stutters. (cc486ad) - by @mikolka9144 in #4851
• Re-implemented an error that appears when a video file does not exist. (2ad5933) - by @TechnikTil in #6253
• The game now properly parses .json files beginning with a bracket. (c7367ae) - by @NotHyper-474 in #6164
• The Newgrounds logo no longer covers the intro text. (28883fb) - by @hucks5 in #6196
• Exiting from the Save Data Options menu no longer exits the Options Menu as well. (26b253d) - by @VirtuGuy in #6036
• Numeric values in the Options Menu are now rounded to prevent near-zero precision errors. (934bce7) - by @Starexify in #6225
• The Test/Offset Calibration menu no longer starts playing after exiting the Lag Adjustment menu. (23a38f7) - by @VioletSnowLeopard in #6088
• [MOBILE] The Back button now fades out when entering a Week in Story Mode. (1ebce74) - by @VirtuGuy in #6255
• The Freeplay difficulty can now only be changed in one direction at a time. (95af46c) - by @Starexify in #6262
• Pico's backing card now renders properly in widescreen aspect ratios. (aa29b3d) - by @VirtuGuy in funkin.assets#297
• The album titles in Freeplay are now positioned consistently. (ed8cca4) - by @Donothan73 in funkin.assets#257
• Health icons now bop independently from the framerate. (8e6fa51) - by @PurSnake in #6035
• The note resetting animation on song restart is now consistent between Downscroll and Upscroll. (7b8d657) - by @FuroYT in #6220
• Offsets are now properly applied to stage props. (33a020a) - by @Starexify in #6224
• Notestyles now accept offset values. (193c443) - by @NebulaStellaNova in #6326
• The path for a notestyle's countdown sound is now properly loaded as a sound instead of an image. (dd5ea77) - by @gamerbross in #6232
• The Pause Menu theme no longer plays at maximum volume for a split second when pausing. (6ba44d6) - by @ComedyLost in #6334
• The scrolling text in the Results Screen is now positioned consistently. (200f798) - by @NotHyper-474 in #6595
• The scrolling text in the Results Screen is now FPS-independent. (8c43f6f) - by @VirtuGuy in #6476
• The Results Screen theme now loops more smoothly. (592bf1a) - by @FuroYT in #6477
• Transition stickers now render properly with the window resized to any aspect ratio. (4215b1c) - by @PurSnake in #6156
• Boyfriend now stands in the same position in the Week 3 and Week 3 Erect stages. (d2d15f1) - by @CEliuxJV in funkin.assets#261
• Pico's game over music now properly loops after his explosion death in 2hot. (f1a1db0) - by @KoloInDaCrib in #6216
• 2hot now smoothly transitions into the cutscene. (462b1b6) - by @hucks5 in funkin.assets#286
• Nene now swings her legs during in-game cutscenes. (6a5d9b2) - by @hucks5 in funkin.assets#289
• Nene's 50 combo animation now renders its heart properly. (bcd96ee) - by @VirtuGuy in funkin.assets#296
• A-Bot (Christmas) now properly looks at the opponent. (f81cc16) - by @ComedyLost in funkin.assets#279
• Nene (Pixel) now raises and lowers her knife properly. (1d9f50d) - by @VirtuGuy in funkin.assets#274
• Pico (Pixel)'s game over theme now plays at the right time. (e8a4d24) - by @JackXson-Real and @ComedyLost in funkin.assets#288
• Pico holding Nene's idle animation no longer lasts too long. (3483345) - by @JackXson-Real in funkin.assets#271
• The tankmen in Stress no longer briefly appear behind the speakers when restarting. (7f79ad8) - by @VirtuGuy in funkin.assets#298
• Encountering a Set Health Icon event during Minimal playtesting no longer crashes the Chart Editor. (9f0a498) - by @charlesisfeline in #6481
• Typing in Chart Editor text fields no longer triggers bound key functions. (3b5e589) - by @MightyTheArmiddilo in #6601
• Clicking between Chart Editor events no longer converts the second event's dropdown values into those of the first. (c170c25) - by @NotHyper-474 in #6211
• Chart Editor note kinds no longer lose their data when selecting multiple notes with different data. (5a2c364) - by @Lasercar in #4248
• Placing a note and removing it no longer breaks the cursor in the Chart Editor. (8cb5ed9) - by @Lasercar in #4237
• Playtesting in the Chart Editor now properly loads song variation scripts. (055f620) - by @PurSnake in #6405
• Playtesting in the Chart Editor no longer sometimes moves on to another song like Story Mode. (9497378) - by @KoloInDaCrib in #6192
• The cursor is now hidden when playtesting through the Chart Editor. (0471872) - by @VirtuGuy in #6137
• The Chart Editor note moving sound no longer plays when dragging outside the grid. (593456e) - by @amyspark-ng in #4157
• The Chart Editor music now fades in after a period of silence when enabled. (960d2f3) - by @Lasercar in #4148
• The Chart Editor Difficulty toolbox no longer displays the incorrect song name. (dff2a1e) - by @VirtuGuy in #6547
• Chart Editor notifications now display a bit higher. (9e645db) - by @MightyTheArmiddilo in #6445
• The Yes and No text in the Chart Editor exit confirmation prompt buttons now always render properly. (4c0d925) - by @NotHyper-474 in #6173
• Exiting the Chart Editor now consistently saves your audio preferences. (2f77ccf) - by @VioletSnowLeopard in #6127
• The Chart Editor and Stage Editor backup window now properly retrieves the most recently edited backup. (a8dec0c) - by @Lasercar in #6119
• The Chart Editor backup dialog no longer appears if the latest backup is deleted. (bc1d36d) - by @KoloInDaCrib in #6027
• Switching between Animation and Spritesheet mode no longer crashes the Animation Editor. (a61016d) - by @VirtuGuy in #6114
• The Animation Editor no longer displays a missing object icon next to the dropdown menus. (b30ea36) - by @KoloInDaCrib in #6177
• The Animation Editor onion skin now properly accounts for character scale and offsets. (a76a868) - by @VirtuGuy in #6123
• The debug cursor is now properly hidden when exiting the Animation Editor. (f2f6b4c) - by @VirtuGuy in #6112
• Plenty more tiny fixes.

New Contributors for 0.8.0

• @Eviethecoder made their first contribution in #4036
• @FuroYT made their first contribution in #5908
• @HeroEyad made their first contribution in #6049
• @hucks5 made their first contribution in #6196
• @Starexify made their first contribution in #6225
• @NebulaStellaNova made their first contribution in #6326
• @MightyTheArmiddilo made their first contribution in #6445
• @Donothan73 made their first contribution in funkin.assets#257
• @CEliuxJV made their first contribution in funkin.assets#261
• @roma-perec-bp made their first contribution in funkin.assets#273
• @ComedyLost made their first contribution in funkin.assets#279