Skip to content

FFXIV Duty Finder Assist for ngld/OverlayPlugin

License

Notifications You must be signed in to change notification settings

qitana/ACT_DFAPlugin

Repository files navigation

ACT_DFAPlugin

The add-on of ngld/OverlayPlugin which shows Duty Finder status.

DutyFinder(コンテンツファインダー) のステータスをオーバーレイ表示する、ngld/OverlayPlugin のアドオンです。

日本語の説明はこちら / README for ja-JP is here

Requirements

Features

  • Displayed when the roulette name and dungeon name have been determined.
    • Also be notified by text-to-speech.
  • Displays the queue position and estimated waiting time.
    • The actual queue position is displayed even if the number of waits is 50 or more.

How to use

  1. Install ngld/OverlayPlugin.
  2. Download DFAPlugin from release page and extract it to any folder.
    It is recommended that you create and place a separate folder with other plugins.
  3. Install DFAPlugin as an ACT plugin.
  4. Restart ACT once.
  5. Confirm that DFA EventSource is added to the OverlayPlugin setting screen.
  6. Add an overlay with OverlayPlugin. Select "MiniParse" as the type.
  7. On the setting screen, set the URL to https://qitana.github.io/ACT_DFAPlugin/dfa.html.
  8. Adjust the installation position and size, and lock when the position is determined.
    When locked, the overlay will not be displayed, but will only be displayed when using the Duty Finder.

Other overlay type

visit https://qitana.github.io/ACT_DFAPlugin/.
Please feel free to contribute another your overlay!

Special thanks

The algorithm refers to easly1989/ffxiv_act_dfassist.

Japanese

注意事項

v2.x からは ngld/OverlayPlugin でないと動きません!hibiyasleep/OverlayPlugin では動きません!
また、ngld/OverlayPlugin と hibiyasleep/OverlayPlugin は併用できません!

  • kagerou等の今までのオーバーレイは ngld/OverlayPlugin でも動作します。
  • hibiyasleep/OverlayPlugin のアドオンは ngld/OverlayPlugin では動きません。

できること

  • 突入場所が判明した際にルーレット名およびコンテンツ名をTTSで通知できます。
  • ネットワークデータで待ち人数/更新時間が更新(1分間隔)され次第、表示が更新されます。
    ゲームクライアントでは、データ到着から30秒後に1個前のデータとの中間値を表示しています。
    (おそらく変化を緩やかにするためだと思われます。)
  • 待ちが50番以降でも、実際の待ち人数が表示されます。
  • あと何分でシャキりそうか、残り時間が表示されます。(開始時間と待ち時間から計算しています。)
  • シャキった後、突入を押す前でもロール毎のパーティ編成状況が分かります。

特徴

  • 実体は ngld/OverlayPlugin の EventSource プラグインです。
    これを導入することで、オーバーレイで DutyFinder (コンテンツファインダー) のデータが扱えるようになります。
  • FFXIV_ACT_Pugin が取得したネットワークデータを使用して処理しています。
  • パッチ毎に変更されるOpcodeに対応するため、Opcodeの設定を外部ファイルにしているので、
    大きな変更がされない限りは、プラグインをアップグレードせずに使用可能です。
    最新のOpcode設定ファイルが更新されれば、起動時に自動で読み込まれます。
  • Opcode を確認するための Trace 機能があります。
  • 主に日本語の難読なダンジョン名称にTTSが対応できないことが多いため、
    TTS補助用の読み仮名変換を外部ファイルで設定しています。
    このデータも、起動時に自動で最新のファイルが読み込まれます。
    おかしな読みが発声した場合は PR/Issue で教えて頂けると助かります。

インストール方法

  1. ngld/OverlayPlugin をACTのプラグインとして導入します。
  2. Release から DFAPlugin をダウンロードし、任意のフォルダに展開します。
    他のプラグインと同じフォルダに入れないよう、別フォルダを作って配置することをおすすめします。
  3. DFAPlugin を ACTのプラグインとして導入します。
  4. DFAPlugin を OverlayPlugin に認識させるため、一度ACTを再起動します。
  5. OverlayPlugin の設定画面に DFA EventSource が増えていることを確認します。
  6. OverlayPlugin で オーバーレイを追加します。種類は MiniParse を選びます。
  7. 設定画面でURLを https://qitana.github.io/ACT_DFAPlugin/dfa.html に設定します。
  8. 設置位置や大きさを調整し、位置が決まったらリサイズ/変更が出来ないようにロックします。
    オーバーレイは見えなくなりますが、コンテンツファインダーを使用した際だけ表示されるようになります。

謝辞

マッチングのコードは easly1989/ffxiv_act_dfassist で使用されているコードを参考にしています。

よくある質問

CFで申請しても表示されない

いくつか考えられますが、以下を確認して下さい

  • オーバーレイのURLを正しく設定できていない
  • オーバーレイを表示するにチェックがはいっていない
  • FFXIV_ACT_Plugin をメモリオンリーで使用している

日本語環境なのに表示やTTSが英語になる

FFXIV_ACT_Plugin の言語設定が日本語になってるか確認して下さい。

コンテンツファインダーを使用していない時は隠したい

「移動とサイズを制限する」のチェックを入れて下さい。

オーバーレイが見えないので位置が決められない

レイアウト用に表示したいときは 「移動とサイズを制限する」 のチェックを外して下さい。
このチェックを外すと、全ての項目が表示されます。
レイアウトが定まったら 移動とサイズを制限する」のチェックを入れて下さい。

For Developers

develop ブランチは私の作業用ブランチです。
不定期に rebase および push --force することがありますので、develop を追従しないようご注意下さい。