Logo
FNF V-Slice Mod 指南：安裝、行動端流程與排錯
FNF V-Slice Mod 指南：安裝、行動端流程與排錯

FNF V-Slice Mod 指南：安裝、行動端流程與排錯

fnf fnf
2026年7月1日
閱讀時間：6 分鐘
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 格式錯誤檢查逗號、引號和必填欄位
引擎搞錯了確認這個 Mod 面向的是官方 Polymod + HScript，而不是 Psych / Kade

出現 Polymod 錯誤彈窗

常見觸發點包括：

  • _polymod_meta.json 格式不合法
  • 缺少必填 metadata 欄位
  • 依賴的其他 Mod 沒有安裝
  • 在新版官方版本下觸發了腳本沙盒限制

歌曲能進，但沒有聲音

重點檢查：

  • 音訊檔是否使用 .ogg
  • 檔名是否和 metadata 要求嚴格一致
  • 大小寫是否匹配路徑要求

更新遊戲後原本能用的 Mod 突然壞了

這通常代表 Mod 需要新的 api_version，或者腳本本身也要跟著修。優先查看 Mod 作者是否已經釋出新版本，而不是直接判斷「官方把 Mod 搞壞了」。

參考資料

官方來源

補充資料