Installing Mods

How to install Friday Night Funkin’ mods on different platforms

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

Mod doesn't appear in game

• 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

Game crashes on startup

• 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

Assets not replacing correctly

• 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)

Can't find mods folder on mobile

Android: Enable “Show hidden files” in your file browser

iOS: 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