Playing Friday Night Funkin' - Friday Night Funkin'

Game Overview

Friday Night Funkin’ is a rhythm game where you play as Boyfriend, battling opponents in musical rap battles. Your goal is to hit notes in sync with the music, maintaining your health bar to win each song.

The game runs at 60 FPS with a resolution of 1280x720 by default. All gameplay timing is synchronized to this framerate.

Controls

Note Controls

Hit arrow notes using these keys (default bindings):

Left

A or Left Arrow

Down

S or Down Arrow

Up

W or Up Arrow

Right

D or Right Arrow

Controls.hx:118-133

// Note input definitions
public var NOTE_LEFT(get, never):Bool;
public var NOTE_DOWN(get, never):Bool;
public var NOTE_UP(get, never):Bool;
public var NOTE_RIGHT(get, never):Bool;

Controller Support: The game fully supports gamepad input! Use the D-pad or left stick for notes, and face buttons for menu navigation.

Navigate menus with these controls:

Action	Keys	Description
Navigate Up	W, Up Arrow	Move selection up
Navigate Down	S, Down Arrow	Move selection down
Navigate Left	A, Left Arrow	Move selection left
Navigate Right	D, Right Arrow	Move selection right
Accept/Confirm	Enter, Space	Select menu item
Back/Cancel	Escape, Backspace	Go back to previous menu

In-Game Controls

Action	Keys	Description
Pause	Enter, Escape	Pause the game mid-song
Reset	R	Restart the current song
Volume Up	+ (Plus)	Increase volume by 10%
Volume Down	- (Minus)	Decrease volume by 10%
Volume Mute	0 (Zero)	Toggle mute
Fullscreen	F11	Toggle fullscreen mode
Screenshot	F3	Take a screenshot (saved to `screenshots/` folder)

VolumePlugin.hx:29-32

// Rebindable volume keys
if (PlayerSettings.player1.controls.VOLUME_MUTE) FlxG.sound.toggleMuted();
else if (PlayerSettings.player1.controls.VOLUME_UP) FlxG.sound.changeVolume(0.1);
else if (PlayerSettings.player1.controls.VOLUME_DOWN) FlxG.sound.changeVolume(-0.1);

Controls can be customized in the Options > Controls menu. Your keybindings are saved per-profile.

Freeplay-Specific Controls

Action	Keys	Description
Favorite Song	Tab	Mark song as favorite
Switch Instrumental	Q / E	Change between instrumental versions
Character Select	Space	Open character selection
Jump to Top	Home	Jump to first song
Jump to Bottom	End	Jump to last song

Debug Controls (Debug Builds Only)

These hotkeys only work in debug builds or with -DGITHUB_BUILD:

View Debug Hotkeys

Action	Keys	Description
Debug Menu	~ (Tilde)	Open debug menu
Chart Editor	7	Open chart editor
Stage Editor	8	Open stage editor
Time Travel Forward	Page Up	Skip forward 2 sections (Shift: 20 sections)
Time Travel Backward	Page Down	Skip backward 2 sections (Shift: 20 sections)
End Song	1	Immediately end song
Gain Health	2	Add 10% health
Lose Health	3	Lose 5% health
Hide UI	H	Toggle UI visibility
Hot Reload	F5	Reload assets without restarting
Force Crash	Ctrl+Alt+Shift+L	Trigger crash log (main menu only)

For a complete list, see the Debug Hotkeys documentation.

Gameplay Mechanics

The Note System

Notes Approach

Arrow notes scroll up from the bottom of the screen toward the receptor arrows at the top.

Hit in Time

Press the corresponding arrow key when the note reaches the receptor. Timing determines your accuracy rating.

Maintain Health

Successful hits increase your health (green bar). Misses decrease health (red bar).

Win or Lose

Keep your health above zero to complete the song. If health reaches zero, you lose.

Timing Windows

Your accuracy is rated based on timing:

Sick!!

Perfect timing
Most health gain
Full combo intact

Good

Slightly off
Moderate health gain
Combo continues

Bad

Poor timing
Small health gain
Combo continues

Shit

Very poor timing
No health change
Combo broken

Miss: If you don’t hit a note at all, you lose health and your combo resets to zero. Multiple consecutive misses can quickly drain your health bar.

Health Bar System

The health bar at the bottom of the screen shows the battle state:

[====Opponent====|====You====]
     Red          |    Green

Green side (right): Your health
Red side (left): Opponent’s domain
The character icons move along the bar based on current health
Health reaches one extreme = game over

Scoring System

Your performance is tracked through:

Score
Combo
Accuracy
Rank

Point value based on note accuracy:

Sick: 350 points
Good: 200 points
Bad: 100 points
Shit: 50 points

Hold Notes

Longer notes require you to:

Hit the start of the note accurately
Hold the key down for the duration
Release after the note ends

Releasing a hold note early counts as a miss and breaks your combo!

Game Modes

Story Mode

Story Mode presents a narrative campaign with sequential songs:

Select a Week

Choose from available weeks (chapters). Each week contains 3-4 songs.

Choose Difficulty

Select Easy, Normal, or Hard difficulty before starting.

Play Through Songs

Complete all songs in the week sequentially. Your health carries between songs!

Watch Cutscenes

Enjoy story cutscenes between songs (can be skipped with Enter).

Complete the Week

Finish all songs without losing to unlock the next week and add songs to Freeplay.

StoryMenuState.hx:601

PlayStatePlaylist.isStoryMode = true;

In Story Mode, your health persists between songs in a week. If you barely survive song 1, you’ll start song 2 with that same low health!

Freeplay Mode

Freeplay Mode lets you play any unlocked song with more control:

Song Selection

Browse all unlocked songs from any week. Use Up/Down to navigate, Left/Right to change difficulty.

