Logo
FNF V-Slice Mod ガイド：導入手順、モバイル対応、トラブル解決
FNF V-Slice Mod ガイド：導入手順、モバイル対応、トラブル解決

FNF V-Slice Mod ガイド：導入手順、モバイル対応、トラブル解決

fnf fnf
2026年7月1日
7分で読める
FNFModガイド
modding-troubleshooting

Legacy 時代の FNF Mod は、本体ファイルを直接上書きする導入方法が多く、壊しやすく元に戻しづらいものでした。公式 V-Slice エンジンが Polymod を使うようになってからは、Mod の構造、導入手順、トラブルの見方も変わっています。

このページでは、公式エンジン向け Mod の互換ルール、PC とモバイルの導入フロー、そしてよくある問題の確認方法をまとめます。

対象読者：新規プレイヤー

最終確認日：2026-07-01

確認ビルド：デスクトップ版 v0.8.4（2026-03-26）と Android v0.8.5 hotfix（2026-04-06）

はじめに：互換ルールを理解する

公式エンジンとコミュニティエンジンは別物

公式 FNF V-SlicePsych Engine / Kade Engine
Mod フォルダmods/ + _polymod_meta.jsonエンジンごとに別構造
スクリプトHScript（.hxc）多くは Lua
互換性そのままでは互換しないそのままでは互換しない

Mod ページに「Psych Engine only」と書かれているなら、公式 Itch.io / GitHub ビルドにそのまま入れても動かないと考えるべきです。

api_version をゲーム側に合わせる

公式エンジン向け Polymod Mod には、_polymod_meta.json 内に api_version が記載されています。この値は、実行しているゲームビルドの系統と互換である必要があります。

確認手順：

  1. タイトル画面やポーズメニューでゲームのバージョンを確認
  2. Mod 内の _polymod_meta.json を開く
  3. api_version と自分のビルド系統を見比べる

2026-07-01 時点で本シリーズの基準にしたのは、デスクトップ版 v0.8.4 と Android v0.8.5 hotfix です。今後の更新では、古い Mod に調整が必要になる可能性があります。

1. PC 向け公式 Mod 導入の標準形

公式エンジンは、実行ファイルの隣にある mods/ ディレクトリから Mod を読み込みます。

正しいフォルダ構造

Friday Night Funkin/
├── funkin.exe
└── mods/
    └── YourModFolder/
        ├── _polymod_meta.json
        ├── songs/
        ├── images/
        └── data/

YourModFolder を開いたとき、最初に _polymod_meta.json が見えるのが正しい形です。さらに一段深い場所に入っていると、ゲームが認識しないことがあります。

よくある落とし穴

入れ子フォルダ：

誤り: mods/MyMod-v1.0/MyMod/_polymod_meta.json
正解: mods/MyMod/_polymod_meta.json

拡張子の問題：

  • Windows では _polymod_meta.json.txt になっていることがある
  • 拡張子表示を有効にして実ファイル名を確認する

ZIP Mod：

  • 新しい V-Slice ビルドでは ZIP Mod に対応
  • ただし _polymod_meta.json はアーカイブ直下に必要

2. 公式モバイル版での流れ

公式モバイル版も同じ Polymod モデルを使いますが、アプリデータはモバイルのサンドボックス内にあります。

まずは公式ストア版を使ってください。

プラットフォーム公式入手先
AndroidGoogle Play - me.funkin.fnf
iOSApp Store

Google Play 上の公式 Friday Night Funkin Android ページ

図 1 - 著者スクリーンショット。公式 Android ストアページ。

推奨されるモバイル手順

  1. 公式 Friday Night Funkin’ を起動
  2. OPTIONS を開く
  3. OPEN DATA FOLDER を選ぶ
  4. ファイルマネージャでアプリのサンドボックスを開く
  5. Mod フォルダを内部 mods/ にコピー
  6. ゲームを再起動

未知の配布元から「Mod APK」を拾ってくるより、この方法の方がずっと安全で制御しやすいです。

3. よくあるトラブル

黒画面または起動直後クラッシュ

主な原因：

  • ゲーム本体と Mod の API 系統が合っていない
  • Mod スクリプトが現在のビルドで未対応の機能を呼んでいる

まず mods/ を一旦空にして、素の公式ビルドが正常起動するか確認してください。

Mod がメニューに出てこない

問題対応
フォルダが一段深い_polymod_meta.json が mods/ 直下の一階層に来るよう調整
metadata がない公式テンプレートを元に _polymod_meta.json を用意
JSON が壊れているカンマ、引用符、必須フィールドを確認
対象エンジンが違う公式 Polymod + HScript 向けか確認

Polymod エラーポップアップ

典型的な原因：

  • _polymod_meta.json の形式不正
  • 必須 metadata 項目の欠落
  • 依存 Mod が入っていない
  • 新しい公式ビルドで script sandbox 制限に引っかかっている

曲は開くが音が出ない

確認ポイント：

  • 音声形式が .ogg か
  • ファイル名が metadata の期待と完全一致しているか
  • 大文字小文字が正しいか

ゲーム更新後に前は動いた Mod が壊れた

多くの場合、Mod 側が新しい api_version やスクリプト調整を必要としています。まず作者が対応版を出していないか確認してください。

参考資料

公式ソース

補足資料