Aether Tracker for ACT

1.6.2

• Hidden control/overlay states skip FFXIV actor acquisition; visible overlays request a redraw only when their displayed data changes.
• Game-window discovery is shared across overlays and limited to one lookup per second.
• Map downloads and cache entries now have strict response, image-dimension, count, byte, and 180-day age limits; the existing cache is reused and legacy entries remain readable.
• Config replacement is atomic and retains recoverable backups. Invalid Config data is left intact while the newest valid backup is loaded.
• Manual update downloads, manifests, ZIP entry counts, expanded sizes, and DLL extraction are bounded and cancellable.

The included measurements are deterministic test counters/simulations, not an estimate of real SSD wear or actual in-game FPS. No production Config or map-cache data was used during tests.

作者: Roxyz0501

ライセンス: 未設定（既存ライセンスが存在しないため、現時点では再利用・再配布条件を付与していません）

FFXIV_ACT_Plugin が公開している戦闘オブジェクト一覧から、現在読み込まれているプレイヤー、NPC、その他オブジェクトの座標を一覧表示し、選んだ1体への方向を透過オーバーレイで示す ACT プラグインです。

任意支援

設定画面の「支援」タブから、Ko-fiでRoxyz0501の開発を支援できます。支援は完全に任意です。支援しなくてもすべての機能を利用でき、機能差はありません。リンクは支援ボタンを明示的にクリックした場合だけ既定のブラウザで開きます。

言語

設定画面の「言語」から英語、日本語、簡体字中国語、韓国語をいつでも切り替えられ、画面とオーバーレイへ即時反映されます。英語が既定・フォールバック言語です。

Configに言語がない初回起動だけWindows UI言語を確認し、ja系は日本語、zh系は簡体字中国語、ko系は韓国語、それ以外は英語を選んで保存します。以後はWindows言語で上書きせず、利用者の選択を維持します。

更新機能

「更新」タブには「起動時に更新を確認」と「今すぐ確認」があります。確認は非同期で行い、失敗しても通常機能を継続します。更新が見つかった場合はACT下部のプラグインステータスと更新タブへ現在版、最新版、更新内容を表示します。ダウンロードは利用者が「更新する」を押した場合だけ開始します。

更新パッケージとSHA-256マニフェストを検証し、プラグイン名・バージョン・収録ファイルを確認してから %LOCALAPPDATA%\AetherTracker\Updates へ保存します。ACT終了後に補助プロセスは起動しません。ダウンロード完了後はACTを終了し、検証済みZIP内の CharacterTracker.dll をプラグイン配置先へ手動で置き換えてください。

更新元

安定版Releaseは Roxyz0501/aether-tracker-act から取得します。URLそのものをConfigへ保存する方式ではなく、ビルド時に固定した所有者／リポジトリ名だけからGitHub API URLを構成します。

機能

• ACT側は設定のみの軽量画面（全件テーブル更新なし）
• SocialDistance／Target Marker Overlayと共通の設定画面・オーバーレイデザイン
• オーバーレイ一覧での名前／Object ID検索、種類フィルター
• raw座標（ACT取得値）、高さ、プレイヤーからの水平距離
• 2地点校正後のゲーム内マップ座標（テリトリーごとに保存）
• 一覧オーバーレイの行をダブルクリックして追跡
• 選択対象への矢印、距離、高低差
• 矢印・一覧・マップを個別に表示／非表示
• オーバーレイ全体と背景の透明度を個別に調整
• 矢印・一覧・マップすべてのドラッグ移動、リサイズ、位置とサイズの保存
• 現在マップ画像上へのプレイヤー・NPC・その他オブジェクトの点表示
• マップ上でのマウスホイールズーム、点クリック時だけの名前表示
• プレイヤー正面基準／北基準の切替
• FFXIVが非アクティブなとき自動非表示
• 表示中だけ100ms共有スナップショットを利用し、全画面が非表示ならActor取得を停止。独自メモリ走査なし

インストール

1. ACT、FFXIV_ACT_Plugin.dll を有効にします。
2. CharacterTracker.dll をプラグイン用フォルダへ配置します。
3. CharacterTracker.dll を、ACT の Plugins > Plugin Listing > Browse... から追加します。
4. Windowsのファイルプロパティに「ブロックの解除」が表示される場合は、追加前に解除します。
5. 一覧オーバーレイの対象行をダブルクリックします。

OverlayPlugin は不要です。矢印・一覧・マップはこのプラグイン自身の軽量ウィンドウで表示します。ACTタブの「追跡矢印を表示」「キャラクター一覧を表示」「マップと座標点を表示」で個別に切り替えられます。FFXIVはボーダーレスウィンドウ／ウィンドウモードを推奨します。排他的フルスクリーンでは通常のWindowsオーバーレイが見えない場合があります。

