Files
game_voice_recorder/docs/dev/replay-3d.md
2026-10-17 13:12:42 +09:00

4.8 KiB
Raw Blame History

3D 리플레이 · 대화 동기화 (작업 노트, 2026-10-17)

결론 (조사)

  • 발로란트는 리플레이 재생 위치를 주는 API가 없다 (로컬 API는 "리플레이 보는 중"까지). 2026-10-17 사용자 ShooterGame.log 에도 재생 위치는 없다 (열기 · 닫기 · 매치 ID · 시간 옮길 때 선수 재생성만 남음).
  • 그래서 인게임 리플레이를 따라가지 않고, .vrf 를 풀어 사이트에서 재생한다. 대화는 사이트 플레이어 "현장 모드" 시계(sceneTs)에 묶여 재생 · 멈춤 · 이동 · 배속이 같이 움직인다.

구성

  • tools/replay-extract/ (C#, net10): ValorantReplayParser(MIT, fetch-parser.sh 로 고정 커밋을 vendor/ 에 받음) → gvr-replay JSON v1
    • 선수 10명 이동 10Hz (x,y,z,yaw,pitch) · 라운드(구매/교전/끝) · 킬 · 사격 · 스킬/설치물(스파이크 TimedBomb_C 포함) · recordedAt(녹화 시작, ReplayInfo.Timestamp)
    • 13.08 실제 경기(73.8MB): 6초, JSON 5.3MB / gzip 1.4MB, 진단 0
  • 사이트 site/web/src/lib/replay.ts (동기화 · 보간 · 죽음 판정), components/ReplayViewer.tsx (three.js, 지연 로드), ReplayPanel.tsx
    • 동기화: ts = recordedAt + t + offset, offset = 같은 킬(죽인/죽은 puuid)의 경기 기록 ts − 리플레이 시각의 중앙값. 킬이 3개 미만이면 라운드 교전 시작으로.
    • 3D: 바닥은 미니맵, 선수는 실제 높이. 맵 벽 · 지형 3D 모델은 없음 (게임 파일 추출 필요 · 저작권 문제로 보류)
  • 목 서버: GVR_MOCK_REPLAY=<json> GVR_MOCK_REPLAY_MAP_FILE=<어비스 png> npm run dev → /matches/val-replay-demo (경기 기록 킬을 1234ms 늦게 찍어 동기화 확인)

남은 일

  1. 앱: %LOCALAPPDATA%\VALORANT\Saved 아래 <matchId>.vrf 찾기 → gvr-replay.exe 실행 → GVR-Data/replays/<matchId>.json.gz → GET /api/matches/:id/replay (content-encoding gzip, 사이트는 /api/* 그대로 중계)
  2. 빌드: win-ci 에 .NET SDK 설치 · dotnet publish -r win-x64 단일 파일 → electron-builder extraResources replay/
  3. 실제 경기로 동기화 오차 확인 (사이트 아래 줄 "킬 N개로 맞춤 (최대 오차 X초)")

완전 3D (맵 · 캐릭터 · 총 · 효과) 조사 (2026-10-17)

  • 게임 파일: Riot CDN 에서 바로 받을 수 있다 (게임 PC 불필요). 매니페스트는 https://clientconfig.rpg.riotgames.com/api/v1/config/public?namespace=keystone.products.valorant.patchlines 의 *.manifest, 받기는 Morilli/ManifestDownloader (-b https://valorant.secure.dyn.riotcdn.net/channels/public/bundles --no-langs -f 'ShooterGame/Content/Paks/(pakchunk|global)'), 13.08 기준 34GB · 10분.
  • 열기: CUE4Parse (EGame.GAME_Valorant, 공개 AES 키, 리눅스 Oodle 자동 다운로드) → 파일 396,466개, Maps/Infinity/*.umap 확인.
  • 매핑: 13.08 부터 패키지가 unversioned → .usmap 필요. 공개 배포처가 있다: https://uedb.dev/svc/api/v1/valorant/mappings (패치별 JSON → Brotli/ZStandard usmap URL, 13.08 은 2026-10-16 갱신), AES 는 .../valorant/aes. 출처: sinnafuls/cue4parse-mcp games.example.json.
    • 이전에 시도한 다른 게임 매핑(Remnant2 등)은 틀린 매핑이라 배열 길이를 잘못 읽어 메모리가 폭주했다 (17.6GB). 올바른 매핑으로는 어비스 전체 읽기 최대 1.3GB · 9초.
    • Uiana-MapImporter(djhaled) 는 UE4 시절(2023, 매핑 불필요) 코드라 그대로는 안 됨 (발로란트 UE5.3 전환은 11.02).
  • 어비스 결과 (2026-10-17): Maps/Infinity/Infinity_Art_*.umap 17개 → StaticMesh 컴포넌트 2,237 + ISM 인스턴스 1,833 = 배치 3,632, 고유 메시 991 (전부 pakchunk0/1 안, 받기 11GB · 3분), 삼각형 136만 (최저 LOD). glb 146MB.
    • 좌표: 리플레이 선수 x,y,z 와 맵 월드 좌표(UE cm)가 변환 없이 일치 (선수 점이 통로 위에만 찍힘). glb 는 (x,z,y)*0.01 로 저장되므로 되돌릴 때 주의.
    • 위에서 볼 때 지붕을 걸러야 한다 (Z 1500cm 이상 삼각형 제외로 미리보기 확인).
    • 추출기: ~/work/valoexp (CUE4Parse, 명령 where/deps/scene/export), 합성 · 미리보기 ~/work/valomap/tools/compose.py. CUE4Parse glTF 내보내기가 리눅스에서 \ 경로로 파일을 쓰는 버그가 있어 옮겨야 함.
    • 보관: nextcloud claude/game-voice-recorder/valorant/13.08/ (nextcloud 에서는 claude/ 폴더 안만 다룬다, 사용자 규칙) (abyss-13.08.tar.gz = glb · scene.json · 미리보기 · usmap · 도구 사본, usmap 단독). 계정은 secrets nextcloud.192.168.10.10.
  • 실험은 반드시 systemd-run --user --scope -p MemoryMax=6G -p MemorySwapMax=0 안에서.
  • 디스크: .9 는 150GB 이상 비워 둔다 (사용자 요청). 게임 파일은 다시 받을 수 있으므로 지웠다. 큰 결과물은 nextcloud(.10:8080)로 (로그인 정보 필요).