WoWS ボイスmodマネージャ 取扱説明書
この説明書の対象バージョン：2.8
このツールはWoWSのボイスmodに関する様々な操作を可能にします。
機能：
- WoWSのボイスmodフォルダにあるボイスmodの一覧表示と名前の重複の検知
- ボイスmodの設定名およびフォルダ名の変更
- ボイスmodの削除
- ボイスmod内の設定と音声ファイルの整合性の検査
- WoWSの旧バージョン用modフォルダから最新バージョン用modフォルダへのボイスmodの移動
- ボイスmodの新規インストール
設定名とはゲーム内のESCキーメニュー→設定→オーディオ→ボイスパックのプルダウンメニューで表示されるボイス設定の名前です。 この名前が重複した複数のボイス設定（ボイスmod）がある場合、プルダウンメニューにはそれらは表示されず、使用することが出来ません。（各ボイスmodが置かれているフォルダ名はファイルの置き場の区別でしかなく、その問題とは関係ありません。）しかしこのツールを使用して設定名を変更することでその重複を解消することができます。
使い方：
- "SetupVoiceModManager.exe"をダウンロードして実行し、指示に従ってツールをインストールします。この手順は毎回行う必要はありません。
- ショートカットからボイスmodマネージャを起動するか、エクスプローラなどから"launch_voice_mod_manager.wsf"を実行します。
- ツールのウィンドウが開きます。まず正しいWoWSインストールフォルダ（ファイル"WorldOfWarships.exe"があるフォルダ）が操作対象フォルダに設定されているか確認してください。正しくない場合は、操作対象フォルダのリストから正しいものを選択してください。
- そのリストに正しいフォルダが入っていないときは、次の手順で設定してください。
(1) 入力欄にフォルダ名（フルパス名）を直接入力するか、"選択"ボタンを押して表示されるダイアログで該当のフォルダを選択します。
(2) "追加"ボタンを押して操作対象フォルダのリストに追加します。追加と同時にそれが選択された状態になります。
このリストは独自の設定ファイルに保存され、次回のツールの起動時にも有効です。リストから不要なものを削除したい場合は、それを選択した状態で"削除"ボタンを押してください。
- 正しいWoWSインストールフォルダが設定されていればWoWSの最新バージョンが自動で検出され、ウィンドウの左側にボイスmodフォルダ（WoWSインストールフォルダ\bin\XXXXXXX\res_mods\banks\mods）に現在インストールされているボイスmodの設定名のリストが表示されます。もしその設定名が重複しているものがあればそれらの名前の先頭に"<Dup>"が表示されます。設定名がないものは"<Unnamed>"と表示されます。
- ボイスmodの設定名あるいはそのフォルダ名を変更したい場合は、ボイス設定名のリストからその対象を選択するとその右の入力欄に設定名とフォルダ名が表示されるので、必要に応じ任意の名前に書き換えてから"変更"ボタンを押してください。
- 設定名およびフォルダ名の入力欄の書き換え中に内容を元に戻したい場合は、"キャンセル"ボタンを押してください。
- ボイスmodを削除したい場合は、対象の名前を選択してから"削除"ボタンを押してください。そのボイスmodがフォルダごと削除されます。削除したものは元に戻せません。
- ボイスmodの設定ファイル"mod.xml"の内容とボイスのファイル（拡張子.wemのファイル）の整合性を検査したい場合は、対象の名前を選択してから"検査"ボタンを押してください。検査の結果、整合性に問題があった場合はその詳細がこのツールをインストールしたフォルダに"modxmlchk.log"のファイル名で保存されます。このとき、このファイルの内容を閲覧するかを選択できます。このファイルは検査を行う毎に置き換えられます。
- WoWSの旧バージョン用のmodフォルダが存在する場合は、ウィンドウ右側の枠上部のフォルダ名のプルダウンリストにそれらが表示されます。フォルダ名は番号で表され大きいほど新しいものになりますが、現行の最新バージョンのフォルダはここでは除外されます。そのリストで選択されたフォルダにボイスmodが存在する場合は、その下の欄にその設定名のリストが表示されます。
- 旧バージョン用のボイスmodを最新バージョンで使用したい場合は、リストの中から移動させたい対象の名前を選択してから"移動"ボタンを押してください。移動したものは元に戻せません。また、全てのボイスmodを移動させたい場合は、"全て移動"ボタンを押してください。
- 新たにボイスmodをインストールしたい場合は、次の手順で行ってください。
(1) 該当ファイル（ドライブ内に展開済のボイスmodのファイル群の中の"mod.xml"ファイル、または未展開のzipファイル）のファイル名（フルパス名）を、ウィンドウ下部の入力欄に直接入力するか、"選択"ボタンを押して表示されるダイアログで選択します。
(2) "インストール"ボタンを押すとそのボイスmodがインストールされます。
- このツールの使用中にエクスプローラで操作を行ったときなど、画面内の情報表示を最新の状態にしたい場合は、左下の"最新の情報に更新"ボタンを押してください。
- ツールを終了したいときはウィンドウ右上の×ボタンを押してください。
注意：
- インターネットに接続された状態でツールを起動すると、自動自己更新機能が働きます。このツールのより新しいバージョンがリリースされた場合、自動でそれに更新されます。
- このツールはWoWSのバージョンが更新されても自動検出しますので、ゲームのリソース構造の変更が影響しない限り問題なく継続して使用できます。
- ゲームの動作中にこのツールを起動することは可能ですが、このツールによって何らかの操作を行った後は必ずゲームを再起動してください。WGCまたはゲームランチャーによるゲームのアップデート動作中はこのツールでの操作を行わないでください。
- ウィンドウ左側のリストに設定名が表示されない場合はボイスmodとして認識できていませんので、modを正しくインストールし直して下さい。
- "mod.xml"とwemファイルの整合性検査は、「"mod.xml"で使用しているwemファイルが全て存在するか」および「存在するwemファイルが全て"mod.xml"で使用されているか」を判断しています。そのボイスmodがゲームで使用できるかどうかではありません。そのボイスの内容がゲーム内でボイスを再生するタイミングと合致しているかどうかは判断できません。
- 旧バージョン用のボイスmodは、ゲームの対応ボイスファイルフォーマットおよび"mod.xml"の定義データ構造が変更にならない限り継続して使用できると思われます。しかしこのツールでは使用できるかできないかの判断はできません。自身の責任においてゲームのトレーニングモードで確認してからプレイに使用してください。
- ボイスmodの新規インストール時に"mod.xml"ファイルを指定した場合は、そのファイルのあるフォルダ以下にある全てのフォルダとファイルをボイスmodのファイルとみなしてWoWSのボイスmodフォルダにコピーします。"mod.xml"がドライブのルートフォルダにある場合はインストールできません。
- ファイル名指定の際、"選択"ボタンを押してファイル選択ダイアログを表示させたとき、"アップロードするファイルの選択"というタイトルになっていますが、実際はファイルはネット上のどこにもアップロードされません。
- ボイスmodの新規インストール時にzipファイルを指定した場合は、そのファイルの中にあるすべてのボイスmodをインストールしようとします。
- 指定したzipファイルの中に多バイト文字（いわゆる全角文字）のフォルダ名またはファイル名が含まれるとき、それがUTF-8の場合のみインストール可能です。それ以外の場合はそのままでは正常にインストールできませんので、そのzipファイルを一旦別の場所に手動で展開してからその中の"mod.xml"ファイルを指定してインストールしてください。
- 旧バージョンからmodを移動する際や、新たなmodをインストールする際に同じフォルダ名が既にある場合は、重複しないようフォルダ名に"(数字)"が自動で付加されます。
- このツールを使用してもボイスmodをゲームが認識しない場合は"mod.xml"のどこかに不正な箇所がある可能性が高いので、自身で修正するかそのボイスmodの最新版を入手して使用してください。
- 現在のWoWSバージョンでは、ボイスmodの設定名としてASCII文字（いわゆる半角の英字大文字小文字、数字、記号）、およびUTF-8でコード化できる文字が使用できますが、ゲーム内ではそれを表示できるフォントが必要となります。なお、将来にわたってそれらが使用可能であり続けるかどうかは保証できません。
- このツールの使用にあたって、関連する全てのフォルダ名およびファイル名にはWindowsのファイルシステムの命名規則に沿った文字が使用できます。ただしその中にASCII文字の"%"、"!"、"^"のいずれかが1文字でも含まれている場合、このツールは正常に動作しない可能性があります。特にこのツールが置かれている場所（フルパス名）についてはそれらの文字を含んていた場合、ツールの起動時にエラーとなります。
- Steam版WoWSに対してこのツールを使用する場合も、"WorldOfWarships.exe"の存在する正しいインストールフォルダを操作対象に指定してください。
Steam版WoWSの場合の入力例→C:\Program Files (x86)\Steam\steamapps\common\WorldofWarships
なお、Steam版WoWSについては作者の動作確認対象外です。
- このツールはHTAという仕組みによって動作しています。このツールの動作にはWindowsに標準搭載されている"mshta.exe"が必要です。また、Windows Powershellがインストールされている必要があります。
- 作者はこのツールの動作をWindows10 21H2 + Internet Explorer 9以降のHTA実行環境で確認していますが、どのような環境でも正常に動作しない可能性があり保証はできません。正常に動作しなかった際は誠にお手数ですが「お使いの環境」と「どんな状況で」「何をしたら」「どうなった」といった詳しい情報をウェブサイトのご意見投稿欄よりお送り下さると幸いです。ただし、作者が何等かの対処を必ず行うかは保証しません。
- ファイルの改変の有無に関係なくこのツールおよびmodを使用し何らかの損害が発生したとしても作者は一切関知しません。
- このツールが使用しているIonic.Zip.dllは、Microsoft Public License(Ms-PL)によって保護されています。
(C) 2018-2022 kani_cream_syumai