初期状態ではすべてのオーバーレイを移動・リサイズできます。各オーバーレイのヘッダーを左ドラッグして移動し、ウィンドウの端をドラッグしてサイズを変更します。配置後に「オーバーレイを固定」をオンにすると誤操作を防げます。位置とサイズは個別に保存されます。固定中も一覧のダブルクリック追跡とマップ操作は利用できます。

「マップと座標点を表示」をオンにすると、ACTのTerritory IDからMap IDを自動解決します。階層切替はChangeMapログも併用し、XIVAPI v2から合成済みマップPNGとMapシートの縮尺・原点補正を取得します。画像は %APPDATA%\Advanced Combat Tracker\CharacterTracker\Maps にキャッシュされ、同じマップでは再ダウンロードしません。初回取得にはインターネット接続が必要です。

マップ上にマウスカーソルを置いてホイールを回すと、その位置を中心に100～500%でズームします。通常は点だけを表示し、点を左クリックしたときだけ対象名を表示します。点のない場所をクリックすると名前表示を解除します。「オーバーレイを固定」がオンでも、このマップ操作は利用できます。

矢印の基準について

FFXIV_ACT_PluginとOverlayPluginの公開APIにはカメラ角がありません。現在の矢印は「自分の向きを上にする」がオンならプレイヤー正面基準、オフならマップ北基準です。カメラ基準にはパッチ依存の直接メモリ読み取りが必要になるため、安全性と更新耐性を優先して実装していません。

ゲーム内座標の校正

ACTの座標はワールド座標（yalms）です。一方、ゲーム内マップのX/Yはマップ固有の縮尺と原点オフセットを適用した値なので、そのままでは一致しません。

1. マップを開いて現在のX/Yを読み、「地点Aを記録」に入力します。
2. 同じテリトリー内でX方向・Y方向の両方へそれぞれ5 yalms以上（精度のため20以上を推奨）移動します。
3. 新しいゲーム内X/Yを「地点Bを記録」に入力します。

変換は mapX = rawX × factorX + offsetX、mapY = rawY × factorY + offsetY です。FFXIV_ACT_PluginではX/Yが水平面、Zが高さです。ゲーム表示が小数1桁に丸められるため、離れた2点を使うほど誤差が小さくなります。インスタンス内のローカル座標など、ゲーム側に通常のマップ座標がない場所ではraw座標を利用してください。

設定・校正値は %APPDATA%\Advanced Combat Tracker\Config\CharacterTracker.config.xml に保存されます。

設定変更は即時にメモリへ反映されます。60秒ごとに最後の保存成功状態との差を確認し、変更がある場合だけ保存します。正常終了・プラグイン無効化時には最新値を最終保存し、完了を待ちます。強制終了や電源断では最後の保存後の変更が失われる場合があります。

Language、CheckUpdatesOnStartup、LastUpdateCheckUtc、SkippedVersion は追加設定です。旧Configに存在しなくても安全な既定値を使うため、従来の表示・校正・位置設定はそのまま読み込めます。

ビルド

Visual Studio の .NET desktop development workload と .NET Framework 4.8 targeting packが必要です。

.\build.ps1

PowerShellの実行ポリシーで止まる環境では powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build.ps1 を使えます。

ACTが標準以外の場所にある場合:

.\build.ps1 -ActPath 'D:\Apps\Advanced Combat Tracker'

GitHub Release公開手順

1. AssemblyInfo.cs のAssembly/File Versionを公開するSemVerへ更新します。
2. 確認済みのGitHub所有者名・リポジトリ名を UpdateConfiguration へ設定します。
3. 次のコマンドでRelease用ZIPとSHA-256マニフェストを生成します。

.\release.ps1 -Version <AssemblyInfo.csと同じSemVer>

4. 同じ名前のGitHubタグがないことを確認して vX.Y.Z タグを作り、通常Releaseを公開します。draft／prereleaseでは公開しません。
5. 生成された Aether-Tracker-ACT-vX.Y.Z.zip と Aether-Tracker-ACT-vX.Y.Z.sha256 を両方添付します。ファイル名は変更しません。
6. Release notesへ利用者向け変更点を記載します。プラグインは先頭1200文字を更新タブへ表示します。

更新通信はHTTPSの api.github.com、github.com、GitHub管理下の *.githubusercontent.com だけを許可します。GitHubトークンはプラグインへ埋め込みません。ZIP内は CharacterTracker.dll、README、共通UI仕様書だけを許可し、絶対パス、..、別プラグイン、想定外ファイルを拒否します。ACT終了後に動作するアップデータは使用しません。

注意

FFXIVの利用規約上、ACTを含む第三者ツールの利用は自己責任です。ゲーム内チャット等で第三者ツールの使用を話題にしたり、取得情報を用いて他者を攻撃したりしないでください。