Overmax 사용 가이드 - DJMAX RESPECT V 오버레이

01 설치 및 빠른 시작

Overmax는 별도의 무거운 인스톨러 없이 바로 실행 가능한 포터블(Portable) 단일 패키지로 제공됩니다.

STEP 01

패키지 다운로드

다운로드 페이지에서 최신 overmax.zip을 다운로드합니다.

STEP 02

압축 해제 & 실행

원하는 폴더에 압축을 푼 뒤 overmax.exe를 실행합니다.

STEP 03

게임 자동 인식

DJMAX RESPECT V를 실행하면 자동으로 게임 창을 감지하여 오버레이가 뜹니다.

💡 스마트 자동 업데이트

앱 실행 시 최신 곡 데이터베이스(image_index.db) 및 신규 버전 여부를 백그라운드에서 자동 확인하여 항상 최신 메타데이터를 유지합니다.

02 ⚠️ 게임 화면 설정 (필독)

게임 안티치트(XIGNCODE3) 및 Windows OS의 창 렌더링 제약으로 인해 아래 화면 모드 설정을 반드시 확인해 주세요.

✅ 권장 설정: 전체 창 모드 (Borderless Fullscreen)

게임 내 [OPTION] → [GRAPHICS] → 화면 모드를 "전체 창 모드"로 설정해 주세요. 게임 화면 위에 오버레이가 가려지지 않고 정상적으로 오버랩됩니다.

🖥️ 독점 전체화면을 사용해야 하는 경우

게임을 일반 "전체화면(Fullscreen)"으로 실행하면 OS 특성상 오버레이가 게임 창 뒤로 숨겨지게 됩니다.
독점 전체화면을 반드시 사용하셔야 하는 환경이라면 오버레이 창을 드래그하여 듀얼 모니터의 보조 화면에 두고 플레이하시면 됩니다.

03 오버레이 화면 보는 법

1) 상단 헤더 및 퀵 액션

곡 정보 및 판정: 현재 선택된 곡명, 아티스트, 버튼 모드(4B/5B/6B/8B), 실시간 최고 달성률(Rate) 및 MAX COMBO([M], [P]) 뱃지를 표시합니다.
⬆ 원클릭 업로드: 기존 V-Archive 기록보다 높은 신기록이 감지되면 활성화되며, 누르면 즉시 웹서버로 단독 업로드됩니다.
🔄 기록 동기화 (Sync): 로컬에 누적된 여러 신기록을 한눈에 검토하고 일괄 업로드/삭제할 수 있는 동기화 창을 엽니다.
⚙ 설정: 크기, 투명도, 스마트 추천 모드, V-Archive 계정 연동 등을 조절하는 설정 창을 엽니다.

2) 비공식 난이도 티어표

V-Archive 데이터를 바탕으로 각 난이도(NM / HD / MX / SC)의 세분화된 비공식 난이도 수치(예: 10.1)를 보여줍니다. 현재 선택된 패턴은 시각적으로 밝게 강조 표시됩니다.

3) 추천 곡 목록

플레이어의 실력 분포와 당일 세션 컨디션을 분석하여 기록 갱신과 실력 향상에 적합한 곡을 추천합니다.

🏷️ 추천 사유 뱃지 안내

TOP
Top-50 돌파: V-Archive Top 50 랭킹 컷라인 돌파가 가능한 유력 후보곡 (레이팅 상승 극대화)
DEF
Top-50 수성: 현재 내 41~50위에 위치하여 밀려날 위기에 있는 방어 대상 곡
UP
상승 모멘텀: 오늘 세션의 컨디션(Performance Rating)이 좋아 도전해 볼 만한 상위 난이도 곡
REST
회복/안정화: 컨디션이 저조하거나 손풀기가 필요할 때 감각 유지를 위한 안정권 곡
TRY
재도전: 목표 정확도에 근접했으나 아쉽게 놓치고 최근 14일간 플레이하지 않아 방치된 기록 갱신 유력 곡
CLR
미플레이 첫 클리어: 아직 한 번도 기록이 등록되지 않은 신규 패턴

💡 인게임 오버레이에서 각 뱃지에 마우스를 올리면 상세한 추천 이유(호버 툴팁)를 확인할 수 있습니다.

4) 하단 푸터 & 권장 난이도 라벨

선곡창 커서 위치와 무관하게 플레이어의 실력대에 맞는 안정적인 권장 레벨과 통계를 하단 푸터에 고정 표시합니다.

권장 난이도 (좌측): TrueSkill 기반 통계적 실력 분포 모델(SkillProfile)을 통해 산출된 최적 권장 난이도입니다.
대역 평균 달성률 (우측): 해당 권장 난이도 대역 내에서 플레이어가 달성한 평균 Rate 및 완주 곡 비율을 실시간으로 집계합니다.

