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のウィンドウ描画制限により、以下の画面モード設定を必ずご確認ください。

✅ 推奨設定: ボーダーレスウィンドウ (全画面ウィンドウ)

ゲーム内の [OPTION] → [GRAPHICS] → 画面モードを「ボーダーレス (Borderless)」 に設定してください。ゲーム画面の上にオーバーレイが隠れることなく正常にオーバーラップ表示されます。

⚠️ Windows HDR環境に関する注意点 (非対応)

現在、WindowsのHDR (High Dynamic Range) が有効になっている環境では、色味の変化により楽曲およびパターンの画面認識が正常に動作しません。
Overmaxをご利用の際は、Windowsのディスプレイ設定でHDRをオフ（SDR環境）にしてプレイしてください。

🖥️ 専有フルスクリーンを使用する必要がある場合

ゲームを通常の「フルスクリーン(Fullscreen)」で起動すると、OSの仕様上オーバーレイがゲーム画面の背面に隠れてしまいます。
専有フルスクリーンが必須の環境では、オーバーレイウィンドウをドラッグしてデュアルモニターのサブ画面に配置してプレイしてください。

03 オーバーレイ画面の見方

1) 上部ヘッダー & クイックアクション

楽曲情報 & 判定: 現在選択中の曲名、アーティスト、ボタンモード(4B/5B/6B/8B)、リアルタイム最高達成率(Rate)、MAX COMBO([M], [P])バッジを表示します。
⬆ ワンクリックアップロード: 従来のV-Archive記録を上回る新記録が検知されると有効化され、クリックすると即座にWebサーバーへ個別アップロードされます。
🔄 記録同期 (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): 日本語、韓国語、英語の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 を実行時に切り替えられます。
画面キャプチャ除外: スクリーンショットや配信・録画(OBS)時にオーバーレイを透明化するかどうかを設定します。

🪶 ライトモード (Lite Mode) のご案内

推薦リストなどの付加要素を非表示にし、必須情報のみを表示する高さ約60pxの超スリムバーレイアウトです。
通常HUDおよびライトモードの両方で、画面4隅へのスナップ固定とマウスドラッグに完全対応しています。

05 V-Archive連携 & 記録同期ウィンドウ詳細ガイド

Overmaxは複雑なAPIトークン発行なしで、用途に応じて記録の閲覧またはリアルタイム/一括新記録アップロードを簡単に設定してご利用いただけます。

📥 ケース1. 自分のプレイ記録のみを読み込みたい場合 (閲覧専用)

V-Archiveに登録済みのプレイ記録と非公式難易度をオーバーレイに表示して参考にしながらプレイする方法です。

オーバーレイヘッダーの設定ボタン(⚙)を押し、[V-Archive]タブへ移動します。
自身のV-Archive ID(ニックネーム)を入力します。
[更新]ボタンを押すと、V-Archiveの記録を即座に取得します。
以降はOvermax起動時に自動で最新の記録を取得・反映します。

📤 ケース2. プレイ中に新記録をV-Archiveへアップロードしたい場合

ゲーム内でリアルタイムに更新した自己ベストをV-Archiveに直接登録する方法です。

設定ウィンドウ(⚙)で自身のV-Archive ID(ニックネーム)を入力します。
V-Archive公式クライアントで使用される account.txt ファイルのパスを設定画面で指定します。

🔄 V-Archive記録同期ウィンドウ (Sync Window) 詳細ガイド

オーバーレイヘッダー右側の🔄 同期ボタンを押すと開く専用ウィンドウです。プレイ中にローカルDB(record.db)へ蓄積された複数の新記録を一括確認し、選択登録や不要な記録の整理が行えます。

🔍 1. アカウント確認 & 候補スキャン

上部カードに現在ログイン中の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状況、理由バッジを確認して処理します。

[登録] (Upload): 該当パターンの記録をV-Archiveへ送信します。
[削除] (Delete): 誤認識やアップロードしたくないローカル記録を安全に削除します。

💡 リアルタイムアップロード (⬆) と同期ウィンドウ (🔄) の使い分け

ヘッダー ⬆ ボタン (リアルタイム): プレイ直後、更新したばかりの単一パターンを即座に送信したいときに使用します。(3秒間のトースト通知で結果表示)
ヘッダー 🔄 ボタン (同期ウィンドウ): セッション終了後など、蓄積された複数の新記録をまとめて確認・選択登録したい場合や、誤認識ログを整理したいときに使用します。

06 よくある質問 (FAQ)

Q. 画面認識が全く動作しません。

DJMAX RESPECT Vが起動しているか確認し、ゲームの画面モード設定が「ボーダーレス」または「ウィンドウモード」になっているかご確認ください。
また、WindowsのHDRが有効になっている場合、画面キャプチャの色の歪みにより認識が行えませんので、Windowsのディスプレイ設定でHDRをオフにしてください。管理者権限の問題や、他の特殊なグラフィックオーバーレイツールとの競合がないかも点検してください。

Q. デュアル/マルチモニター環境でオーバーレイが表示されない・認識されません。

マルチモニターの配置や仮想座標設定によって、DXGIキャプチャがサブモニターを見失う場合があります。
オーバーレイヘッダーの設定ボタン(⚙) → [高度]タブへ移動し、キャプチャバックエンドを「GDI」に変更してください。すべてのマルチモニター環境で最も安定して動作します。

Q. スクリーンショットや配信/録画ソフト(OBS等)にオーバーレイが映りません。

画面キャプチャ時にオーバーレイウィンドウが自分自身を再認識してしまう干渉を防ぐため、Windows画面キャプチャ除外(DisplayAffinity)機能が初期状態で有効になっています。
スクリーンショットや配信画面にオーバーレイを含めたい場合は、設定(⚙) → [高度]タブ → [画面キャプチャ除外] のチェックを外して(OFF)ください。
⚠️ 注意: キャプチャ除外を無効にした場合、オーバーレイがゲームUIの認識領域と重なると認識に影響が出る場合があります。オーバーレイを認識領域の外側やサブモニターへ配置してください。

Q. メモリ改変やインジェクションによるアカウント停止のリスクはありますか？

いいえ。Overmaxはゲームプロセスのメモリの読み込みや改変を一切行わず、Win32ウィンドウキャプチャAPIのみを使用して画面画像を認識するため安全です。

Q. Linuxでも利用できますか？

はい。x86_64 Linux環境(Proton / XWayland)向けの配布パッケージ(overmax-linux-x86_64.tar.gz)を提供しています。詳しいセットアップ手順はGitHubのLinuxガイド文書をご参照ください。