Repository navigation
GF2VR 1.3.3
1.3.3 — 한국어
VR 연결 자동 복구
- 게임 실행 중 VR 세션이 오류로 끊기면 지금까지는 게임을 다시 시작할 때까지 VR이 돌아오지 않았습니다. 이제 끊긴 세션을 정리한 뒤 10초 간격으로 최대 6번 새 세션을 만들어 다시 연결합니다. 다시 연결된 세션이 60초 이상 유지되면, 이후의 끊김에서도 다시 6번까지 시도합니다.
- 다시 연결하는 경우: 프레임 제출·이미지·스왑체인 오류, VR 런타임의 세션 손실, 런타임 이벤트 오류.
- 다시 연결하지 않는 경우: SteamVR 등에서 사용자가 앱을 종료한 경우, 게임을 끄는 경우, 게임의 그래픽 장치가 바뀐 경우.
- "처음 활동층에 들어갈 때 VR이 풀리고 메인 메뉴로 나와도 돌아오지 않는다"는 보고를 반영했습니다. 한 번 끊기면 다시 연결하지 않던 동작이 원인으로 확인되어 이를 고쳤습니다. 다만 끊기게 된 계기(PC 사양에 따른 부하 등)는 보고 로그가 없어 확인하지 못했습니다. 여전히 복구되지 않으면 로그 저장과 전달 안내에 따라 로그를 보내 주세요.
로그 저장과 전달
- Settings 진단 탭에 로그 폴더 열기 버튼을 추가했습니다. 버튼 아래에 저장 위치가 표시되며, 아직 로그가 없으면 켜는 방법을 안내합니다.
- 로그를 켜고 개발자에게 보내는 방법을 로그 저장과 전달 문서로 정리했습니다(4개 언어).
- 이번 버전의 로그 파일 이름은 Dirty
GF2VR-DIRTY-133-006.jsonl, CleanGF2VR-CLEAN-130-002.jsonl입니다.
기타
- 1.3.2는 내부 후보로 철회되어 공개되지 않았습니다. 1.3.1의 기능(눈 렌더 직전 머리 자세 재획득 등)은 그대로 포함됩니다.
- VR 실행 파일(native 006)은 1.3.1의 004에 위 복구 기능만 더했습니다. Settings와 Installer는 새 VR 실행 파일에 맞춰 다시 빌드했으며 버전은 1.3.3입니다.
검증 범위와 알려진 제한
- 복구 동작은 호스트 테스트(재시도 정책 36개 항목)와 기존 네이티브 테스트 24종으로 확인했습니다. 실제 끊김 상황을 재현할 수 없어, VR 기기에서 끊긴 뒤 다시 연결되는 모습은 직접 확인하지 못했습니다.
- 이번 VR 실행 파일(Clean·Dirty 006)은 동일 바이트 재생산과 호스트 테스트로만 검증했으며, 게임과 VR 기기에서 직접 실행해 보지 않았습니다. 복구 코드는 세션이 오류로 끝난 뒤에만 작동하고 평소 동작은 1.3.1과 같도록 만들었습니다.
- Main 화면에서 고개를 돌릴 때의 지연·기울어짐 느낌은 계속 조사 중입니다.
업데이트 방법
게임을 종료한 뒤 Settings의 새 버전 안내에서 업데이트에 동의하세요. 수동 설치는 사용하는 버전(Clean/Dirty)의 ZIP을 새 폴더에 모두 푼 뒤 포함된 Installer에서 게임 폴더를 선택하세요. 변경되거나 누락된 설치 파일은 Installer의 복구 설치를 사용할 수 있습니다.
다운로드: Assets에서 Clean 또는 Dirty ZIP 하나를 선택하세요. Source code ZIP은 설치 패키지가 아닙니다.
1.3.3 — English
Automatic VR reconnection
- Until now, if the VR session failed while the game was running, VR did not come back until the game was restarted. Now the failed session is cleaned up and a new session is created up to 6 times, 10 seconds apart. If a reconnected session stays up for 60 seconds or more, a later disconnection again gets up to 6 attempts.
- Reconnects after: frame submission, image or swapchain errors, a session lost by the VR runtime, and runtime event errors.
- Does not reconnect when: you exit the app from SteamVR or similar, you close the game, or the game's graphics device changes.
- This addresses the report "VR drops when first entering the Activity floor and does not come back, even after returning to the main menu". We confirmed that VR was never reconnected once a session failed, and fixed that. What triggers the disconnection (for example PC load) could not be confirmed because no log was available. If VR still does not recover, please send a log as described in Saving and sending logs.
Saving and sending logs
- Added an Open log folder button to the Settings Diagnostics tab. The location is shown below the button; if no log exists yet, it explains how to turn logging on.
- New guide Saving and sending logs on turning logging on and sending logs to the developer (four languages).
- Log file names in this version: Dirty
GF2VR-DIRTY-133-006.jsonl, CleanGF2VR-CLEAN-130-002.jsonl.
Other
- 1.3.2 was an internal candidate that was withdrawn and never published. Everything in 1.3.1 (including late head-pose re-acquisition) is included.
- The VR binary (native 006) is 1.3.1's 004 plus the reconnection above. Settings and Installer were rebuilt for the new VR binary; their version is 1.3.3.
Verification scope and known limitations
- Reconnection was verified with host tests (36 retry-policy checks) and the 24 existing native test suites. A real disconnection could not be reproduced, so reconnecting on a VR device was not observed directly.
- This VR binary (Clean and Dirty 006) was verified by exact byte reproduction and host tests only; it has not been run in the game on a VR device. The reconnection code only runs after a session has ended with an error, and normal behavior is intended to be the same as 1.3.1.
- The lag/tilt feeling when turning the head on the Main screen is still under investigation.
How to update
Close the game, then accept the update in Settings' new-version notice. For a manual install, extract the whole ZIP for your variant (Clean/Dirty) into a new folder and choose the game folder in the included Installer. Changed or missing installed files can be fixed with the Installer's Repair.
Download: pick one Clean or Dirty ZIP under Assets. The Source code ZIP is not an installation package.
1.3.3 — 日本語
VR 接続の自動復旧
- これまでは、ゲーム実行中に VR セッションがエラーで切れると、ゲームを再起動するまで VR が戻りませんでした。今後は切れたセッションを片付けたあと、10 秒間隔で最大 6 回 新しいセッションを作って再接続します。再接続したセッションが 60 秒以上続いた場合は、その後の切断でも再び最大 6 回試します。
- 再接続する場合: フレーム送信・イメージ・スワップチェーンのエラー、VR ランタイムによるセッション喪失、ランタイムのイベントエラー。
- 再接続しない場合: SteamVR などでユーザーがアプリを終了した場合、ゲームを終了する場合、ゲームのグラフィックスデバイスが変わった場合。
- 「最初に活動層に入ると VR が外れ、メインメニューに戻っても復旧しない」という報告を反映しました。一度切れると再接続しない動作が原因と確認できたため修正しました。ただし切断のきっかけ(PC スペックによる負荷など)はログがなく確認できていません。それでも復旧しない場合は ログの保存と送付 の手順でログを送ってください。
ログの保存と送付
- Settings の 診断 タブに ログフォルダーを開く ボタンを追加しました。ボタンの下に保存場所が表示され、まだログがない場合は有効にする方法を案内します。
- ログを有効にして開発者に送る方法を ログの保存と送付 にまとめました(4 言語)。
- このバージョンのログファイル名は Dirty
GF2VR-DIRTY-133-006.jsonl、CleanGF2VR-CLEAN-130-002.jsonlです。
その他
- 1.3.2 は内部候補として取り下げられ、公開されていません。1.3.1 の機能(目の描画直前の頭部姿勢再取得など)はそのまま含まれます。
- VR 実行ファイル(native 006)は 1.3.1 の 004 に上記の復旧機能だけを加えたものです。Settings と Installer は新しい VR 実行ファイルに合わせて再ビルドし、バージョンは 1.3.3 です。
検証範囲と既知の制限
- 復旧動作はホストテスト(再試行ポリシー 36 項目)と既存のネイティブテスト 24 種で確認しました。実際の切断を再現できなかったため、VR 機器で切断後に再接続される様子は直接確認していません。
- 今回の VR 実行ファイル(Clean・Dirty 006)はバイト単位の再現とホストテストのみで検証しており、ゲームと VR 機器で直接実行していません。復旧コードはセッションがエラーで終わったあとにだけ動作し、通常の動作は 1.3.1 と同じになるようにしています。
- Main 画面で頭を回したときの遅延・傾きの感覚は引き続き調査中です。
更新方法
ゲームを終了してから、Settings の新バージョン案内で更新に同意してください。手動インストールでは、使用する種類(Clean/Dirty)の ZIP を新しいフォルダーにすべて展開し、同梱の Installer でゲームフォルダーを選択してください。変更・欠落したインストールファイルは Installer の修復インストールを使えます。
ダウンロード: Assets から Clean または Dirty の ZIP を 1 つ選んでください。Source code ZIP はインストールパッケージではありません。
1.3.3 — 简体中文
VR 连接自动恢复
- 以前在游戏运行中 VR 会话因错误断开后,必须重启游戏才能恢复 VR。现在会先清理断开的会话,然后 每隔 10 秒、最多 6 次 创建新会话重新连接。如果重新连接的会话保持 60 秒以上,之后再次断开时仍会重新尝试最多 6 次。
- 会重新连接的情况:帧提交、图像或交换链错误,VR 运行时导致的会话丢失,运行时事件错误。
- 不会重新连接的情况:在 SteamVR 等中由用户退出应用、关闭游戏、游戏的图形设备发生变化。
- 已处理"首次进入活动层时 VR 断开,回到主菜单也无法恢复"的报告。已确认原因是会话一旦断开就不再重连,并已修复。但由于没有日志,导致断开的起因(例如 PC 配置造成的负载)尚未确认。如果仍无法恢复,请按照 保存与发送日志 发送日志。
保存与发送日志
- 在 Settings 的 诊断 选项卡中新增 打开日志文件夹 按钮。按钮下方显示保存位置;如果还没有日志,会提示开启方法。
- 新增 保存与发送日志 指南,说明如何开启日志并发送给开发者(4 种语言)。
- 本版本的日志文件名:Dirty 为
GF2VR-DIRTY-133-006.jsonl,Clean 为GF2VR-CLEAN-130-002.jsonl。
其他
- 1.3.2 是已撤回的内部候选版本,未公开发布。1.3.1 的功能(包括眼部渲染前重新获取头部姿态等)全部保留。
- VR 程序(native 006)是在 1.3.1 的 004 基础上仅增加了上述恢复功能。Settings 和 Installer 已针对新的 VR 程序重新构建,版本为 1.3.3。
验证范围与已知限制
- 恢复行为已通过主机测试(重试策略 36 项检查)和现有 24 套原生测试确认。由于无法重现真实断开,未能在 VR 设备上直接观察断开后重新连接的过程。
- 本次 VR 程序(Clean、Dirty 006)仅通过逐字节复现和主机测试验证,尚未在游戏和 VR 设备上直接运行。恢复代码只在会话因错误结束后运行,日常行为与 1.3.1 保持一致。
- 在 Main 画面转头时的延迟与倾斜感仍在调查中。
更新方法
关闭游戏后,在 Settings 的新版本提示中同意更新。手动安装时,请将所用版本(Clean/Dirty)的 ZIP 完整解压到新文件夹,并在其中的 Installer 中选择游戏文件夹。已更改或缺失的安装文件可使用 Installer 的修复安装。
下载: 在 Assets 中选择一个 Clean 或 Dirty ZIP。Source code ZIP 不是安装包。