Repository navigation
Releases
Gakumas VR v0.177.0
한국어
- VR 설정 메뉴 — 패널 손의 Grip을 약 0.8초 누르면 헤드셋 안에서 설정을 열 수 있습니다. 변경값을 현재 세션에 적용하거나 저장할 수 있습니다. PC 설정 프로그램과 한국어·영어·일본어 언어 선택을 공유합니다.
- 6DoF 조작 — 왼쪽 스틱 클릭으로 시점을 재정렬하고 오른쪽 스틱 클릭으로 게임 카메라 추종과 고정 시점을 전환합니다. 오른손 Grip을 잡고 손을 당겨 시점을 옮기는 월드 그립을 추가했습니다.
- VR 후처리 — 기본 블룸 프리셋 A와 새 프리셋 B를 선택할 수 있습니다. B는 게임의 블룸 강도를 유지하고 양안 투영에 맞춰 확산을 조정합니다.
- VR 손 표시 — 라이브와 비라이브 3D 스테레오 장면에서 추적된 손 위치를 표시합니다. PC 설정 프로그램과 VR 메뉴에서 켜고 끌 수 있습니다.
VR 컨트롤 안내
English
- In-headset settings — Hold Grip on the panel hand for about 0.8 seconds to open settings in VR. Apply changes for the current session or save them. The VR menu and desktop configurator share the Korean, English, or Japanese language preference.
- 6DoF controls — Click the left stick to recenter and the right stick to toggle between following the game camera and using a fixed viewpoint. Hold the right Grip and pull your hand to move the viewpoint with World Grip.
- VR post-processing — Choose the existing default bloom preset A or the new preset B. B keeps the game's bloom intensity and adjusts diffusion to the stereo projection.
- VR hand display — Show tracked hand positions in live and non-live 3D stereo scenes. Toggle this in the desktop configurator or VR menu.
VR controls
日本語
- VR設定メニュー — パネル側の手のグリップを約0.8秒長押しすると、VR内で設定を開けます。変更は現在のセッションに適用するか、保存できます。韓国語・英語・日本語の言語設定はPC設定ツールと共有します。
- 6DoF操作 — 左スティックを押し込むと視点をリセンターし、右スティックを押し込むとゲームカメラ追従と固定視点を切り替えます。右手のグリップを握って手を引き、視点を移動するワールドグリップを追加しました。
- VRポストプロセス — 既定のブルームプリセットAと新しいプリセットBを選べます。Bはゲームのブルーム強度を維持し、左右の目の投影に合わせて拡散を調整します。
- VRの手の表示 — ライブと非ライブの3Dステレオシーンで、トラッキングされた手の位置を表示します。PC設定ツールとVRメニューで切り替えられます。
VR操作ガイド
Gakumas VR v0.175.6
Gakumas VR v0.175.6
제작자: @TBluebox12
아카라이브 가상현실 채널: 가상현실 채널
한국어
v0.175.6는 현재 공식 공개 릴리스입니다. 현재 작업·배포 기준과 공개 stable 기준이 동일하게 v0.175.6로 맞춰져 있습니다.
- live/non-live 공간·스케일 프로필을 최종화
- 인지 크기/월드 스케일 범위: 10%~400%
- GUI 5% 단위 스텝, 자동/수동 IPD·헤드·스틱 스케일 반영
- 사용자가 선택하는 공간/스케일 설정 GUI와 기본값 구조 정리
- 설치·제거·롤백 흐름과 manifest 기반 검증을 0.175.6 기준으로 재점검
- 현재 공개 stable tag는 v0.175.6이며, 작업·배포·공개 기준이 동일하게 맞춰져 있음
배포 ZIP과 체크섬은 아래와 같습니다.
- 배포 ZIP:
GakumasVR-v0.175.6.zip - ZIP SHA-256:
1FB2CCB8E1D42A1DC5099480E11F7C7E15EC250A4C1E73A6E0957757E4836572 - 현재 설치 상태:
vrmod/install-state.json의 version0.175.6
English
v0.175.6 is the current public stable release. The working, package, and published stable baseline are all aligned to v0.175.6.
- Finalized the live/non-live spatial and scale profiles
- perceived character/world scale range: 10%~400%
- 5% GUI steps; automatic/manual IPD, head, and stick scale handling
- cleaned up the space/scale settings GUI and default structure for the v0.175.6 baseline
- Re-checked install, uninstall, rollback, and manifest validation for the 0.175.6 package
- The current public stable tag is v0.175.6, and the working, package, and published baselines are all aligned
Artifacts:
- Distribution ZIP:
GakumasVR-v0.175.6.zip - ZIP SHA-256:
1FB2CCB8E1D42A1DC5099480E11F7C7E15EC250A4C1E73A6E0957757E4836572 - Current install state:
vrmod/install-state.jsonversion0.175.6
日本語
v0.175.6は現在の正式公開リリースです。作業基準・配布基準・公開 stable 基準がすべてv0.175.6に揃っています。
- live / non-liveの空間・スケール設定を最終化
- 知覚されるキャラクター/ワールドスケール範囲: 10%〜400%
- GUI 5%刻み、IPD・ヘッド・スティックの自動/手動スケール対応
- v0.175.6基準の空間/スケール設定GUIとデフォルト構成を整理
- v0.175.6 パッケージに対するインストール/削除/ロールバックとmanifest検証を再確認
- 現在の公開 stable tagはv0.175.6であり、作業基準・配布基準・公開基準が同一になっている
配布物:
- 配布ZIP:
GakumasVR-v0.175.6.zip - ZIP SHA-256:
1FB2CCB8E1D42A1DC5099480E11F7C7E15EC250A4C1E73A6E0957757E4836572 - 現在のインストール状態:
vrmod/install-state.jsonの version0.175.6
Gakumas VR v0.174.0
Gakumas VR v0.174.0
한국어
v0.174.0은 v0.173에서 실기 승인된 6DoF·roll 격리 구조를 유지하면서 기본 조작값을 조정한 정식 릴리스입니다.
- 라이브 독립 6DoF를 기본으로 활성화
- 스냅 턴 기본값을 15°에서 30°로 변경
- 이동 속도 기본값을 1.50m/s에서 1.95m/s로 변경(정확히 1.3배)
- 15°/30°/45°/60° 선택, smooth 회전, 손 역할 교환과 physical HMD roll 보존은 그대로 유지
- 설정 GUI의 한국어·영어·일본어 안내와 기본값 복원 동작 갱신
기존 vrmod/config/settings.json은 업데이트 시 보존됩니다. 따라서 이미 저장한 값을 그대로 쓰려면 아무 작업도 필요 없고, 새 기본값 전체를 적용하려면 설정 프로그램에서 기본값을 불러온 뒤 저장하십시오.
이번 릴리스는 기본값 변경에 대한 자동 테스트·빌드·패키지 검증을 통과했으며, 별도 v0.174 VR 실기는 아직 진행하지 않았습니다. 핵심 6DoF와 roll 격리 동작의 실기 기준은 v0.173입니다.
SHA-256: 5064E59894BBF46996436AEE9DDF222201E66317A808166CA527A41B00677CCD
English
v0.174.0 is a stable release that keeps the 6DoF and roll-isolation behavior hardware-approved in v0.173 while revising product defaults.
- Independent live 6DoF is enabled by default
- Default snap turn changes from 15° to 30°
- Default movement speed changes from 1.50m/s to 1.95m/s (exactly 1.3×)
- 15°/30°/45°/60° choices, smooth turning, hand swapping, and physical HMD roll preservation remain available
- Korean, English, and Japanese configurator text and default restoration are updated
Updates preserve an existing vrmod/config/settings.json. Existing saved values therefore remain unchanged. To apply the complete new profile, load Defaults in the configurator and save.
This release passed automated tests, builds, and package validation for the default changes. A separate v0.174 VR hardware run has not yet been performed; v0.173 remains the hardware baseline for the underlying 6DoF and roll-isolation behavior.
SHA-256: 5064E59894BBF46996436AEE9DDF222201E66317A808166CA527A41B00677CCD
日本語
v0.174.0は、v0.173で実機確認された6DoFとroll分離の動作を維持し、製品デフォルトを変更した正式リリースです。
- 独立ライブ6DoFをデフォルトONに変更
- スナップターンのデフォルトを15°から30°へ変更
- 移動速度のデフォルトを1.50m/sから1.95m/sへ変更(正確に1.3倍)
- 15°/30°/45°/60°、スムーズ回転、左右交換、実際のHMD roll保持は継続
- 韓国語・英語・日本語の設定表示とデフォルト復元を更新
更新時は既存のvrmod/config/settings.jsonを保持するため、保存済みの値は変わりません。新しいプロファイル全体を適用する場合は、設定ツールで初期値を読み込み、保存してください。
このリリースはデフォルト変更に関する自動テスト・ビルド・パッケージ検証を通過しています。v0.174としての追加VR実機テストはまだ行っておらず、基礎となる6DoFとroll分離の実機基準はv0.173です。
SHA-256: 5064E59894BBF46996436AEE9DDF222201E66317A808166CA527A41B00677CCD
Gakumas VR v0.173.0
Gakumas VR v0.173.0
한국어
v0.173.0은 설정·설치·자동 업데이트와 범용 6DoF 조작을 사용자 VR 실기로 확정한 첫 정식 기준 릴리스입니다.
주요 변경:
- 비-live 3D 장면 positional 6DoF, 설정 선택형 live 독립 6DoF
- 기본 왼손 월드축 시야 회전, 오른손 최종 시야 기준 완전 3D 이동; 설정에서 좌우 교환
- 기본 15° 스냅 턴과 15°/30°/45°/60° 또는 부드러운 회전
- 스틱·scene 회전의 roll을 제거하고 실제 HMD roll 변화만 보존
- 한국어 기본의 한국어·영어·일본어 설정 GUI
- 수동 VFX, eye render scale 0.50~2.00과 고배율 경고
- clean install, Localify 공존, manifest 기반 안전 제거·rollback
- GitHub stable Release 확인 및 ZIP/SHA-256 검증 자동 업데이트
설치:
GakumasVR-v0.173.0.zip을 내려받아 별도 폴더에 압축을 풉니다.- 게임을 완전히 종료합니다.
GakumasVR.Installer.exe를 실행하고 게임 폴더를 선택합니다.- 설정은 설치된
vrmod/GakumasVR.Configurator.exe에서 변경합니다.
Meta Quest 2 + Virtual Desktop OpenXR에서 실기 확인했습니다. SteamVR OpenXR와 Meta Quest Link/Air Link는 예비 지원이며 아직 이 프로젝트에서 실기 확인하지 않았습니다. 직접 터치와 live 좌상단 시계 회귀는 이번 완료 범위에서 제외했습니다.
SHA-256:
CFC89565B303C631E0A4694774D40D4F74D19C8FC6B80E7F557E772FF121C9B0 GakumasVR-v0.173.0.zip
English
v0.173.0 is the first stable baseline whose configuration, installation, secure update flow, and general 6DoF controls have all been approved in user VR hardware testing.
Highlights:
- Positional 6DoF in non-live 3D scenes and optional independent live 6DoF
- Left-stick world-axis view turning and right-stick full-3D final-view locomotion by default, with swappable hands
- 15° snap turn by default; 15°/30°/45°/60° or smooth turning
- No roll from scene or stick rotation; only the user's physical HMD roll delta is preserved
- Korean-default Korean/English/Japanese configurator
- Manual VFX controls and eye render scale 0.50–2.00 with a high-scale warning
- Clean installation, Localify coexistence, manifest-owned uninstall, and rollback
- GitHub stable Release update checks with ZIP/SHA-256 verification
Install by extracting the ZIP, closing the game, and running GakumasVR.Installer.exe. Configure the installed mod with vrmod/GakumasVR.Configurator.exe.
Hardware validation used Meta Quest 2 with Virtual Desktop OpenXR. SteamVR OpenXR and Meta Quest Link/Air Link remain preliminary and untested by this project. Direct touch and the live upper-left clock regression check were excluded from this completion scope.
日本語
v0.173.0は、設定・インストール・安全な自動更新・汎用6DoF操作をユーザーのVR実機テストで確認した最初の正式基準リリースです。
主な変更:
- 非ライブ3Dのpositional 6DoFと、設定で有効にできる独立live 6DoF
- デフォルト左スティックのワールド軸視点回転、右スティックの最終視線基準フル3D移動。左右交換可能
- デフォルト15°のスナップターン。15°/30°/45°/60°またはスムーズ回転
- scene/スティック由来のrollを除去し、実際のHMD roll変化のみ保持
- 韓国語を既定にした韓国語・英語・日本語設定GUI
- 手動VFX、eye render scale 0.50~2.00、高倍率警告
- clean install、Localify共存、manifest所有ファイルのみの削除とrollback
- GitHub stable Release確認とZIP/SHA-256検証による自動更新
ZIPを展開し、ゲームを完全に終了してからGakumasVR.Installer.exeを実行してください。設定はインストール先のvrmod/GakumasVR.Configurator.exeで変更できます。
Meta Quest 2+Virtual Desktop OpenXRで実機確認済みです。SteamVR OpenXRとMeta Quest Link/Air Linkは予備対応で、本プロジェクトでは未検証です。直接タッチとlive左上時計の回帰確認は今回の完了範囲から除外しました。
Gakumas VR v0.165.0
주요 변경 사항
- 3D 스테레오 카메라 준비 후 고정 3초 대기를 제거했습니다.
- 2 Unity 프레임과 다음 Present 경계를 확인한 뒤 첫 양안 프레임을 검증합니다.
- 유효 source 준비 후 VR 전환 시간이 실기 로그 기준 약 0.08~0.12초로 단축되었습니다.
- 클린 설치, Localify 공존 설치 및 안전한 제거 검사를 통과했습니다.
실기 확인 버전: v0.165.0
v0.164.0 — 클린 설치 사전 검증 강화
주요 변경
- GUI 설치기와 PowerShell 설치기가 게임 폴더를 변경하기 전에 payload 199개 파일의 존재·SHA-256을 전수 검사합니다.
- Doorstop, .NET 6 CoreCLR, Dobby, OpenXR Loader, VR 런타임, 설정기, 라이선스 등 클린 설치 필수 구성을 사전 검사합니다.
- 중복·누락 경로, 손상된 payload, 잘못된 설정/Dobby 보존 정책을 설치 전에 거부합니다.
- Dobby 공급 파일의 SHA-256을 빌드 단계에서 고정 검증하고
DobbyHookexport의 실제 로딩을 검사합니다. - 한글 패치가 없는 설치·제거와 기존 Localify/Dobby/사용자 설정의 공존·보존을 패키지 빌드마다 자동 검사합니다.
- 설치기의 Localify 미설치 안내를 “VR 의존성만 설치”로 한국어·영어·일본어에 맞게 수정했습니다.
검증
- Core 테스트 20/20
- 기본 Management 테스트 6/6
- 실제 배포 패키지 포함 Management 테스트 7/7
- manifest SHA-256 검증 199/199
- Dobby 및 OpenXR Loader 네이티브 로딩/export 검사 통과
- 무한글패치 클린 설치·제거 통과
- Localify, 기존 Dobby, 사용자 설정 보존 설치·제거 통과
- ZIP SHA-256:
F246FDD77EC1B44B7968AE31ACF816E0D881F371C1003A2AB180FE2AAE661111
VR 렌더와 입력 동작은 v0.163.0에서 변경하지 않았습니다. 클린 설치의 파일·의존성·설치·제거는 자동 검증했지만, 실제 Unity/Doorstop 진입과 VR 출력은 사용자 PC/VR 실기 전까지 검증 완료로 간주하지 않습니다.
v0.163.0 — Dobby 포함 설치 패키지
주요 변경
- 런타임에 필요한 Dobby를
BepInEx/core/dobby.dll경로로 배포 패키지에 포함했습니다. - 기존 Localify/BepInEx가 같은 경로의 Dobby를 제공하면 덮어쓰지 않고 보존합니다.
- 한글 패치가 없는 설치본에는 Dobby를 새로 설치하고, 제거 시 Gakumas VR이 설치한 파일만 삭제합니다.
- Apache License 2.0 전문과 Gakumas VR MIT License를 패키지에 포함했습니다.
- 로컬 사용자
settings.json대신 별도의 기본 설정을 패키징하여 개인 설정이 배포 ZIP에 섞이지 않게 했습니다.
검증
- Core 테스트 20/20
- 기본 Management 테스트 4/4
- 실제 배포 패키지 설치·제거 테스트 5/5
- package manifest SHA-256 검증 199/199
- Dobby SHA-256:
8015DE7D867245A1095D13947A63763878E4CF5FD3D3089B63CC39200B055DED - ZIP SHA-256:
45C509764071BC77C79FBAA259EAD195E26737DE32A3A103249743E9B6C8C46B
렌더·입력 동작은 v0.162.0과 동일합니다. Dobby가 없던 클린 설치 경로는 자동 설치·제거 검증을 통과했지만 새 빌드의 VR 실기 확인은 아직 진행하지 않았습니다.
Gakumas VR v0.162.0
Gakumas VR v0.162.0 (Pre-release)
Changes
- Raised the per-eye render scale range from
0.50–1.00to0.50–2.00. - Added live, value-dependent GPU load warnings to the configurator.
1.01–1.25: above the OpenXR-recommended resolution1.26–1.50: high GPU load1.51–2.00: extreme load with TDR/game-exit warning
- The warning shows estimated pixel load relative to scale
1.00. - Added Korean, English and Japanese warning text.
Important
- Render scale affects immersive 3D stereo rendering, not the flat front/hand panel source.
- Scale
2.00renders four times as many pixels as1.00. - Values above
1.00are build/config validated but still awaiting hardware VR validation. - Unique stereo rendering is currently game-rate (~59 fps measured); OpenXR submission is near 120 Hz and is not 120 unique rendered frames.
Validation
- Core tests: 20/20
- Management tests: 4/4
- Package manifest: 196/196 hashes
- Localify-preserving install verified
SHA-256: 32ACA52ACCD3B310A9593954B051625878A82CA65B66023175A28A3E7D72F8D2
Gakumas VR v0.161.0
Gakumas VR v0.161.0 (Pre-release)
Meta Quest/OpenXR VR mod for Gakuen Idolmaster (DMM version).
Highlights
- Stereo VR in live performances and approved 3D contexts
- Automatic front panel in flat contexts and left-hand auxiliary panel in 3D contexts
- Right-hand ray cursor; A/trigger click and drag; B back; stick scrolling
- Korean, English and Japanese installer/configurator UI
- Manual VFX controls: post-processing, VL Bloom intensity/diffusion, DOF, texture blur, star streak and flare
- Localify-preserving installer and rollback support
Validation status
- Meta Quest 2 + Virtual Desktop OpenXR: hardware verified
- SteamVR OpenXR / Meta Quest Link OpenXR: preliminary paths, not hardware tested
- Manual VFX controls: build/config validation complete; VR visual test pending
- Core tests 19/19; management tests 4/4; package manifest 196/196
Installation
- Close the game.
- Extract the ZIP.
- Run GakumasVR.Installer.exe.
- Select the game directory and install.
SHA-256: 58C5F8677AC59FED9A5019E479F700CE8013A64A711CD1EAF861E8C7D1C9A311