Settings and Storage

Settings、資料與儲存

Settings 是所有版本共用的設定頁。變更會自動保存；開始調校或測試前，建議先確認語言、單位、telemetry port 與錄製選項。

Language

目前應用程式提供動態語系載入，包含：

• 繁體中文 zh-tw。
• English en-us。
• 日本語 ja-jp。

Wiki 以中文為主；應用程式則可從 Settings → Language 切換。若切換後有少數新字串尚未翻譯，功能本身仍可使用，請將顯示問題回報至 Issues。

Game Unit Settings

可分別設定：

• 一般單位：Metric 或 Imperial。
• Power：hp、kW 或 PS。
• Spring rate：kgf/mm 或 lbs/in。

一般單位會影響速度、重量、溫度、胎壓、高度、力量與扭力等顯示；Power 和 Spring rate 可以獨立於一般單位設定。單位切換不會修改遊戲內調校設定，只改變輸入/顯示轉換。

Telemetry Receiver

• Telemetry Port 預設 8000。
• 這是接收 Forza UDP Data Out 的 port。
• 所有 network adapters 與 loopback 的接收行為受 backend 設計管理。
• 遊戲 Data Out port 必須和這裡一致。

Telemetry UDP Forwarding

開啟後，backend 會把收到的 raw binary datagram 轉發到指定的 IPv4 host/UDP port。預設目標為 127.0.0.1:5300。這是給 SimHub 或其他外部儀表的 passthrough，不會把外部工具變成 Horizon Tuner 的主要 receiver。

只有在真的需要外部工具時才開啟，並確認對方使用相容的 Forza telemetry parser。

Recording

• Dyno Recording：在全油門加速期間收集/更新引擎輸出曲線。
• Race Recording：在競賽或行駛期間記錄懸吊、抓地與其他 Session 資料，供 賽後分析 使用。

若要做 tuning capture，請使用 Developer Tuning View 的 capture 工具與完整 metadata；不要把普通 race session 當成 calibration evidence。

Discord Rich Presence

Settings 會顯示 Discord Rich Presence 狀態卡。若環境中沒有可用 Discord client 或權限不足，這只會影響 Presence 顯示，不會影響 UDP telemetry、HUD 或 tuning 主流程。

Developer Options

Use Developer Tuning View 會將 Tuning 分頁切換到實驗性 input/output view。它適合：

• 檢視模型輸入與輸出。
• 開啟 tuning telemetry capture。
• 收集帶有車輛、改裝、路面、天候與輔助設定的 A/B 測試資料。

開啟此模式後，所有輸出仍須在遊戲內驗證；它不是比 legacy tuning view 更高的保證等級。

MCP Server

MCP 設定卡可以：

• 開啟/關閉 localhost read-only MCP Server。
• 顯示目前 MCP endpoint。
• 複製 endpoint URL。

完整設定見 MCP Integration。若 Release Build 使用 dynamic port，請以設定卡顯示的 URL 為準。

Updates

Tauri Release Build 支援：

• 啟動時背景檢查（可在設定中關閉自動檢查）。
• Settings 頁面手動檢查。
• Full 與 Lite 各自使用相符的更新 manifest。
• Ed25519 signature 驗證與 sidecar lifecycle 保護。

請優先從 GitHub Releases 取得正式版本。不要自行替換 updater public key 或使用不明來源的更新檔。

Theme

Theme 功能提供：

• 日/夜 appearance mode。
• Halfmoon core theme：Default、Modern、Elegant。
• 預設色彩 preset（Primary、Secondary、Accent）。
• 自訂 accent color。
• HUD/GUI 可用的自訂 CSS 編輯入口，以及 theme JSON 匯入/匯出。

主題設定會同步到本機 local storage/backend；只改變顯示樣式，不會改變 telemetry、tuning 計算或儲存格式。自訂 CSS 請先在可恢復的 theme JSON 或版本控制中備份。

使用者資料位置

在可攜版中，以下資料優先儲存在 EXE 同級資料目錄：

settings.json
sessions/
tunings/
car_params/
lang/
hud_overlay/
logs/

若目錄不可寫，Release Build 會使用 AppData fallback。刪除或搬移 EXE 前，請先備份需要保留的設定、Session、tuning 與自訂 HUD。

English

Settings controls language, Metric/Imperial display units, power and spring units, the UDP telemetry port, optional raw packet forwarding, Dyno/Race Recording, Discord Rich Presence, Developer Tuning View, MCP, OTA update checks, and appearance themes. Release user data is stored beside the executable when writable, otherwise it falls back to AppData.

日本語

Settings では言語、Metric/Imperial、出力とスプリング単位、UDP テレメトリーポート、raw packet 転送、Dyno/Race Recording、Discord Rich Presence、Developer Tuning View、MCP、更新確認、テーマを設定できます。Release 版のユーザーデータは EXE の隣に保存され、書き込めない場合は AppData に退避します。