Character Selection

Play as different characters (Boyfriend, Pico, etc.) with unique vocals and styles.

Difficulty Options

Choose from multiple difficulty levels, including special variations for some songs.

Practice Mode

Perfect your skills on individual songs without story progression.

Freeplay Features:

Favorite System

Press Tab to favorite songs. Favorited songs appear at the top of your list for quick access.

Score Tracking

Your best score and rank for each song/difficulty combination is saved and displayed in the song list.

Character-Specific Content

Some characters unlock unique dialogue, artwork, and variations when selected in Freeplay.

Difficulty Levels

Each song typically offers multiple difficulties:

Difficulty	Description
Easy	Slower note speed, fewer notes, simpler patterns
Normal	Standard experience, balanced challenge
Hard	Faster notes, complex patterns, more notes
Erect ★	Remix difficulty with modified charts (select songs)
Nightmare ★	Expert-level challenge (select songs)

★ Special difficulties are only available for specific songs and may feature remixed instrumentals.

Advanced Techniques

Ghost Tapping

Ghost tapping prevents misses when you press arrow keys during sections with no notes.

project.hxp:343-344

// Ghost tapping feature flag
FEATURE_GHOST_TAPPING.apply(this, isMobile());

Enabled (Mobile Default)
Disabled (Desktop Default)

You can press any keys freely without penalty when you don’t have notes to hit. Only misses when you should hit a note but don’t.

You can enable ghost tapping on desktop with the build flag: -DFEATURE_GHOST_TAPPING

Combo Maintenance

Maintaining a high combo multiplier:

Focus on consistency over perfect hits
Anticipate patterns by watching upcoming notes
Relax your hands to avoid tension and missed inputs
Use audio cues in addition to visual timing

Input Offset Adjustment

If notes feel off-sync:

Open Options

Go to Options > Preferences

Adjust Input Offset

Modify the audio/visual offset to match your monitor and audio latency

Test and Refine

Play a familiar song and adjust until timing feels natural

This feature is only available on desktop builds with -DFEATURE_LAG_ADJUSTMENT (enabled by default).

Tips for New Players

Start on Easy

Don’t be ashamed to start on Easy difficulty! It’s the best way to learn patterns and timing.

Watch the Notes

Look ahead at upcoming notes rather than staring at the receptors. This helps you anticipate patterns.

Learn Patterns

Many songs have repeating patterns. Once you recognize them, they become much easier.

Take Breaks

If you’re struggling with a song, take a break. Fresh attempts often go better than grinding repeatedly.

Common Mistakes

Mashing keys: Pressing all arrows rapidly will break your combo. Press deliberately and in time with the music.

Ignoring hold notes: Many players miss hold notes by releasing early. Make sure to hold until the note ends.

Playing too tensely: Tension leads to slower reactions. Stay relaxed and let muscle memory guide you.

Performance Optimization

If you experience lag or performance issues:

Lower Graphics Quality

Disable visual effects in Options > Preferences

Close Background Programs

Free up system resources by closing unnecessary applications

Update Graphics Drivers

Ensure your GPU drivers are up to date

Use Release Builds

Debug builds have overhead—use release builds for optimal performance

Accessibility Options

Friday Night Funkin’ includes several accessibility features:

Naughtyness Toggle: Control explicit content display
Flashing Lights Warning: Disable intense visual effects
Colorblind Mode: Adjust note colors for better visibility
Custom Keybinds: Remap all controls to your preference
Gameplay Modifiers: Adjust scroll speed and other parameters

Access these in Options > Preferences.

Next Steps

Explore Modding

Create custom songs, characters, and more

Join the Community

Connect with other players and share tips

Chart Editor

Create your own custom charts (enable with -DFEATURE_CHART_EDITOR)

Contribute

Help improve the game on GitHub

Mobile Controls

On mobile devices (Android/iOS), the game uses touch controls:

Touch Arrows

Tap the on-screen arrow buttons to hit notes

Gesture Support

Swipe gestures for menu navigation

project.hxp:503

// Touch controls feature flag
FEATURE_TOUCH_CONTROLS.apply(this, isMobile());

Mobile builds automatically enable ghost tapping and other quality-of-life features to compensate for touch input latency.

Getting Started

Development

Modding

Game Systems

Tools

​Game Overview

​Controls

​Note Controls

Left

Down

Up

Right

​Menu Navigation

​In-Game Controls

​Freeplay-Specific Controls

​Debug Controls (Debug Builds Only)

​Gameplay Mechanics

​The Note System

​Timing Windows

Sick!!

Good

Bad

Shit

​Health Bar System

​Scoring System

​Hold Notes

​Game Modes

​Story Mode

​Freeplay Mode

Song Selection

Character Selection

Difficulty Options

Practice Mode

​Difficulty Levels

​Advanced Techniques

​Ghost Tapping

​Combo Maintenance

​Input Offset Adjustment

​Tips for New Players

Start on Easy

Watch the Notes

Learn Patterns

Take Breaks

​Common Mistakes

​Performance Optimization

​Accessibility Options

​Next Steps

Explore Modding

Join the Community

Chart Editor

Contribute

​Mobile Controls

Touch Arrows

Gesture Support

Build docs developers (and LLMs) love

Game Overview

Controls

Note Controls

Menu Navigation

In-Game Controls

Freeplay-Specific Controls

Debug Controls (Debug Builds Only)

Gameplay Mechanics

The Note System

Timing Windows

Health Bar System

Scoring System

Hold Notes

Game Modes

Story Mode

Freeplay Mode

Difficulty Levels

Advanced Techniques

Ghost Tapping

Combo Maintenance

Input Offset Adjustment

Tips for New Players

Common Mistakes

Performance Optimization

Accessibility Options

Next Steps

Mobile Controls