第三人稱視角切換器

這個模組允許你通過可自定義的熱鍵（默認：F3）在第一人稱和第三人稱視角之間切換。通過INI文件進行簡單配置。

Third Person View Toggle

🎮 **在波希米亞中世紀世界中體驗全新視角！**

✨ 核心功能

• **一鍵切換**：按F3鍵（可自定義）在第一人稱和第三人稱視角間自由切換
• **專用按鍵**：設置專用按鍵強制切換到第一人稱或第三人稱視角
• **智能切換**：開啓菜單/對話時自動切換到第一人稱視角
• **自定義視野**：爲第三人稱視角設置專屬的視野角度（FOV）
• **完全可配置**：通過INI文件自定義所有設置
• **開源透明**：完全開源，代碼公開透明

🛠️ 安裝指南

• 將壓縮包中的所有文件解壓到遊戲目錄：

```

/Bin/Win64MasterMasterSteamPGO/

```

• 啓動遊戲，按F3鍵（默認）即可切換視角

⚙️ 配置說明

編輯`KCD2_TPVToggle.ini`文件進行個性化設置：

```ini

[Settings]; 切換視角的熱鍵（十六進制，逗號分隔）

ToggleKey = 0x72; 強制切換到第一人稱視角的按鍵

FPVKey = 0x4D,0x50,0x49,0x4A,0x4E; 強制切換到第三人稱視角的按鍵

TPVKey =; 日誌級別：DEBUG, INFO, WARNING, ERROR

LogLevel = INFO; 啓用覆蓋檢測和自動相機切換

EnableOverlayFeature = true; 第三人稱視野角度（0-180度）

TpvFovDegrees = 68.75

```

🎮 手柄支持

雖然模組直接支持鍵盤輸入，但可以通過以下方式使用手柄：

• **JoyToKey**：將手柄按鍵映射到INI文件中配置的鍵盤按鍵
• **Steam輸入**：通過Steam的控制器配置將手柄按鍵映射到鍵盤按鍵

🔧 可選功能

**覆蓋檢測**：

• 開啓菜單/對話時自動切換到第一人稱視角
• 關閉菜單時恢復之前的視角
• 在覆蓋期間過濾滾輪輸入，防止相機移動

**自定義視野**：

設置`TpvFovDegrees`爲0-180之間的任意值來覆蓋默認的第三人稱視野

⚠️ 已知問題

**相機和視角限制**：

• 第三人稱視角下相機可能穿過物體（無碰撞檢測）
• 某些遊戲事件或菜單在第三人稱視角下可能顯示異常
• 騎馬時相機可能略微傾斜

**特定場景問題**：

在漢斯揹着亨利的場景中切換視角可能導致意外的相機和角色模型行爲

**推薦解決方案**：

• 在此特定場景中保持第一人稱視角
• 避免切換視角直到場景結束
• 如果意外切換，可能需要重新加載存檔

🔍 故障排除

遇到問題時：

• 在INI文件中設置`LogLevel = DEBUG`
• 檢查遊戲目錄中的日誌文件（`KCD2_TPVToggle.log`）
• 驗證控制器映射是否正確

---

📝 **依賴組件**：本模組依賴Ultimate ASI Loader，已包含在下載包中

🔗 **源代碼**：所有Kingdom Come: Deliverance II模組和工具都可以在GitHub倉庫中找到