Skip to main content

​
Overview

Installing mods in Friday Night Funkin’ is straightforward - just place mod folders in the correct location and restart the game. The process varies slightly by platform.
Always download mods from trusted sources. While the game has security measures, only install mods from creators you trust.

​
Quick Start

1

Run the game once

Start Friday Night Funkin’ at least once to create the mods folder automatically.
2

Locate the mods folder

Find the mods folder for your platform (see below).
3

Extract and install

Extract the mod from its ZIP file and place the mod folder into the mods folder.
4

Restart the game

Restart Friday Night Funkin’. The game will detect and load the mod automatically.

​
Platform-Specific Instructions

​
Windows

1

First launch

Start the game at least once. This creates a mods folder alongside the executable.
FridayNightFunkin.exe
mods/  ← Created automatically
2

Install the mod

Extract the mod you downloaded from its ZIP file, and place the mod folder into the game’s mods folder.
mods/
  └── yourmod/
      ├── _polymod_meta.json
      ├── _polymod_icon.png
      └── ...
3

Restart

Restart the game. It should detect the mod and start with it loaded.

​
Linux

1

First launch

Start the game at least once. This creates a mods folder alongside the executable.
./FridayNightFunkin
mods/  # Created automatically
2

Install the mod

Extract the mod you downloaded from its ZIP file, and place the mod folder into the game’s mods folder.
cd /path/to/game
unzip ~/Downloads/coolmod.zip -d mods/
3

Restart

Restart the game. It should detect the mod and start with it loaded.

​
macOS

1

First launch

Start the game at least once. This creates a mods folder in the game’s system files.
2

Show package contents

Right click Funkin.app and select Show Package Contents.
Funkin.app
  └── Contents/
      └── Resources/
          └── mods/  ← Navigate here
3

Navigate to mods folder

Navigate to Contents/Resources/mods.
4

Install the mod

Extract the mod you downloaded from its ZIP file, and place the mod folder into the game’s mods folder.
5

Restart

Restart the game. It should detect the mod and start with it loaded.

​
Android

1

First launch

Start the game at least once. This creates a mods folder deep in your system files.
2

Get a file browser

Get an Android file browser that lets you view app data files, or use Android Studio and open the Device Explorer.
Recommended file browsers: Solid Explorer, Total Commander, or Files by Google with “Show hidden files” enabled.
3

Locate the mods folder

Navigate to the mods folder:
/sdcard/Android/obb/me.funkin.fnf/mods
4

Install the mod

Extract the mod you downloaded from its ZIP file, and place the mod folder into the mods folder.
5

Force close and restart

Restart the game. You may need to force close the app first.The game should detect the mod and start with it loaded.
Some Android versions may require storage permissions. Grant the game access to external storage if prompted.

​
iOS

1

First launch

Start the game at least once. This creates a mods folder in your system files.
2

Open Files app

Open the Files app on your iOS device.
3

Navigate to mods folder

Navigate to:
On My iPhone → Friday Night Funkin → mods
4

Install the mod

Extract the mod you downloaded from its ZIP file, and place the mod folder into the mods folder.
You can extract ZIP files directly in the Files app by tapping on them.
5

Force close and restart

Restart the game. You may need to force close the app first.The game should detect the mod and start with it loaded.

​
HTML5/Web

Mods are not supported on the HTML5/web version of Friday Night Funkin’.To use mods, download the desktop or mobile version of the game.

​
Verifying Installation

After installing a mod, verify it loaded correctly:
  1. Check console logs - The game logs loaded mods on startup
  2. Look for changes - Asset replacements should be visible immediately
  3. Test functionality - Try the features the mod adds

​
Expected Mod Structure

A properly structured mod should look like this: 
yourmod/
├── _polymod_meta.json    # Required: Mod metadata
├── _polymod_icon.png     # Optional: Mod icon
├── data/                 # Game data overrides
├── images/               # Image replacements
├── music/                # Music replacements
├── sounds/               # Sound effect replacements
├── songs/                # Song data
└── scripts/              # HScript files
If you see the mod’s assets in-game, installation was successful!

​
Managing Multiple Mods

You can install multiple mods simultaneously: 
mods/
  ├── mod1/
  │   └── _polymod_meta.json
  ├── mod2/
  │   └── _polymod_meta.json
  └── mod3/
      └── _polymod_meta.json
Mods are loaded in alphabetical order by folder name. If mods conflict (replace the same assets), the last loaded mod takes priority.
Prefix mod folder names with numbers to control load order: 1-basemod, 2-skinmod, etc.

​
Troubleshooting

  • Verify the mod folder is directly in mods/, not nested
  • Check that _polymod_meta.json exists and is valid JSON
  • Ensure the api_version in the metadata is compatible (check mod description)
  • Look for error messages in console logs
  • Remove all mods and add them back one at a time to identify the culprit
  • Check if the mod is compatible with your game version
  • Verify all mod files extracted correctly from the ZIP
  • Ensure file paths in the mod match the game’s structure exactly
  • Check that image formats are correct (PNG for images)
  • Verify audio files are in supported formats (OGG/MP3)
Android: Enable “Show hidden files” in your file browseriOS: Make sure you’re looking in “On My iPhone”, not iCloud Drive

​
Uninstalling Mods

To remove a mod:
1

Navigate to mods folder

Open the mods folder for your platform.
2

Delete the mod folder

Simply delete the mod’s folder from the mods directory.
3

Restart the game

Restart Friday Night Funkin’ to complete the removal.

​
Next Steps

Creating Your Own Mods

Learn how to build your own mods from scratch

Scripting Guide

Add custom behavior with HScript

Build docs developers (and LLMs) love

Get started for freeTalk to us