04 설정 및 커스터마이징 (⚙)

오버레이 헤더의 톱니바퀴 버튼(⚙)을 누르면 4개 전용 탭으로 구성된 설정 창이 열립니다.

⚙️ [일반] 탭

크기 조절 (S / M / L / XL): 모니터 해상도(FHD, QHD, 4K 등)에 맞춰 4단계 스케일로 조절할 수 있습니다.
투명도 조절: 정밀 슬라이더를 통해 인게임 시야에 방해되지 않도록 배경 투명도를 조절합니다.
위치 스냅: 화면 4개 모서리(↖ 좌상단, ↗ 우상단, ↙ 좌하단, ↘ 우하단) 중 원하는 위치로 흔들림 없이 자동 고정하거나 수동 드래그할 수 있습니다.
다국어 지원 (i18n): 한국어, English, 日本語 3개 국어를 지원합니다.

🎯 [추천] 탭

추천 모드: 다차원 분석 기반 스마트(Smart) 모드와 단순 달성률 정렬 클래식(Classic) 모드 중 선택할 수 있습니다.
목표 정확도 (Target Rate): 97%, 99%(기본), 99.5%, 100% 중 본인의 플레이 지향점에 맞춰 권장 난이도 기준을 설정할 수 있습니다.
미보유 DLC 제외: 플레이 기록을 바탕으로 보유한 DLC를 자동 추론하여 미보유 곡 추천을 방지합니다.

☁️ [V-Archive] 탭

V-Archive ID: 본인의 닉네임을 입력하여 기록을 자동 동기화합니다.
account.txt 경로: V-Archive 클라이언트의 인증 파일을 지정하여 실시간 업로드를 활성화합니다.

🔧 [고급] 탭

캡처 백엔드: 기본 자동 모드 외에 GDI 및 고속 DXGI Desktop Duplication을 런타임에 직접 선택할 수 있습니다.
화면 캡처 방지: 스크린샷 및 방송 캡처 시 오버레이 투명화 여부를 설정할 수 있습니다.

🪶 라이트 모드 (Lite Mode) 안내

추천 리스트 등 부가 요소를 숨기고 필수 정보만 보여주는 약 60px 높이의 초슬림 바 레이아웃입니다.
일반 오버레이와 라이트 모드 모두 화면 4개 모서리 스냅 고정 및 마우스 드래그를 완벽하게 지원합니다.

05 V-Archive 연동 & 기록 동기화 창

Overmax는 복잡한 API 토큰 발급 없이, 사용 목적에 따라 기록 조회 또는 실시간/일괄 신기록 업로드로 간편하게 연동하여 사용할 수 있습니다.

📥 경우 1. 내 플레이 기록만 불러오고 싶은 경우 (조회 전용)

V-Archive에 등록된 본인의 플레이 기록과 비공식 난이도를 오버레이에 띄워두고 참고하며 플레이하는 방법입니다.

오버레이 헤더의 설정 버튼(⚙)을 누르고 [V-Archive] 탭으로 이동합니다.
본인의 V-Archive ID(닉네임)를 입력합니다.
[새로고침] 버튼을 누르면 V-Archive의 플레이 기록을 즉시 가져옵니다.
이후에는 Overmax가 실행될 때마다 자동으로 최신 V-Archive 기록을 가져와 오버레이에 반영합니다.

📤 경우 2. 플레이 중 신기록을 V-Archive에 업로드하고 싶은 경우

게임 내에서 실시간으로 갱신한 신기록을 V-Archive에 직접 등록하는 방법입니다.

설정 창(⚙)에서 본인의 V-Archive ID(닉네임)를 입력하여 연동합니다.
V-Archive 공식 클라이언트에서 사용되는 account.txt 파일 경로를 설정 창에 지정해 줍니다.

🔄 V-Archive 기록 동기화 창 (Sync Window) 상세 가이드

오버레이 헤더 우측의 🔄 동기화 버튼을 누르면 열리는 전용 창입니다. 인게임 플레이 중 자동으로 로컬 DB(record.db)에 누적된 여러 신기록들을 한눈에 검토하고, 원하는 기록만 선별하여 V-Archive에 등록하거나 불필요한 기록을 정리할 수 있습니다.

🔍 1. 계정 확인 & 후보 스캔

상단 카드에 현재 PC의 로그인된 Steam 계정(닉네임 및 Steam ID)이 자동 감지됩니다.

