什麼是 funscript？

funscript 是描述裝置如何隨時間移動的文字檔案。播放器讓腳本與影片共用時間軸，再將位置指令傳送到相容裝置。檔案本身不包含影片。

時間與位置如何記錄

.funscript 使用 JSON 格式。主要的 actions 清單包含一系列動作：at 是以毫秒表示的時間戳記，pos 是 0 到 100 的位置值，代表行程的兩端及其間的位置。播放器在相鄰動作之間插值，裝置再依自身能力執行。

編輯時，重點是讓波峰、波谷與停頓對準影片，而不是增加越多點越好。多餘的中間點可能讓腳本難以閱讀，也不一定能改善同步效果。匯入他人的腳本後，請保留作者及授權資訊。

單軸與多軸腳本

基本 funscript 控制上下行程。支援多軸的裝置可以另外使用橫滾、俯仰或扭轉等配套軌道，各自存成檔案並一起播放。每個軸都需要對應到裝置支援的通道。詳見 OSR2 / SR6 多軸指南。

從零製作或修改現有腳本

你可以對照影片手動放置動作點，也可以在 FunGen 2 中先生成初稿，再用時間軸微調。生成後仍應預覽節奏、停頓與行程範圍，確認是否符合影片。從影片生成的操作指南介紹完整流程。

若只是修改現有檔案，可使用免費的 Online Studio（英文）。桌面版則提供更完整的生成、編輯、媒體庫與播放流程。

配合影片與裝置播放

在 FunGen 2 中開啟影片與相符的腳本，連接相容裝置，再檢查時間偏移及行程設定。The Handy 與 T-Code 裝置採用不同的連線方式。Theater 提供全螢幕播放，控制項會自動淡出，影片、腳本與裝置仍保持同步。

下載 FunGen 2，以自己的影片與腳本開始測試。