TWLogViewer 説明書

1. 概要
このツールは TalesWeaver のチャットログを監視して、ログ表示、計測、課題管理、課題追跡、争奪戦補助を行うデスクトップアプリです。

2. 起動方法
TWLogViewer.exe を起動してください。
管理者権限の確認が出る場合があります。
ゲームが前面でもホットキーを拾えるように、管理者権限で起動する構成です。

3. 初回起動後に設定するもの
通知アイコンまたはメイン画面の「設定」から、必要に応じて以下を設定してください。

- ログフォルダ
  例: C:\Nexon\TalesWeaver\ChatLog
- TWインストールフォルダ
  例: C:\Nexon\TalesWeaver
- ライセンスキー
- 透過度
- ホットキー
- 計測画面の表示 ON/OFF

4. ライセンスキーについて
ライセンスキーが正しく設定されている場合のみ、以下が利用できます。

- 争奪戦補助
- 通知音の設定と再生

ライセンスキーが未入力または不正な場合は、設定ファイルを直接書き換えて通知音を ON にしても機能しません。

5. 主な機能
- ログのリアルタイム表示
- 色別タブ表示
- タブ名変更
- タブのドラッグ並び替え
- 常に手前表示
- オーバーレイ表示
- チャット折りたたみ
- 計測画面
- 課題管理画面
- 課題追跡画面
- 争奪戦補助

6. 計測画面で見られるもの
基本計測
- 経験値
- 経験値/時
- 聖水/時
- ルーン経験値
- ルーン経験値/時
- 討伐数
- 討伐数/時
- ELSO総獲得
- ELSO/時
- 計測時間

追加計測
- 魔法の目 残り時間
- 偽・月の女王の軍の地図の切れ端 総獲得数
- 経験の聖水 自動変換ログ
- ルビコナコアの粉 総獲得数/時
- ルビコナコアの結晶 総獲得数/時

内訳
- 地図の切れ端の取得元ごとの内訳
- ELSOの入手元ごとの内訳

ログ切り出し
- 地図の切れ端の取得ログ
- 経験の聖水 自動変換ログ

7. 通知音について
- 初期状態では全タブ OFF です
- 設定画面の「通知音」で、タブごとに ON/OFF を変更できます
- 音量も設定画面から変更できます
- 通知音設定と通知音再生にはライセンスキーが必要です

8. 通知アイコンからできること
- オーバーレイ切り替え
- 常に手前に表示
- 計測画面を表示
- 計測開始/停止
- 計測リセット
- 課題管理画面
- 課題追跡画面
- 争奪戦補助
- 設定
- 終了

各画面表示メニューはトグル動作です。
すでに開いている場合は閉じ、閉じている場合は開きます。

9. ホットキー
初期値は以下です。

- Ctrl+Alt+O : オーバーレイ切り替え
- Ctrl+Alt+S : 計測開始/停止
- Ctrl+Alt+R : 計測リセット

ホットキーは設定画面から変更できます。

10. 設定画面について
- 設定画面は固定サイズです
- 初期表示で全設定が見切れない前提のサイズにしてあります
- 項目は「基本設定 / ライセンス / 表示 / ホットキー / 計測画面の表示 / 通知音」の順でまとまっています

11. 自動生成されるファイル
実行ファイルと同じフォルダに、以下のファイルやフォルダが作成されることがあります。

- TWLogViewer.config.json
  設定保存用です。無い場合は自動作成されます。
- abandon_patterns.json
  争奪戦補助のパターン定義です。無い場合は自動作成されます。
- task_checks
  キャラごとの課題進捗保存フォルダです。空でも問題ありません。

12. 起動時のJSONについて
- TWLogViewer.config.json が無くても起動できます
- abandon_patterns.json が無くても起動できます
- task_checks フォルダが空でも起動できます

ただし、壊れた JSON がある場合は、そのファイルの内容だけ読めず初期値扱いになることがあります。

13. 魔法の目について
- 使用時ログで残り時間を設定し、減少開始します
- ダンジョン退出時の保存ログで残り時間を設定し、減少停止します
- キャラごとに別管理です

14. 配布フォルダについて
現在の配布先は以下です。

- TWLogViewer_お試し版

配布用フォルダには、個人の task_checks\*.json やライセンスキーを含めない前提で扱っています。
