DJMAX RESPECT V 선곡 화면에서 V-Archive 기반 비공식 난이도 정보를 실시간으로 보여주는 오버레이 도구입니다.
🚀 Rust 네이티브 앱: Overmax는 Rust 네이티브 기반으로 제작되어 가볍고 빠른 성능을 제공합니다.
- 가볍고 빠른 성능: 메모리 사용량과 실행 파일 크기가 최소화되었으며, 전반적인 런타임 성능이 뛰어납니다.
- 외부 의존성 최소화: 무거운 OpenCV나 OS OCR 의존성 없이, 순수 Rust 기반 Perceptual Hash/히스토그램 자켓 매칭과 Pure Rust CV 템플릿 매칭 엔진을 활용합니다.
- 완벽한 하위 호환성: 기존 사용자의 설정(
settings.json) 및 로컬 기록(record.db)과 호환되며, 기존의 포터블(Portable) 환경을 그대로 유지합니다.
선곡 화면에서 현재 선택된 곡의 V-Archive 비공식 난이도와 유사 난이도 추천 목록을 게임 화면 옆에 띄워줍니다.
- 현재 선택 곡의 버튼 모드별 비공식 난이도 표시 (NM/HD/MX/SC)
- V-Archive 기록 연동: V-Archive의 플레이 기록을 불러오고, 로컬 수집 기록을 V-Archive에 등록 가능
- 실시간 Rate / Max Combo 수집: 게임 내에서 기록을 갱신하면 자동으로 인식하여 로컬에 저장 (실시간 최고기록 감지 시 V-Archive 간편 업로드 지원)
- 유사 난이도 추천: 현재 패턴과 유사한 난이도의 다른 패턴 추천 (Rate 낮은 순 → 미플레이 순)
- 라이트 모드 (Lite Mode): 추천 리스트 등 불필요한 요소를 숨기고, 곡 정보 및 실시간 Rate 등 필수 정보만 보여주는 콤팩트한 레이아웃(세로 높이 약 60px 수준)을 제공합니다.
- 실시간 신기록 및 간편 업로드 알림: 플레이 중 감지된 Rate가 기존 V-Archive 기록보다 높을 경우, 오버레이 헤더에 **업로드 버튼(⬆)**이 활성화되어 손쉽게 V-Archive에 최신 기록을 반영 및 업로드할 수 있습니다.
메모리 읽기나 게임 파일 수정은 일절 없으며, 창 추적 + 화면 캡처 방식으로만 동작합니다.
- Releases 에서 최신 버전의
overmax.zip을 다운로드합니다. - 압축을 풀고
overmax.exe를 실행합니다. - 실행 중 DJMAX RESPECT V를 실행하면 자동으로 인식이 시작됩니다.
자동 업데이트: 앱 시작 시 자동으로 최신 버전 여부 및 곡 DB(
image_index.db) 상태를 확인하여 업데이트를 수행합니다.
- Releases에서
overmax-linux-x86_64.tar.gz를 다운로드해 사용자 쓰기 가능한 디렉터리에 풉니다. - 해당 디렉터리에서
./overmax를 실행합니다. 설정과 캐시는 실행 디렉터리에 저장됩니다. - 같은 세션에서 Proton/XWayland로 DJMAX RESPECT V를 실행합니다.
지원 범위, 환경 확인 방법, 현재 구현 상태와 미지원 기능은 Linux 지원 안내를 확인해 주세요.
- Windows 10 이상 (64bit), 또는 위 초기 지원 범위를 만족하는 x86_64 Linux
- DJMAX RESPECT V (Steam)
- 실행 중 인터넷 연결 (V-Archive 데이터, DB 및 앱 업데이트 확인)
⚠️ 중요: 게임 화면 설정 안내
- 테두리 없는 전체화면(전체 창 모드) 권장: 오버레이 창을 게임 화면 위에 정상적으로 띄워놓고 플레이하려면 게임 옵션에서 화면 설정을 **"전체 창 모드(Borderless Fullscreen)"**로 설정해 주세요.
- 독점 전체화면 사용 시: 게임을 일반 "전체화면" 모드로 실행하면 Windows OS 및 게임 안티치트(XIGNCODE3) 제약으로 인해 오버레이가 게임 위에 그려지지 못하고 게임 뒤로 숨게 됩니다. 독점 전체화면을 반드시 사용하셔야 하는 경우, 오버레이 창을 드래그하여 듀얼 모니터의 보조 화면 등 다른 모니터 영역에 배치해 두고 사용하셔야 합니다.
참고: 오버레이 UI는 한국어, 영어, 일본어 다국어(i18n)를 지원하며, 설정 창에서 언어를 변경할 수 있습니다.
- 오버레이 헤더의 **톱니바퀴 버튼(⚙)**을 누르면 설정 창이 열립니다.
- 설정 창에서 **오버레이 크기(S / M / L / XL)**와 투명도, **표시 언어(한국어/English/日本語)**를 조절할 수 있습니다.
- 오버레이는 egui 네이티브 드래그 기능을 활용하여 마우스 드래그로 원하는 위치에 부드럽게 옮길 수 있으며, 위치는 자동으로 저장됩니다.
- 설정 창에서 라이트 모드를 활성화할 수 있습니다. 라이트 모드 활성 상태에서는 의도치 않은 드래그 이동이 차단되며, 설정된 화면 구석 위치(좌상단, 우상단, 좌하단, 우하단)로 오버레이가 흔들림 없이(Jitter-free) 자동 스냅 및 고정됩니다.
# Rust 설치 필요 (rustup)
cargo build --release -p overmax-app
./target/release/overmax-rsrust/overmax_app: 메인 어플리케이션 (egui/winit 기반 네이티브 다중 뷰포트 UI 및 이벤트 루프)rust/overmax_engine: 화면 캡처(DXGI/GDI/X11), 디텍션 파이프라인, 상태 머신 및 텔레메트리rust/overmax_core: 핵심 상태 모델 및 공통 도메인 타입rust/overmax_data: 설정, DB(SQLite), 추천 엔진 및 V-Archive API 연동rust/overmax_cv: 순수 Rust 기반 이미지 처리 핵심 알고리즘 (Perceptual Hash, 히스토그램, 템플릿 매칭 엔진 등)
scripts/package-rust.ps1: 전체 빌드 및 배포용overmax.zip,release_manifest.json생성 자동화 스크립트 (기존 배포 레이아웃과 동일한 규격 유지)scripts/package-linux.sh: Ubuntu 22.04/glibc 2.35 ABI 기준 x86_64 Linuxtar.gz생성 및 smoke 검증
현재 Overmax는 차기 버전(v0.5.0) 개발을 위한 백로그에 따라 다음 목표를 중점적으로 추진하고 있습니다. 자세한 상세 현황 및 이슈 추적은 TASKS.md를 참고해 주세요.
- 외부 연동 및 IPC 프로토콜 고도화: 실시간 이벤트 스트리밍, MCP(Model Context Protocol) 기반 외부 호출 RPC 및 추천 프로토콜 정리
- 플레이어 편의성 및 인게임 유틸리티: 글로벌 단축키(Hotkeys) 지원 및 연습용 노트 레인 가림막(Lane Blind) 오버레이
- 기록 수집 및 V-Archive 자동 연동: 결과창 씬 확정 시 V-Archive 백그라운드 자동 업로드
- 감지 씬 다양화: 인게임 래더매치(Ladder Match) 밴픽 및 결과창 등 다양한 게임 상황 감지 지원
MIT