Files
game_voice_recorder/docs/dev/replay-3d.md
EJClaw 8782df2111 v1.10.0 릴리스 기록 · README 링크
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-21 00:07:00 +09:00

28 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 모양(아래 "맵 3D") 위에 선수를 실제 높이로. 맵 3D 가 없으면 미니맵 바닥
  • 목 서버: GVR_MOCK_REPLAY=<json> GVR_MOCK_REPLAY_MAP_FILE=<어비스 png> npm run dev → /matches/val-replay-demo (경기 기록 킬을 1234ms 늦게 찍어 동기화 확인)

맵 3D (2026-10-17, 모든 맵)

  • tools/map-extract/ (C#, CUE4Parse 고정 커밋 fetch-cue4parse.sh): 게임 파일을 받지 않고 Riot CDN 번들에서 필요한 조각만 HTTP Range 로 읽는다 (매니페스트 RMAN 파싱 src/Rman.cs, 원격 임의 읽기 src/Cdn.cs, 메모리 캐시 1.5GB, 디스크 안 씀).
    • 맵 = 하위 레벨을 불러오는 영구 레벨 (경기 기록 맵 경로 /Game/Maps/Ascent/Ascent 와 같다). 하위 레벨 중 LevelStreamingAlwaysLoaded 이고 이름이 빛 · 소리 · 게임 규칙 · 부피 · 먼 배경 · 이벤트 장식이 아닌 것만 (MapScene.NotVisual).
    • StaticMesh(+인스턴스) 가장 낮은 LOD 를 월드 좌표(cm)로 구워 맵마다 glb 하나 (위치 + 삼각형만, 재질 없음). 사이트가 높이로 색칠.
    • 13.08 실측: 22개 맵(일반 13 · 팀 데스매치 5 · 스커미시 3 · 어빌리티 드래프트 1) 3.1분, 받은 양 587MB, 최대 메모리 약 1.9GB. scripts/pack.py → gltfpack -cc + gzip 으로 맵당 0.5~4.6MB (합계 52MB).
  • 사이트: 서버 data/maps3d/index.json + <dir>/<code>.glb.gz, GET /site/maps3d* (로그인 필요). 재생기 lib/map3d.ts 가 meshopt 로 풀어 리플레이와 같은 좌표 변환 행렬로 놓는다. 맵이 있으면 미니맵 바닥 · 선수 그림자는 숨긴다.
    • meshopt 는 WebAssembly 라 CSP script-src 에 'wasm-unsafe-eval' 가 필요하다 (없으면 미니맵으로 대체됨, 헤드리스 크롬으로 둘 다 확인).
    • 천장 자르기: 자동(고른 선수 · 없으면 가장 높은 산 선수 몸 중심 + 380cm 위를 자름) · 없음 · 직접(슬라이더).
  • 자동 갱신: scripts/install.sh 가 ~/gvr-maps 에 설치, gvr-maps-update.timer 30분마다 update.sh: uedb 매핑(버전 · 갱신 시각) 또는 라이브 매니페스트가 바뀌면 매핑을 받아 ~/gvr-maps/mappings/ + nextcloud claude/game-voice-recorder/valorant/mappings/ 에 보관 → 전체 추출 → .5 data/maps3d 에 올리고 index.json 교체 (이전 폴더 1개만 남김). 어느 단계든 실패하면 이전 맵 유지, 같은 조합은 30분 · 1 · 2 · 4 · 6시간 간격으로 재시도 (첫 실패 · 성공 때 이 방 채널에 한 줄 알림, uedb/패치 확인 자체는 6번 연속 실패 때 알림). 지금 사이트에 있는 맵이 하나라도 새 결과에 없으면 올리지 않는다 (추출기도 맵 찾기 중 레벨 읽기 실패를 실패로 친다). 강제(대기 · 누락 검사 무시): ~/gvr-maps/scripts/update.sh --force. 시험: scripts/test-update.sh.

앱 (v1.5.0)

  • app/src/core/replays.ts: %LOCALAPPDATA%\VALORANT\Saved 아래(깊이 3, Logs · Crashes · Config 제외) <경기 ID>.vrf → 사이트가 열 때 gvr-replay.exe <vrf> <tmp.json> (낮은 우선순위, 한 번에 하나, 3분 제한) → gzip → GVR-Data/replays/<경기 ID>.json.gz + .src(크기:수정시각:앱 버전). 실패는 메모리에 기억 (파일이 바뀌거나 앱을 다시 켜면 다시)
  • GET /api/matches/:id/replay: 15초 안에 끝나면 200 (content-encoding gzip), 아니면 202 {status:'converting'} → 사이트가 3초마다 다시. 중계는 content-encoding 이 있으면 바이너리 조각 (relay/client.ts)
  • 빌드: win-ci replay_build 단계 (.NET 10 SDK C:\win-ci\dotnet, dotnet publish -r win-x64 단일 파일 38MB) → electron-builder extraResources replay/. 호스트 ~/win-ci/serve/gvr-test.vrf(13.08 어비스 경기) 가 있으면 변환기 · 포터블 앱 smoke(GVR_SMOKE_VRF) 둘 다 실제 변환
  • 리눅스 실측(13.08, 73.8MB vrf): 5.5초, 최대 메모리 347MB, gzip 1.4MB

완전 3D (2026-10-17, v1.7.0)

  • 맵 색: MapScene 이 재질마다 primitive 하나 (법선 · UV, 디퓨즈 텍스처 256px JPEG/PNG(알파), DiffuseColor 색). 두 층 재질(BaseEnv_Blend_*, Diffuse A/B)은 정점 색 R 로 섞는다 (extras.blend, 사이트 map3d.ts 셰이더). UE 왼손 → glTF 앞면에 맞춰 삼각형을 뒤집는다. 어비스 압축 12MB.
  • 요원: gvr-map-extract agents <폴더> → agent_<코드>.glb (요원 블루프린트 Characters/<코드>/<코드>_PC 의 3인칭 메시 LOD1, 512px 텍스처, 뼈대 + 공용 애니메이션 ub_rifle(Core_Rifle_Idle 위 몸) · lb_idle/run*/walk*(아래 몸, Skeleton·Root 는 회전만)). 애니메이션은 ACL 압축이라 CUE4Parse-Natives(ACL 만)를 g++ 로 빌드해 실행 파일 옆에 둔다 (install.sh). 30명 46초, 압축 6.4MB.
  • 무기: weapon_<이름>.glb (기본 스킨 몸 + 탄창, 원점 = 손잡이, 총구 +X). 사이트는 손목(R_Hand) 에 붙이고 보는 방향(pitch)으로 돌린다 (공용 애니메이션은 R_WeaponPoint 를 움직이지 않아 손과 떨어져 있다). 22종 1.5MB.
  • 변환기: equips [t, 선수, 종류] / equipKinds (총 영어 이름 · Melee · Spike · 스킬 클래스). 사이트 이름표 "🔫 밴달", 킬 피드에 무기. 옛 리플레이 JSON 에는 없다 (앱 v1.7.0 부터).
  • 재생기: 카메라 위에서 / 1인칭(고른 선수 눈 + 60cm, pitch) / 자유시점(WASD · Q/E · Shift, 끌어서 둘러보기). 요원은 이동 방향 · 속도로 아래 몸 애니메이션을 섞는다. 스킬은 lib/abilities.ts 가 클래스 이름으로 연막(요원 색 구) · 장판 · 폭발 · 정찰 고리 · 설치물 · 스파이크로 나눈다.
  • 한계: 스킬 효과(파티클) · 벽 스킬 방향 · 앉기 · 점프 자세 · 스킨은 없다. 리플레이 위치는 10Hz 라 빠른 움직임은 보간이다.

스킬 효과 (2026-10-18, 실감 2단계)

  • 추출: gvr-map-extract abilities <폴더> (src/Abilities.cs) → abilities.json + m_*.glb(스킬 · 투사체 · 설치물 메시, 파티클 메시) + t_*.png(256px, 큰 것 512px). 13.08 전체: 스킬 클래스 217 · 파티클 시스템 520 · 메시 373 · 텍스처 1054, 받은 양 341MB · 3.9분 · 최대 메모리 1.7GB, gzip 합계 약 40MB (json 0.8MB).
    • 발로란트 효과는 전부 Cascade ParticleSystem 이다 (Niagara 0개). 이미터마다 모양(sprite · mesh · decal · ribbon) · 재질 · 분포 표(구운 FRawDistribution) 를 그대로 옮긴다. 형식 설명은 Abilities.cs 머리말.
    • 클래스(리플레이 objectKinds) → 블루프린트 → FXC 효과 묶음 · 패치 · 투사체 컴포넌트에서 역할(loop · intro · outro · warn · trail · explode · patch · decal) 별 시스템(아군 · 적 따로).
    • update.sh 가 맵 · 요원 · 애니메이션 다음에 돌리고 pack.py 가 abilities/ 를 gzip 해 index.json abilities 로 올린다.
  • 사이트 lib/vfx.ts: 입자 상태를 "켜진 뒤 지난 시간" 만으로 계산 (입자마다 고정 난수) → 되감기 · 배속에도 같은 장면. 이미터 종류별로 인스턴스 사각형 · 인스턴스 메시 · 바닥에 눕힌 사각형 · 지나간 길(리본).
    • 재질 그래프는 쿡된 파일에 없다(매개변수 · 텍스처만). 이름 점수로 색 · 알파 텍스처를 고르고, 텍스처 채널 상관으로 색 그림 · 흑백/묶음 마스크(R)를 가린다. UE 반투명처럼 (HDR 색 × 불투명도) 를 미리 곱한 알파로 더하고 채널마다 0.8 위를 눌러 불꽃이 주황 · 노랑이 된다.
    • 연막 돔(불투명 · 마스크 큰 구)은 요원별 색(DOME) + noise + 가장자리 빛(게임 팀 색). 돔 위 반투명 층은 돔 색으로 옅게.
    • 장판(CellularPatch): 게임처럼 반지름 안 칸마다 불 효과 하나, 가운데서 SpreadSpeed 로 번진다. 그을음은 반지름 크기.
    • 뺀 것: 벽 너머 표시 · HUD · 1인칭 · 사거리 표시 · 팀 구별 층(FoF) · beam · 화면 아이콘 메시. 데이터가 예상과 다른 이미터는 그 이미터만 끈다.
    • 효과가 없는 클래스는 예전 종류별 모양, 날아가는 모습이 없는 투사체(요루 섬광 등)는 예전 빛 구 + 터지는 효과. 요루 분신 · 스파이크는 원래 그리던 것 + 효과.
  • 개발 확인: 효과 하나만 따로 그리는 판(~/.tmp/gvr/vfxHarness.ts 를 site/web/src/dev/ 에 잠시 두고 vite dev 에서 import('/src/dev/vfxHarness.ts')). 저장소에는 넣지 않았다.
  • 한계: 재질 그래프 근사라 색 · 무늬가 게임과 조금 다르다. 리본 · beam 일부, 화면 효과(섬광 눈부심 등)는 없다. 오멘 연막처럼 추출기가 클래스를 못 찾은 것은 예전 모양.

구운 조명 (2026-10-29, 실감 3단계)

  • 계기: aim.sheepu.dev(브라우저 발로란트 에임 연습장)의 맵이 게임처럼 보이는 이유를 보니 게임이 구워 둔 라이트맵(밝기 + SH 방향)을 그대로 쓴다. 우리 맵은 텍스처 × 장면 조명(하늘빛 + 해)이라 평평했다. 그 사이트 파일은 쓰지 않고 우리 추출기로 게임 파일에서 직접 뽑는다.
  • 게임 쪽: 레벨마다 <레벨>_BuiltData (UMapBuildDataRegistry). 컴포넌트 LODData[0].MapBuildDataId → FMeshMapBuildData → FLightMap2D (텍스처 · ScaleVectors/AddVectors · CoordinateScale/Bias), ISM 은 인스턴스마다 PerInstanceLightmapData[i].LightmapUVBias (HISM 은 InstanceReorderTable). 라이트맵 UV 채널은 메시 LightMapCoordinateIndex, LOD0 에만 있다 (구운 조명이 있는 배치는 LOD0, 삼각형은 거의 같다: 어센트 233만 → 235만).
    • HQ_Lightmap 텍스처(DXT5 1024²)는 위 절반 = 계수 0(UVW² · 로그 밝기), 아래 절반 = 계수 1(SH 방향 xyz · 밝기 나머지). 푸는 식은 UE LightmapCommon.ush GetLightMapColorHQ 와 같다. 햇빛 그림자까지 다 구워져 있다 (정적 조명).
  • 추출기 src/Lightmaps.cs: 메시가 차지한 칸마다 그 메시 범위로 풀어 irr(L·UVW·L0, sRGB/K) · sh(방향/L0, ±2) 두 장으로 → 칸 밖은 이웃 값으로 채움 → 1/2 씩 줄여 선반 쌓기 아틀라스(너비 GVR_LIGHTMAP 기본 2048, 넓이 약 그 제곱 안). 조명 없는 배치는 (0,0) 기본 칸(맵 평균 밝기).
    • glb: 모든 재질에 occlusionTexture(irr) · emissiveTexture(sh, 세기 0) 를 TEXCOORD_1 로, extras.lightmap.k. gltfpack 이 쓰지 않는 UV 채널을 버리지 않게 텍스처가 그 채널을 가리켜야 한다. 옛 사이트는 aoMap 으로만 써서(어두워지기만) 깨지지 않는다.
    • pack.py 는 맵을 -vtf(UV 실수) 로: gltfpack 은 재질마다 TEXCOORD_0(반복, 수십 단위) · TEXCOORD_1 을 한 범위로 양자화해서 정수로 줄이면 라이트맵이 몇 텍셀씩 어긋난다.
    • 13.09 실측: 어센트 페이지 72 → 1864×1360(1/4) 2.5MB, 어비스 116 → 1864×2176(1/4) 3.4MB. 맵 압축 크기 어센트 14.7 → 18.8MB, 어비스 12.1 → 17.4MB.
    • 메모리: 배치를 모으는 동안은 칸 목록만 두고 Build 에서 페이지를 하나씩 풀어 바로 줄인다. 처음(모든 페이지를 원래 크기로 들고 있던 것)에는 페이지 200개 넘는 펄(Pitt)이 서비스 한도 6GB 에서 OutOfMemory 였다. 고친 뒤 펄 최대 2.7GB.
  • 사이트 lib/map3d.ts installShader: 색 = 텍스처 × irr × K × max(0, 1 + dot(sh, N.yzx)) (N 은 glb 법선 = UE 월드 법선 그대로), 0.8 위는 살짝 눌러 하얗게 날지 않게. 장면 조명은 맵에 쓰지 않는다 (요원 · 효과는 그대로 장면 조명).
  • 조사 명령: gvr-map-extract lmprobe <레벨.umap> (빌드 데이터 · 텍스처 · 연결 통계, GVR_LM_DUMP=<폴더> 면 라이트맵 png).
  • 13.09 전체 (2026-10-29 반영): 맵 23개 중 22개에 조명 (아이스박스 Port 는 BuiltData 에 라이트맵이 없어 예전 장면 조명), 아틀라스 1.2~4.7MB, 사이트 폴더 303 → 403MB. 맵 추출 26분 · 서비스 최대 메모리 5.9GB(스킬 재료 단계 포함).
  • 한계: 1/4 로 줄여 그림자 가장자리가 흐리다. 움직이는 것(요원)은 구운 조명을 받지 않는다 (볼륨 라이트맵은 아직 안 씀). 어비스 낭떠러지처럼 게임에서 어두운 곳은 그대로 어둡다.

1인칭 팔 · 총 · 조준점 (2026-10-29, 실감 4단계)

  • 계기: aim.sheepu.dev 훈련 화면(밴달 + 피닉스 팔 1인칭, 흰 십자 조준점, 탄흔 · 총소리)을 보고 우리 1인칭에 없던 것을 게임 파일에서 직접 뽑았다 (그 사이트 파일은 쓰지 않음).
  • 추출 gvr-map-extract viewmodels <폴더> (src/Viewmodels.cs, 13.09 전체 39초 · 최대 1.1GB):
    • fparms_<코드>.glb 요원 1인칭 팔 Characters/<코드>/S0/1P/Models/FP_<코드>[_New]_S0_Skelmesh (30명, 브리치는 _New). 팔 메시에 같이 든 스킬 · 3인칭 조각(재질 AB_ · ABTP_ · CS_ · TP_)은 뺀다 (네온 칼날 모양, 소바 활 장갑 등).
    • fpweapon_<이름>.glb 무기 1인칭 <무기 폴더>/S0/1P/Models/(GN|EQ)_*_S0_Skelmesh + 탄창(Magazine_Main 뼈 자식) + GN_Core_*_S0_{Fire,Reload,Equip} → gun_fire · gun_reload · gun_equip (22종, 칼 · 스파이크 포함).
    • fpanim_<이름>.glb 팔 동작(뼈 노드만, 공용 뼈대 FP_Core_Retarget_Skelmesh): FP_Core_*_S0_ IdlePose|Idle · Fire|FireAdd · Reload · Equip · AltIdlePose(정조준) · WalkAdd · Activate(스파이크). 덧셈 동작은 CUE4Parse 가 기준 자세에 더해 준다.
    • 압축 합계 7.4MB, index.json viewmodels. update.sh 가 anims 다음에 돌린다.
  • 사이트 lib/viewmodel.ts: 맵과 따로 장면 하나(카메라 공간, 깊이를 지우고 맵 위에 그림). 무기 뿌리 = 팔 뼈 MasterWeapon × 회전 (0.5,−0.5,0.5,0.5) (총구 → 팔 앞, 탄창 → 아래가 되는 축 맞춤, 모든 총 같음). 눈 = 팔 Camera 뼈(대기 자세).
    • 자세는 시각만으로: 꺼내기(equips) > 재장전(states ReloadState) > 사격(shots, 60ms 총구 불꽃) > 걷기(0.2초에 30cm 넘게 움직임) > 정조준(ZoomState*) > 대기. 죽었거나 스킬 · 맨손이면 숨긴다.
    • 줌: 소총 등 1.25배, 저격총 2.5배(2단 5배) + 조준경 테두리(검은 원 · 가는 십자선), 저격 줌 중에는 팔 · 총을 숨긴다.
  • 조준점: 녹색 점 → 발로란트 기본 (흰 선 4개 · 가운데 틈 · 검은 외곽선). 1.8.2 부터 선수 조준점 · 내 조준점 (아래).
  • 안 한 것: 총소리 · 발소리(Wwise 사운드뱅크라 따로 풀어야 함), HUD 체력 · 탄약(리플레이에 값 없음), 탄흔(맞은 자리 hits 로 가능), 스킨(기본 스킨만), 스킬 1인칭 동작, 재장전 중 탄창이 손으로 옮겨 가는 것(소켓 바꾸기라 탄창이 잠깐 안 보임).

맵 텍스처 1024px · 무기 스킨 (2026-11-20, 실감 5단계)

  • 맵 텍스처: GVR_TEX 기본 256 → 1024. 원본이 대부분 512 라 크게 늘지 않는다 (13.09 어센트: 이미지 366장 8MB → 24MB, 512px 246장 · 1024px 55장, 그래픽 메모리 추정 약 620MB, 맵 추출 최대 메모리 2.5GB · 3.7분).
  • 계기: open-aim(브라우저 에임 연습장)의 맵 · 스킨 파일을 그대로 쓰는 안을 비교했다. 맵은 11개뿐(브리즈 · 프랙처 · 팀 데스매치 없음)이고 좌표계가 달라 우리 추출 맵이 낫고, 스킨은 손으로 옮긴 20개 정도라 리플레이에 기록된 실제 스킨을 쓰기로 했다. 그 사이트 파일은 쓰지 않는다.
  • 리플레이: 총 · 칼 액터마다 SkinDataAsset · SkinLevelDataAsset · ChromaDataAsset · CharmDataAsset · CharmLevelDataAsset (게임 데이터 에셋 경로)가 복제된다. 파서에 무기 액터 형식이 없어 변환기 src/Skins.cs 가 첫 읽기 필드 목록에서 이 필드가 있는 묶음(무기 클래스)을 찾아 두 번째 읽기 (13.08 어비스: 총 · 칼 기록 5,686개 모두 스킨, 서로 다른 스킨 79개, 변환 6.8 → 7.0초).
    • 출력: skins[] {skin, level, chroma, charm, charmLevel} (경로의 .Default__…_C 는 뗌), equips 4번째 열 = skins 번호(-1 모름). 줍거나 떨어뜨려도 총의 스킨은 처음 주인 것 (게임과 같다). 같은 총이라도 스킨이 다르면(주운 총) 새 줄.
  • 게임 쪽 구조: 스킨 PrimaryAsset Levels[](단계 PrimaryAsset → SkinAttachment = 단계 블루프린트) · Chromas[](색상 PrimaryAsset → EquippableSkinChroma). 높은 단계 블루프린트는 낮은 단계의 자식 클래스라 부모 사슬을 합치면 그 단계까지의 모습. 단계: Weapon 1P · Weapon 1P Cosmetic(있으면 보이는 총은 이것, 1인칭 재질도 이것 기준) · Magazine 1P · 1p MaterialOverrides · 1pMagazine MaterialOverrides · Weapon 3P · Magazine 3P · 3p Material Overrides · 3pMagazineMaterial Overrides, 칼은 NewMesh · 3p Mesh. 색상: MaterialOverrides(1인칭) · 3p Material Overrides … (재질 칸 번호대로, 기본 색상은 비어 있다). 게임 전체 색상 약 2,969개라 미리 다 뽑지 않는다.
  • 추출 gvr-map-extract skins <폴더> <요청 파일> [skins.json] (src/Skins.cs): 열쇠 "스킨|단계|색상" 마다 skin3p_<서명>.glb(weapon_.glb 형식, 512px) · skin1p_<서명>.glb(fpweapon_.glb 형식, 1024px GVR_SKIN_TEX1P, 총 동작은 기본 무기 GN_Core_*). 서명 = 메시 · 재질 경로 해시라 모습이 같은 단계 · 색상은 파일 하나.
  • 요청 흐름: 사이트가 리플레이를 열면 없는 스킨을 POST /site/maps3d/skins/want → .5 data/maps3d/skins/want.json. 이 서버 gvr-skins-update.timer(3분마다 scripts/skins-update.sh)가 요청을 가져와(한 번에 40개) 올린 맵과 같은 매니페스트 · 매핑으로 뽑고 gltfpack + gzip 해서 skins/ 에 올리고 skins/index.json 을 합친다(skins-merge.py). 못 뽑은 것은 failed (매핑 버전이 바뀌면 다시). 맵 갱신과 같은 잠금. update.sh 는 skins/ 를 지우지 않는다. 시험: scripts/test-skins.sh.
  • 사이트 lib/skins.ts: 뽑아 둔 스킨이면 3인칭 손의 총(AgentRig.setWeapon) · 1인칭 총(Viewmodel.set)을 그 모델로, 아니면 기본 총. 기본 스킨(…/Standard/…_PrimaryAsset)은 요청하지 않는다. 처음 본 스킨은 다음에 열 때부터 보인다.
  • 13.10 전체 (2026-11-20): 맵 23개 68분 · 받은 양 2.5GB (텍스처 큰 밉을 받느라 256px 때 26분보다 길다), 맵 압축 13~56MB, 사이트 폴더 818MB. 매핑은 uedb 가 13.09 에 멈춰 있어 valorant-api.com (/v1/version 의 manifestId 가 라이브와 같을 때 mappingsUrl) 으로 받았다 (update.sh).
  • 한계: 총 장식(참) · 스킨 전용 동작 · 효과(빛나는 재질 · 단계별 VFX) · 처치 연출은 없다. 재질은 디퓨즈 텍스처만이라 빛나는 부분은 평평하다.

남은 일

  • 실제 경기로 동기화 오차 확인 (사이트 아래 줄 "킬 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)로 (로그인 정보 필요).

선수 조준점 · 내 조준점 (2026-10-29, v1.8.2)

  • 리플레이에 있다: BombPlayerState 에 선수마다 조준점 프로필이 복제된다 (관전자에게 보이는 조준점). 파서 형식에는 없어서 gvr-replay <vrf> --fields 로 필드 이름을 보고 찾았다.
    • 13.08 번호: 3985 주 조준점, 86132 정조준, 133179 (값이 온 적 없음), 180197 저격 조준경(가운데 점 색 · 크기 · 불투명도 · 표시) · bUsePrimaryCrosshairForADS · bUseAdvancedOptions · ProfileName.
    • 묶음 안 순서: 색 BGRA · 사용자 지정 색 BGRA · bUseCustomColor · 외곽선(켬 · 두께 · 색 · 불투명도) · 가운데 점(크기 · 불투명도 · 켬) · … · 안쪽 선 12개 · 바깥쪽 선 12개 (두께 · 길이 · 세로 길이 · 간격 · 세로 따로 · 이동 오차 · 사격 오차 · 최소 오차 · 불투명도 · 켬 · 사격 배율 · 이동 배율).
    • 기본값과 다를 때만 오고(색 흰색 255 · 숫자 0 · 끔), 바뀐 것만 다시 온다. 확인: 프로필 이름 "1 4 2 0" 선수 = 불투명도 1 · 길이 4 · 두께 2 · 간격 0, "점" 선수들 = 가운데 점만. 저격 점은 10명 모두 빨강(게임 기본).
  • 변환기 src/Crosshair.cs: 첫 읽기의 필드 목록에서 기준 번호를 찾고(이름이 모두 맞는 자리, 패치로 밀리면 ±80 안에서 찾음, 못 찾으면 조준점 없이 변환) 이 필드만 읽는 두 번째 읽기 (IncludedPaths, 어비스 리플레이 +0.4초). 출력 players[].crosshair = 바뀐 시각마다 전체 설정 (t · name · primary · ads · sniper · adsFromPrimary · advanced, color 는 실제 보이는 색).
  • 사이트 lib/crosshair.ts (그리기 · 발로란트 조준점 코드 읽기) · components/CrosshairPanel.tsx: 1인칭 "조준점" 버튼 → 선수 조준점(없으면 내 조준점) / 모든 선수에 내 조준점, 내 조준점 직접 고치기 · 코드 가져오기 · 선수 조준점 복사. 설정은 브라우저 gvr.settings.v1 crosshair.
    • 정조준(저격총 아님) 중에 고급 설정 + 정조준 조준점 따로면 ads, 저격 줌은 조준경 가운데 점. 사격 오차 · 이동 오차 켠 선은 쏜 뒤 0.35초 · 걷는 동안 벌어진다 (총마다 다른 실제 퍼짐이 아니라 대략).
  • 옛 리플레이 JSON 에는 없다. 앱은 버전이 바뀌면 다시 변환하므로 1.8.2 로 올리면 다음에 열 때 생긴다.

자동 시점 · Tab 점수판 (2026-11-08)

  • 변환기: scoreboard 행 [t, 선수, 크레딧, 궁 점수, 킬, 데스, 어시, 전투 점수] (바뀔 때마다 그 선수 전체 값, 모르는 값 -1). 크레딧은 MoneyManagementComponent.Money, 궁은 BombPlayerState.NumUltimatePoints (파서 기본 목록), 킬/데스/어시 · 전투 점수는 PlayerState 하위 객체 BasicCombatStatsComponent · PlayerScoreComponent 를 이름으로 목록에 더해 읽는다 (Collector.Catalog, 하위 객체 이름 → 클래스 AddSubobjectClassPath 가 없으면 그룹이 비어 온다). 게임은 기본값(0)과 다를 때만 보내므로 사이트는 안 온 숫자를 0 으로 본다.
    • 13.08 어비스: 행 1706개, 변환 6.8초(+0.2초). 체력 · 방어구(ChildDamageSectionComponent)는 리플레이에 값이 오지 않는다.
    • 궁극기 점수는 리플레이에 없다: 사이트가 궁을 쓴 순간(0 으로 떨어지기 직전 값)으로 정하고 (공수 교대 초기화는 뺀다: 교대 라운드 = 선수 시작 자리 중앙값이 40m 넘게 옮겨 간 라운드(13.08 실측 교대 93~109m · 평소 13m 이하), 그 앞 라운드 끝 ~ 교대 라운드 구매 3초 뒤에 0 이 된 것), 쓴 적이 없으면 요원 표(lib/scoreboard.ts ULT_COST)와 모은 최대값 중 큰 것. 13.08 실측 피닉스 7 · 나머지 8.
  • 사이트 lib/scoreboard.ts · components/ReplayScoreboard.tsx: 재생기 위에 마우스가 있거나 재생기 안을 누른 뒤 Tab 을 누르고 있는 동안 (버튼으로 켜고 끌 수도). 팀 점수(그 라운드 전까지, 라운드가 끝난 뒤면 그 라운드까지) · 궁극기 점 · K/D/A · 이 라운드 주무기 · 크레딧, 전투 점수 순, 죽은 선수 흐리게. 옛 JSON 은 킬 · 데스만 킬 기록으로.
  • 자동 시점 lib/director.ts (카메라 "자동"): 시각만으로 장면을 정한다 (되감기 · 배속에도 같음).
    • 교전: 킬마다 죽인 선수 1인칭. 교전 시작(둘 사이 첫 맞은 기록 · 죽인 선수의 이어진 사격, 8초 안) 2.5초 전부터. 우리 팀이 낀 교전이면 교전 시작 6초 안에 시작한 대화(콜)부터 보여 주고 화면에 콜 글. 같은 선수가 이어 죽이면 한 장면, 다음 킬은 앞 킬 0.5초 뒤에 넘어가고 넘어간 뒤 0.7초 안에 킬이면 넘어가지 않는다 (맞킬).
    • 빈 곳: 스파이크 설치 · 해체 > 킬 없는 교전(가장 많이 맞힌 산 선수) > 혼자 남은 선수(1 대 N) > 위에서 (구매 · 전략 보기 · 라운드 끝). 위에서는 살아 있는 선수가 모두 들어오게 부드럽게 따라간다 (거리 = 시야각 · 화면비 · 기울기로 가장 바깥 선수가 화면 85% 에 닿는 값, fitDistance). 2초보다 짧은 위에서 보기 · 0.9초보다 짧은 1인칭은 앞 장면에 붙인다.
    • 13.08 어비스: 장면 265개 · 계산 15ms, 상대 팀끼리 킬 145개 중 126개를 죽인 선수 1인칭으로 (나머지는 1초 안 맞킬).
  • 시험: site/server/test/replay-director.test.ts, 변환기 gvr-replay --self-test (점수판 줄 합치기).