Onboarding

Onboarding：先了解工具與使用路徑

本頁先回答「FH6-HorizonTuner 是什麼、我應該從哪裡開始、使用前需要準備什麼」。具體按鈕與設定值請接著閱讀 Get Started。

這個工具解決什麼問題？

FH6-HorizonTuner 以遊戲提供的 Data Out UDP telemetry 為資料來源，將即時車輛狀態送到桌面介面與透明 HUD。它同時提供：

• 即時駕駛儀表與四輪動態資訊。
• 以車輛參數為輸入的五步驟調校工作台。
• 0–100、0–200、400 m 彈射測試。
• Session / Lap 錄製、賽後車況摘要、GPS 路線與圈速差異。
• MoTeC i2 CSV / template / 本機開啟橋接。
• 可自訂的 HUD 套件與音訊/媒體狀態整合。
• localhost read-only MCP，讓 AI 工具讀取目前 telemetry、Session、車輛資料與調校契約。

它不注入遊戲、不修改遊戲記憶體，也不代替遊戲內的調校操作。工具產出的調校建議仍需在遊戲中套用並實際測試。

先選擇你的使用路徑

你的目的	建議路徑
只想看速度、RPM、胎溫和 G-Force	安裝 Full 或 Lite → Get Started → Telemetry Dashboard
想使用透明賽車儀表	Full 或 Lite → HUD Overlay
想計算齒比、懸吊、胎壓與定位	Full → 車輛參數 → 調校工作台
想測試直線加速	Full 或 Lite → Drag Test
想比較跑圈與匯出資料	Full → 賽後分析
想讓 AI 查詢本機遙測	啟用 MCP → MCP 整合

Lite 版本只提供 Telemetry Dashboard、HUD Overlay 與 Settings；完整調校、車輛參數、Drag Test 與賽後分析請使用 Full 版本。

使用前的最小條件

1. Windows 電腦與可執行的 FH6-HorizonTuner Release Build。
2. 遊戲能正常啟用 Data Out telemetry。
3. 遊戲與工具在同一台電腦時，使用 127.0.0.1；雙設備時，使用執行工具電腦的區域網路 IP。
4. 遊戲 Data Out UDP port 與工具 Telemetry Port 必須一致，預設都是 8000。
5. 若使用 MCP，工具必須正在執行且 Settings 中的 MCP Server 必須開啟。

資料流概念

Forza Horizon Data Out
        │ UDP 8000
        ▼
FH6-HorizonTuner backend
        │ REST / WebSocket / local MCP
        ├── Full/Lite Dashboard
        ├── HUD Overlay
        ├── Recording / Analysis / Drag Test
        └── MCP clients

遊戲 UDP 8000 與 backend HTTP/WebSocket 8001 是兩個不同通道。不要把 http://127.0.0.1:8001 填入遊戲 Data Out，也不要把 UDP 8000 當成 MCP URL。

第一次成功的判定

第一次啟動不必立刻調整所有功能。先確認：

• 應用程式能開啟。
• Navigation 的 Data Out health 狀態不再顯示 disconnected。
• Telemetry Dashboard 有速度、RPM 或檔位等非零資料。
• HUD Overlay 可以啟動且能看到數值更新。
• Settings 的實際 backend port 與你要使用的 MCP URL 一致。

如果這些條件沒有達成，先看 排錯頁，不要先修改 tuning 公式或匯入資料。

資料與隱私提醒

• Session、tuning、car parameters、設定與自訂 HUD 可能儲存在執行檔旁的資料目錄；若該位置不可寫，Release Build 會使用 AppData fallback。
• 支援包可能包含診斷資料。分享前請檢查檔案內容，不要公開私人路徑、帳號或其他敏感資料。
• MCP 只綁定 localhost 使用情境；不要自行將 endpoint 暴露到公網。

English

FH6-HorizonTuner reads Forza Data Out UDP telemetry and provides dashboards, a five-step tuning workflow, HUD overlays, drag testing, session analysis, MoTeC integration, and a localhost read-only MCP server. Use Full for the complete workflow; Lite contains Dashboard, HUD Overlay, and Settings. Begin with Get Started.

日本語

FH6-HorizonTuner は Forza の Data Out UDP テレメトリーを読み取り、ダッシュボード、5 段階チューニング、HUD、ドラッグテスト、走行分析、MoTeC 連携、ローカル read-only MCP を提供します。すべての機能を使う場合は Full 版を選び、まず Get Started を確認してください。