feat: CS2 donk 조준점·레이더 적용 및 실제 저장값 검증

docs/cs2-competitive-custom-20261002.md

@@ -0,0 +1,116 @@
+---
+title: CS2 무난한 경쟁전 커스텀
+date: 2026-10-02
+tags: [gaming, cs2, settings]
+---
+
+# CS2 무난한 경쟁전 커스텀
+
+> 이후 사용자가 donk 설정을 선택했다. 현재 설정은
+> [donk 프로필 기록](cs2-donk-profile-20261002.md)을 참조한다. 아래는 이전 선택의 이력이다.
+
+Vault 연결 미설정. 이 문서가 운영 원본이다.
+요구사항·진행 상태: [Issue #28](https://github.com/Jaeman-Lee/dotfiles/issues/28).
+변경 검토: [draft PR #29](https://github.com/Jaeman-Lee/dotfiles/pull/29).
+구현: [71b3192](https://github.com/Jaeman-Lee/dotfiles/commit/71b3192).
+설정 원본: [workstation.cfg](../gaming/workstation.cfg).
+
+사용자가 플레이 중 커스텀을 요청하고 “무난한 경쟁전 설정”을 선택했다.
+작은 고정 십자와 넓은 레이더를 출발점으로 구성한다. 특정 프로 선수의 정확한
+현재 설정을 복제하거나 성능 향상을 보장하는 프로필은 아니다.
+
+## 설정과 이유
+
+| 항목 | 값 | 목적 |
+| --- | --- | --- |
+| 조준점 | 고정 십자(style 4), 초록 RGB 0/255/0, 불투명 | 배경과 구분하기 쉬운 출발점 |
+| 조준점 크기 | FHD 기준 길이 6px, 두께 1px, 간격 3px | 중심을 가리지 않는 작은 십자 |
+| 조준점 보조 | 검정 전체 테두리, 중앙 점·T자·반동 추적 끔 | 밝은 배경에서 가독성 보완 |
+| 레이더 | 배율 0.4, 중앙 고정 끔, 회전 켬, 동적 배율 끔 | 더 넓은 맵 정보 표시 |
+| 레이더 크기 | HUD 1.1, 최소 아이콘 0.7 | 축소된 맵에서도 팀원 구분 |
+| 무기 표시 | FOV 68, X 2.5 / Y 0 / Z -1.5 | 화면 중앙 가림을 줄이는 출발점 |
+| 적 대비 | r_player_visibility_mode 1 | 기존 대비 강화 유지 |
+| 경쟁전 음악 | 사망·MVP·라운드 종료 0, 생존 중 MVP 음소거 | 전투 외 음악 감소 |
+| 폭탄 10초 경고 | 기존 엔진 값 0.04 유지 | 시간 정보 유지 |
+
+무기 표시 FOV는 월드 시야각이나 감도를 변경하지 않는다. 감도·줌 감도·DPI,
+키보드·마우스 축 바인딩, 효과음·음성·전체 음량, 해상도·FPS·그래픽 설정은
+이 변경에서 수정하지 않는다. 모드별 음악 변수가 분리되어 있어 음악 변경은
+기본 경쟁전 채널을 대상으로 한다. 다른 모드 전용 음악 값은 유지한다.
+
+## 현재 게임에 적용
+
+1. 게임 설정 → 게임 → 개발자 콘솔 사용 → 예.
+2. 기본 콘솔 키인 백틱/물결(`~`, Esc 아래)을 누른다. 열리지 않으면
+   키보드/마우스 설정에서 콘솔 열기 키를 지정한다.
+3. 콘솔에 `exec workstation`을 입력하고 콘솔을 닫는다.
+
+설치된 실행 래퍼가 다음 시작 시 같은 설정을 자동으로 읽는다.
+최초 설치에서는 게임과 Steam을 종료하거나 자동 키 입력을 수행하지 않았다.
+실행 중 cfg 파일 교체는 메모리의 설정을 자동으로 변경하지 않는다.
+**새 경기/맵 진입도 시작 cfg를 다시 실행하지 않는다.** 현재 세션은 콘솔 `exec`가
+필요하고, CS2 프로그램 재실행은 다른 적용 방법이다. 이후 실제 재실행 검증은 아래에 기록한다.
+
+## 백업과 되돌리기
+
+개인 백업은 HDD의 `~/.local/state/cs2-setup/backups/competitive-20261002-191409/`에
+0700 디렉터리/0600 파일로 보관한다. 기존 사용자·게임 `workstation.cfg`,
+저장된 convars·키 설정, 이 작업과 별개인 미커밋 런처 패치가 포함된다.
+개인 설정 원본은 Git에 넣지 않는다.
+
+현재 세션에서 변경한 값만 되돌리려면 콘솔에서 `exec cs2-before-custom`을 실행한다.
+이 파일은 변경 직전 **디스크에 저장된 값**으로 만들었으며, 저장되지 않은
+실행 중 설정까지 캡처한 것으로 보지 않는다. 다음 시작도 복구하려면 백업의
+`user-workstation.cfg`를 `~/.config/cs2/workstation.cfg`로 복원하고,
+`game-workstation.cfg`를 게임 `game/csgo/cfg/workstation.cfg`로 복원한다.
+실행 중 Steam Cloud나 사용자 vcfg 전체를 덮어쓰지 않는다.
+
+## 검증 결과와 한계
+
+- 변경한 31개 변수 이름이 설치된 게임의 `libclient.so` 문자열과 실제 저장된
+  설정 모두에 존재함을 확인했다. 이름 존재 확인은 런타임 값 검증과 다르다.
+- 구형 `cl_crosshairsize`, `cl_crosshairthickness`, `cl_crosshairgap`,
+  `cl_crosshaircolor`, `cl_crosshairusealpha`, `cl_crosshairalpha` 사용을 제거하고
+  현재 픽셀 단위 및 RGBA 변수를 사용한다.
+- 기존 모든 `bind` 줄 일치, 감도 강제 명령 없음 확인.
+- 저장소 원본과 사용자 설정·게임 cfg 두 설치본의 바이트 일치 확인.
+- `git diff --check`, 저장소 Git workflow 테스트 3개 통과.
+- 선언된 인터프리터 기준 Python/셸 구문 검사 통과. 기존 CI의 일괄 `sh -n`은
+  이번 변경 이전부터 Bash 배열을 사용하는 `gaming/install-steam-system.sh`에서
+  실패한다. 최초 커밋의 “syntax checks passed”는 이 인터프리터 구분 검사 결과로
+  한정하며, 기존 CI 전체가 통과했다는 의미가 아니다. CI 수정은 이 작업 범위에
+  포함하지 않았으며 PR에 기존 실패 원인을 명시했다.
+- 최초 설치 시 실제 경기 화면, 콘솔 실행 및 런타임 값을 확인하지 않았다.
+  이 상태에서 설치를 완료로 안내해 사용자가 새 경기에 들어가도 변경되지 않았다.
+
+## 19:20 실제 적용 확인
+
+사용자가 새 경기를 시작했는데도 적용되지 않았다고 보고했다. 실행 중 PID 8167은
+19:12:04에 시작됐고, 새 프로필은 19:15:03에 설치되어 그 프로세스에 로드되지 않았다.
+저장값도 빨간 조준점/길이 8, 레이더 0.7, 무기 FOV 60, MVP 음악 0.16이었다.
+콘솔 실행을 수행하지 않은 채 사용자에게 남긴 것이 미적용 원인이다.
+
+사용자가 메뉴에 있고 재실행해도 된다고 답했다. SIGTERM 처리기가 있는 CS2에
+종료 요청을 보내 종료를 확인했다. 강제 종료(SIGKILL), Steam 종료, OS 재시작은
+수행하지 않았다. Steam으로 `+exec workstation.cfg +host_writeconfig`를 전달했고,
+재실행 PID 14569에서 해당 인자가 확인됐다. 영구 시작 옵션은 변경하지 않았다.
+
+게임이 다시 저장한 설정에서 프로필의 모든 convar 값을 숫자/불리언 정규화 후
+비교해 일치를 확인했다. 초록 RGB 0/255/0, 길이 6, 두께 1, 간격 3,
+레이더 0.4/HUD 1.1, 무기 FOV 68, MVP 음악 0으로 반영됐다.
+감도 3.59와 전체 키/마우스 축 바인딩은 재실행 전과 동일하다.
+경기 화면의 시각적 확인과 사용자의 조작감 평가는 별도이며 완료로 주장하지 않는다.
+
+재실행 직전 개인 백업과 실행 요청 로그는 HDD의
+`~/.local/state/cs2-setup/backups/competitive-live-20261002/`에 보관하고 Git에서 제외한다.
+
+## 근거
+
+[Valve 공식 변경 기록](https://steamcommunity.com/app/730/announcements/)의
+2026-09-22~30 업데이트에서 조준점 개편, 픽셀 단위 길이·두께·간격,
+해상도 변경 시 재조정, 테두리 색상, 모드별 음악 설정을 확인했다.
+명령 이름은 로컬 게임 바이너리와 게임이 저장한 설정을 기준으로 검증했다.
+숫자는 사용자용 초기 선택값이며 Valve의 권장값이나 인기 순위로 표현하지 않는다.
+
+기존 근거와 장비·성능 관측은 [실전 관측 기록](cs2-live-session-20260927.md),
+설치 구조는 [게임 프로필 운영 문서](cs2-gaming-profile.md)를 참조한다.

docs/cs2-donk-profile-20261002.md

@@ -0,0 +1,64 @@
+---
+title: CS2 donk 조준점·레이더 적용
+date: 2026-10-02
+tags: [gaming, cs2, settings]
+---
+
+# CS2 donk 조준점·레이더 적용
+
+Vault 연결 미설정. 이 문서가 현재 선택의 운영 원본이다.
+진행 상태: [Issue #28](https://github.com/Jaeman-Lee/dotfiles/issues/28).
+변경 검토: [PR #29](https://github.com/Jaeman-Lee/dotfiles/pull/29).
+설정 원본: [workstation.cfg](../gaming/workstation.cfg).
+이전 선택과 적용 장애 기록: [기존 커스텀 기록](cs2-competitive-custom-20261002.md).
+
+## 사용자 선택과 출처
+
+사용자는 앞선 임의 조합을 선호하지 않아 상위권 선수 설정을 요청한 뒤 donk를 선택했다.
+이전 조합을 가장 보편적인 설정으로 볼 근거는 없다.
+[ProSettings donk 페이지](https://prosettings.net/players/donk/)의 2026-10-01 갱신
+등록값을 2026-10-02 확인했다. 선수의 설정은 수시로 바뀌므로 현재 순간의 직접
+관측값이나 사용 빈도 통계로 표현하지 않는다.
+
+| 항목 | 적용값 |
+| --- | --- |
+| 조준점 | Static Cross(4), 초록 RGB 0/255/0, 불투명 |
+| 크기 | 길이 2, 두께 2, 간격 0 |
+| 보조 | 테두리·중앙 점·반동 추적·T자 끔, 스나이퍼 폭 0 |
+| 레이더 | 배율 0.7, 플레이어 중앙 고정 켬, 회전 켬 |
+| 레이더 HUD | 크기 1, 스코어보드와 모양 전환 켬 |
+| 무기 표시 | FOV 68, X 2.5 / Y 0 / Z -1.5 (기존과 같음) |
+
+donk의 등록 해상도는 1280×960 늘림, 조준점 기준 높이는 960이다.
+이 PC는 1920×1080과 기준 높이 1080을 유지하고 2px 길이/두께를 적용한다.
+따라서 **donk의 조준점·레이더를 FHD에 적용한 프로필**이며 4:3 화면의 모양까지
+완전히 동일하게 복제한 것은 아니다. 감도 3.59·DPI·키/마우스 축·성능 설정은
+그대로 유지한다. 음향은 기존 사용자 프로필이며 donk 설정으로 주장하지 않는다.
+
+## 적용 및 복구
+
+실행 중에는 콘솔에서 `exec workstation; host_writeconfig`로 적용할 수 있다.
+다음 적용부터 재실행이 필수가 되지 않도록 `con_enable 1`을 추가했다.
+기본 콘솔 키는 Esc 아래 백틱/물결 키이며 기존 키 바인딩은 변경하지 않는다.
+설정 파일 설치만으로 진행 중인 경기의 설정이 바뀌지는 않는다.
+
+사용자가 경기 중임을 알린 동안은 종료하지 않았다. 이어 경기 종료를 알린 후,
+기존 재실행 승인에 따라 CS2에 종료 요청을 보내고 Steam으로 다시 실행했다.
+Steam·OS 재시작이나 SIGKILL은 사용하지 않는다.
+
+변경 직전 cfg와 개인 저장 설정은 HDD의
+`~/.local/state/cs2-setup/backups/donk-20261002-192357/`에 보관하며 Git에서 제외한다.
+복구는 `user-workstation.cfg`를 `~/.config/cs2/workstation.cfg`로,
+`game-workstation.cfg`를 게임 `game/csgo/cfg/workstation.cfg`로 복원한 뒤
+콘솔에서 `exec workstation`을 실행한다.
+
+## 검증
+
+- 원본과 두 설치본의 바이트 일치, `git diff --check` 통과.
+- 재실행 PID 17205에서 `+exec workstation.cfg +host_writeconfig` 확인.
+- 게임이 직접 저장한 설정을 숫자/불리언 정규화 후 비교하여 프로필 convar
+  **41개 전체 일치** 확인. 개인 vcfg에 원하는 값을 직접 써 넣지 않았다.
+- 조준점 2/2/0, 테두리 0, 스나이퍼 폭 0, 레이더 0.7/중앙 고정/HUD 1,
+  개발자 콘솔 켬을 확인했다.
+- 감도 3.59, 전체 키/마우스 축, 기존 미커밋 런처 패치 보존 확인.
+- 사용자 화면/조작감 평가는 별도다.

gaming/workstation.cfg

@@ -1,19 +1,55 @@
 // Personal baseline; no account data. Loaded by the CS2 launch wrapper.
+// Allow future live profile changes with the default console key and exec.
+con_enable "1"
 fps_max "240"
 fps_max_ui "60"
 cl_hud_telemetry_frametime_show "2"
 cl_hud_telemetry_ping_show "2"
 cl_hud_telemetry_net_misdelivery_show "2"
 // Preserve sensitivity selected in the game's menu; do not reset it at launch.
+// donk crosshair/radar values listed 2026-10-01:
+// https://prosettings.net/players/donk/
+// Keep this PC's 1080p resolution; use the listed 2px bars, not 4:3 stretching.
+// Small static green cross; no outline, recoil-follow or center dot.
 cl_crosshairstyle "4"
-cl_crosshaircolor "1"
-cl_crosshairsize "2.5"
-cl_crosshairthickness "0.5"
-cl_crosshairgap "-2"
+cl_crosshair_screen_height "1080"
+cl_crosshair_length "2"
+cl_crosshair_thickness "2"
+cl_crosshair_gap "0"
+cl_crosshaircolor_r "0"
+cl_crosshaircolor_g "255"
+cl_crosshaircolor_b "0"
+cl_crosshaircolor_a "255"
 cl_crosshairdot "0"
-cl_crosshair_drawoutline "1"
-cl_crosshairusealpha "1"
-cl_crosshairalpha "255"
+cl_crosshair_t "0"
+cl_crosshair_recoil "0"
+cl_crosshair_drawoutline "0"
+cl_crosshair_sniper_width "0"
+cl_crosshairoutline_r "0"
+cl_crosshairoutline_g "0"
+cl_crosshairoutline_b "0"
+cl_crosshairoutline_a "255"
+// donk radar: player-centered, rotating, normal HUD size, zoom 0.7.
+cl_radar_scale "0.7"
+cl_radar_always_centered "1"
+cl_radar_rotate "1"
+cl_radar_scale_dynamic "0"
+cl_hud_radar_scale "1"
+cl_radar_icon_scale_min "0.7"
+cl_radar_square_with_scoreboard "1"
+// Weapon model only: does not change world FOV or aiming sensitivity.
+viewmodel_fov "68"
+viewmodel_offset_x "2.5"
+viewmodel_offset_y "0"
+viewmodel_offset_z "-1.5"
+r_player_visibility_mode "1"
+// Competitive music channels. Preserve effects, voice, master volume and EQ.
+snd_deathcamera_volume "0"
+snd_mvp_volume "0"
+snd_roundend_volume "0"
+snd_mute_mvp_music_live_players "1"
+// Keep the existing audible warning level; do not mute this channel.
+snd_tensecondwarning_volume "0.04"
 bind "w" "+forward"
 bind "s" "+back"
 bind "a" "+left"