War Thunder向け外部オーバーレイModのポータブルx64実装
danx1905k8/war-thunder-realistic-tank-outline-thermal-portable-x64
★ 436 ・ Jupyter Notebook
概要
war-thunder-realistic-tank-outline-thermal-portable-x64 は、オンラインゲーム『War Thunder』向けに設計された外部オーバーレイおよび設定管理を行うポータブルなWindows向けModツールです。
64ビット版のWindows 10およびWindows 11を対象としており、DirectXを用いたビューポートオーバーレイ機能やJSONベースの設定機構を提供します。設定ファイル(config/settings.json)のホットリロードに対応しており、外部依存関係を極力排除した軽量なランタイムとして構成されていることが特徴です。ゲーム画面上に追加の情報やオーバーレイを描画する技術に興味がある開発者や、Windows上でのオーバーレイ実装の構成例を調べたい技術者に向いています。
主な特徴
- DirectX 11/12ベースのビューポートオーバーレイ: ボーダレスなDX11/DX12スワップチェーンを利用し、DPIスケーリングやカスタム距離カットオフ(例: 350m)に対応した描画を行います。
- JSONホットリロード対応の設定機構: ランタイムを再起動することなく、
config/settings.jsonを編集することで即座に設定値(レンダラー挙動や各モジュールの有効化など)を反映できます。 - モジュール構造のサブシステム: ビジュアルオーバーレイ、テレメトリHUD、入力補間(Input Smoothing)、アイテム/エンティティフィルタなど、役割ごとにサブシステムが分割されています。
- 緊急停止機能(Panic Key): キーボードの
ENDキーを押すことで、即座にスレッドの破棄およびハンドルの解放を行う緊急アンロード機能を備えています。 - ポータブル版の配布とCMakeビルドの対応: 事前にビルドされたZIPアーカイブが提供されているほか、CMakeを用いたソースコードからのビルド手順も用意されています。
使い方
READMEには、配布されているビルド済みパッケージを利用する方法と、ソースコードからビルドする方法の双方が記載されています。
事前ビルド版の利用
- リリースページまたはREADMEに記載のURLから
war-thunder-realistic-tank-outline-thermal-portable-x64-v1.2.0-win64.zipをダウンロードします。 - ダウンロードしたZIPアーカイブを任意のフォルダに展開します(実行ファイルと同じ階層に
config/settings.jsonを配置しておく必要があります)。 - 実行ファイルを管理者権限(Run as Administrator)で起動します。
操作キー
デフォルトの設定では、以下のショートカットキーが割り当てられています。
INSERT: オーバーレイ表示の切り替え(トグル)END: 緊急アンロード(プロセスの即時終了)
ソースコードからのビルド
CMakeを使用してリポジトリからビルドする場合は、以下のコマンドを実行します。
git clone https://github.com/danx1905k8/war-thunder-realistic-tank-outline-thermal-portable-x64.git
cd war-thunder-realistic-tank-outline-thermal-portable-x64
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
技術的なポイント
READMEから確認できる技術仕様やアーキテクチャの要点は以下の通りです。
レンダラーとグラフィックススタック
オーバーレイの描画バックエンドとしてDirectX 11(dx11)およびDirectX 12(dx12)が選択可能となっており、ボーダレスウィンドウに対する合成処理とDPI Aware対応が組み込まれています。設定ファイル内では垂直同期(vsync)の有無やフレームレート上限(max_fps)の制御項目が用意されています。
設定スキーマ (config/settings.json)
設定ファイルはJSON形式で記述され、レンダラー設定と各機能モジュールごとに設定が階層化されています。
{
"version": "1.2.0",
"renderer": {
"backend": "dx11",
"vsync": false,
"max_fps": 144,
"dpi_aware": true,
"toggle_key": "INSERT",
"panic_key": "END"
},
"modules": {
"visual_overlay": {
"enabled": true,
"draw_bounds": true,
"draw_distance": true,
"max_distance_m": 350
},
"telemetry_hud": {
"enabled": true,
"frame_time_graph": false,
"compact_mode": true
},
"input_filter": {
"enabled": true,
"smoothing_factor": 1.45,
"fov_radius": 65.0
},
"item_radar": {
"enabled": true,
"min_rarity_tier": 2
}
}
}
input_filter における補間係数(smoothing_factor)やFOV範囲(fov_radius)、visual_overlay における最大描画距離(max_distance_m)など、数値パラメータを柔軟に変更できる設計となっています。
注意点
- ライセンス: リポジトリのメタデータ上、明示的なライセンスは記載されておらず「不明」となっています。商用利用やコードの再配布、改変を行う際は権利関係に注意が必要です。
- 動作環境: 64ビット版のWindows 10およびWindows 11のみが対象とされています。他のOS(Linux、macOS、32ビット版Windows)への対応は記載されていません。
- オンラインゲームにおける利用規約: 本ツールはオンライン対戦ゲームである『War Thunder』向けの外部オーバーレイおよび入力補間機能等を含んでいます。運営元の利用規約(アンチチートポリシーや外部ツールの利用制限)に抵触し、アカウントの停止などの措置が取られるリスクがあるため、実際のゲームプレイでの使用には十分な留意が必要です。
まとめ
war-thunder-realistic-tank-outline-thermal-portable-x64 は、Windows環境においてDirectXを活用したオーバーレイ描画とホットリロード可能な設定管理を実現するModツールです。CMakeによるビルド体系とポータブル実行ファイルの双方が提供されており、ゲーム向け外部ツールの構造やDirectXオーバーレイの設計を調査する際の参考資料となります。