[스캔] 버튼: 로컬에 수집된 기록과 V-Archive 데이터를 대조하여 미등록 곡 및 판정 갱신 후보를 즉시 스캔합니다.
다중 계정을 사용하는 경우 Steam ID 입력란에서 대상 계정을 직접 전환할 수 있습니다.

🎛️ 2. 스마트 상세 필터 (▼)

▼ 필터 버튼을 눌러 원하는 패턴만 빠르게 골라낼 수 있습니다.

버튼 모드 & 난이도: 4B/5B/6B/8B 및 NM/HD/MX/SC 개별 토글
레벨 & Rate 듀얼 슬라이더: Lv.1 ~ SC 15 및 0% ~ 100% 범위 지정
특수 조건 필터: V-Archive 미보유 MAX COMBO만 보기, 미등록 기록 제외 등

📊 3. 후보 목록 정렬

발견된 갱신 후보(예: 12 / 45)를 원하는 기준으로 재정렬합니다.

변동폭순 (Rate Diff): 기존 기록 대비 판정 상승폭(예: +0.45%)이 큰 순서로 정렬하여 레이팅 상승에 유력한 곡부터 검토합니다.
제목순 (Title): 버튼 모드 및 곡 이름 알파벳/가나다 순으로 정렬합니다.

⚡ 4. 개별 등록 및 로컬 삭제

각 후보 항목별로 달성 Rate, MAX COMBO([M]/[P]), 갱신 사유 뱃지를 확인한 후 처리합니다.

[등록] (Upload): 해당 패턴 기록을 V-Archive에 즉시 전송하며, 하단에 완료/에러 상태가 표시됩니다.
[삭제] (Delete): 오인식되었거나 업로드하고 싶지 않은 로컬 기록을 DB에서 안전하게 삭제합니다.

💡 실시간 원클릭 업로드 (⬆) vs 동기화 창 (🔄) 비교

헤더 ⬆ 버튼 (실시간 업로드): 플레이 직후 방금 갱신한 단일 패턴을 원클릭으로 즉시 V-Archive에 전송하고 싶을 때 사용합니다. (3초간 토스트 메시지로 성공 여부 피드백)
헤더 🔄 버튼 (동기화 창): 세션이 끝난 뒤 또는 오랜만에 플레이한 후, 누적된 여러 신기록을 한 번에 검토하고 선별 등록하거나 잘못 수집된 기록을 정리할 때 사용합니다.

06 자주 묻는 질문 (FAQ)

Q. 화면 인식이 전혀 동작하지 않아요.

DJMAX RESPECT V가 정상 실행 중인지 확인하고, 게임 화면 설정이 "전체 창 모드" 또는 "창 모드"인지 확인해 주세요. 관리자 권한 문제나 특수 그래픽 오버레이 도구와의 충돌 여부도 점검해 보세요.

Q. 듀얼/멀티 모니터 환경에서 오버레이가 정상적으로 뜨지 않거나 인식이 안 돼요.

다중 모니터 배치나 디스플레이 가상 좌표 환경에 따라 DXGI 캡처 백엔드가 보조 화면을 놓칠 수 있습니다.
오버레이 헤더의 설정 버튼(⚙) → [고급] 탭으로 이동한 뒤, 캡처 백엔드를 "GDI"로 변경해 주시면 모든 모니터 환경에서 가장 안정적으로 동작합니다.

Q. 스크린샷이나 방송/녹화 프로그램(OBS 등)에서 오버레이가 찍히지 않아요.

Overmax는 화면 캡처 시 오버레이 창이 자기 자신을 다시 인식하는 간섭을 방지하기 위해, Windows 화면 캡처 방지(DisplayAffinity) 기능이 기본 활성화되어 있습니다.
스크린샷이나 방송 화면에 오버레이를 포함하고 싶다면 설정(⚙) → [고급] 탭 → [화면 캡처 방지] 옵션을 체크 해제(OFF)해 주세요.
⚠️ 주의: 캡처 방지를 끄면 오버레이 창이 게임 UI 인식 영역을 가리는 위치에 놓였을 때 화면 인식이 정상 동작하지 않을 수 있으므로, 오버레이를 인식 영역 바깥이나 보조 모니터로 이동시켜 배치해 주세요.

Q. 메모리 변조나 인젝션으로 인한 제재 위험은 없나요?

Overmax는 게임 프로세스의 메모리를 읽거나 변조하지 않으며, 오직 Win32 창 캡처 API만을 사용하여 화면 이미지를 인식하므로 안전합니다.

Q. Linux에서도 사용할 수 있나요?

네, x86_64 Linux 환경(Proton / XWayland)을 위한 배포 패키지(overmax-linux-x86_64.tar.gz)를 제공합니다. 자세한 실행 가이드는 GitHub의 Linux 가이드 문서를 참고해 주세요.