WoWS Collaboration Character Mix Voice Mod Creation Tool Instructions

Version covered by this instructions: 5.0.1

Table of Contents:

1. License Agreement
   
2. Outline
   
3. Features
   
4. Setup
   
5. How to use
   
6. Notes
   
7. Uninstall
   
8. System Requirements
   
9. Copyrights
   

License Agreement:

• The author is not responsible for any damage caused to the user by using this tool or this batch program or mods created with it, regardless of whether or not the files that make up this tool have been modified, and regardless of whether the game is inside or outside of the game.
  
• This tool and batch program may not work properly in all environments, and the author does not guarantee that it will always work properly.
  
• The author does not guarantee that any defects in the operation of this tool and batch program will always be addressed by the author.
  
• Even if this tool and batch program cannot be used because WoWS has been updated, the author does not guarantee that the author will update the tool and batch program every time.
  
• You may modify this tool and batch program and use it, but redistribution of the unmodified this tool and batch program or distribution of the modified this tool and batch program is prohibited.
  

Only those who agree to all of these conditions may use this tool and batch program.

Outline:

• This tool and batch program allows you to create a voice mod that allows any character you choose from those implemented in the collaboration to speak during game combat, and install it in the WoWS game client. The creation and installation is done at the same time, and as soon as the batch is finished, the game can be started and the voice mod can be used.
  
• The voice mods created in this tool and batch program will be available for selection in the Esc key menu in-game -> Settings -> Audio -> Modification pull-down.
  
• This tool is designed to allow GUI operation for specifying options and starting the batch program that actually creates the mod, and the batch program installed with this tool can also be used directly at the command prompt to create the mod.
  

Target Collaboration and Characters:

• Arpeggio of Blue Steel:
  Iona (CV: Mai Fuchigami), Takao (CV: Manami Numakura), Kongo (CV: Yukana), Hiei (CV: M.A.O), Haruna (CV: Hibiku Yamamura), Kirishima (Yotaroh) (CV: Yumi Uchiyama), Myoko (CV: Ayaka Fukuhara), Nachi (CV: Satomi Sato), Ashigara (CV: Suzuko Mimori), Haguro (CV: Hiromi Igarashi), Maya (CV: MAKO), Musashi (CV: Rie Kugimiya), Yamato (CV: Mai Nakahara), Gunzou Chihaya (CV: Kazuyuki Okitsu)
  Currently, the voice of Kirishima before becoming a plush is not implemented, so please select "Kirishima_bear" ("Yotaroh" in the game) instead.
  
• High School Fleet:
  Akeno Misaki & Mashiro Munetani (CV: Shiina Natsukawa & Lynn), Wilhelmina & Thea (CV: Hiromi Igarashi & Chitose Morinaga), Kouko Nosa (CV: Yuko Kurose), Mei Irizaki (CV: Atsumi Tanezaki), Maron Yanagiwara (CV: Natsumi Takamori), Moeka China (CV: Sora Amamiya)
  In this batch, all the voices of Isoroku (Isoroku the cat) are excluded because we do not know what he is says, and cannot be use them to create voice mods.
  
• Azur Lane:
  Aurora (CV: Marie Miyake), Belfast (CV: Yui Horie), Cleveland (CV: Saya Horigome), Enterprise (CV: Yui Ishikawa), Admiral Hipper (CV: Yuri Yamaoka), Hood (CV: Atsuko Tanaka), Nelson (CV: Yuki Kuwahara), Atago & Kaga (CV: Ai Kayano), Azuma (CV: Kiyono Yasuno), Dunkerque (CV: Sayaka Harada), Montpelier (CV: Rie Takahashi), Neptune (CV: Mikako Izawa), Prinz Eugen (CV: Ayane Sakura), Yukikaze (CV: Kana Yuki), Baltimore (CV: Minami Takahashi), Itsen (CV: Yu Asakawa), Jean Bart (CV: Marina Inoue), Littorio (CV: Shizuka Ito), Roon (CV: Satomi Sato), Shokaku (CV: Risa Taneda), Sovetskaya Rossiya (CV: Manami Numakura), New Jersey (CV: Miyu Tomita), Saint Louis (CV: Asami Seto), Zara (CV: Atsumi Tanezaki), Formidable (CV: Rie Kugimiya), Chapayev (CV: Masumi Tazawa), Bismarck (CV: Ayaka Fukuhara)
  
• Legend of the Galactic Heroes:
  Reinhard von Lohengramm (CV: Mamoru Miyano), Siegfried Kircheis (CV: Yuichiro Umehara), Frederica Greenhill (CV: Aya Endo), Dusty Attemborough (CV: Kaito Ishikawa), Yang Wen-li (CV: Kenichi Suzumura)
  

Features:

The features of the mod creation itself are as follows, as described in the batch program's instruction manual.

• You can create an individual character voice mod for all the target characters.
  
• You can select two to all characters arbitrarily, mix them together, and create a voice mod in which one of them at random speaks at the timing of the voice playback during the game's combat. For example, if you mix character A with character B, either A or B will speak. You can create any number of mixed voice mods.
  
• You can choose which character to speak when receiving radio chats (quick commands) from other player ships from the following options. When sending, only the character selected as your character will speak. This is a common setting for all voice mods that the tool creates at that time.
  
  1. Only selected own character(s) (If you select more than one character, all of them)
     
  2. All of target collaboration implementation characters
     
  3. All of target collaboration implementation characters except the selected own character
     
  4. None (No one speaks at all)
     
• This tool allows you to create voice mods that coexist with sound effect mods. If you have a prepared configuration file for a sound effect mod with its sound file, you can combine them. If the sound effect mod has voice settings in its configuration file, they will be ignored and not combined. This is also a common setting for all voice mods that the tool creates at that time.
  
• In the voices that come with officially sold or distributed collaborative character captains, some of the voice playback events are not supported and are silent or play the default male voice. This In the voice mods created by this tool, those unsupported parts are assigned a different voice with a similar meaning as possible, and the default voice is adjusted so that it does not play.
  

The tool also provides the following features not available in the batch program.

• All options that can be specified when executing a batch program can be configured in the tool via GUI.
  
• When executing mod creation, the batch program corresponding to the selected collaboration title and display language is automatically selected. After the batch program is started, no operation is required until the process is completed.
  
• Multiple folder locations where WoWS is installed can be registered in advance, and the mod installation destination can be specified simply by selecting it as needed.
  
• The contents of each option item you set can be saved as up to 10 profiles. Saved profiles can be recalled at any time.
  

Setup:

Make the tool available in the following ways:

Download and execute SetupVoiceModTool.exe and follow the instructions to install the necessary files. The selection will automatically create shortcuts in the Windows Start menu and on the desktop.

How to use:

Execute mod_voice_mix_tool.exe from the Start menu or Explorer, etc. to launch the tool. You can launch the exe file directly or from a shortcut to it.

1. Click on the "Select" button to specify in the dialog the target WoWS installation folder where you want to install the voice mod, or enter the path to the folder in the input field. Then click the "Add" button to add the path to the list below. The path selected in this list will be the target of the installation when the mod is created. Just entering the input field does not make it a mod installation destination. To remove a path from the list, select it and click the "Delete" button.
   
2. Select from the list the name of the target collaboration title for the character for which you want to create a voice mod. Changing this selection will initialize all configuration (3-7) below it. If you wish to initialize the configuration without changing this selection, click on the "Clear" button on the right.
   
3. Select a character with the "Select" button to create a voice mod for a individual character. Multiple targets can be selected, but a individual character voice mod will be created for each.
   
4. You can set up to create a voice mod that mixes two or more characters. You can set up multiple mixed voice mods to be created in a single run of creation. To add a new setting, click the "Clear" button to initialize each entry field, enter a name of your choice (up to 30 characters) in the "Name" field, and select the character you wish to mix by clicking the "Select" button below it. Once they are determined, click on the "Add" button and make sure that the name of the setting you entered appears in the list on the left. Once you have added a setting to the list, you can select it (click on it) to edit it again. When editing is complete, click on the "Replace" button. If you no longer need a setting in the list, select it and click the "Delete" button to delete it.
   
5. Select the behavior for receiving radio chats common to each voice mod you create. (Details are explained in "Features" above.) In the column to the right of the "Select" button, you can select the characters you wish to include or exclude from the target characters by selecting them individually. If you select "Only selected own character" or "None" the character specified here is forcibly included among the speaking characters, and if you select other than those, the character specified here is forcibly excluded so that it does not speak.
   
6. When this checkbox is checked, if a voice mod with the same name already exists in the installation when the mod creation is executed, it will create a mod with a different name without overwriting it.
   
7. Checking this box allows you to integrate another sound effect mod into the voice mod you are creating. Since a separate sound effect mod and a voice mod cannot be used at the same time, this feature makes it possible. In the dialog that appears after you check this box, specify the mod.xml file that is the setting file for the sound effect mod you want to integrate, or the zip file that contains all the files of the sound effect mod, or enter the path to the file in the input field.
   
8. In the Profile menu, you can save the settings in the window (2-7 above) as a profile, load a saved profile, or delete a saved profile.
   Open: Loads the profile of the selected number. The settings in the window before loading are discarded.
   Save: Saves the settings in the window to the profile of the selected number. A check mark will be placed on the number where a profile has already been saved, and if that number is selected, a confirmation option will be displayed to ask if it is OK to overwrite the settings.
   Delete: Deletes the profile for the selected number. You will be given the option to confirm that you wish to do so before deleting.
   Exit: Exits the tool.
   
9. In the Creation menu, you can execute mod creation and specify options for execution.
   Execute: Executes the mod creation batch and creates a voice mod according to your settings. A window will appear showing the progress of the creation process. When the process is complete, a "Close" button will appear, and clicking it will close the window. During the creation process, the title bar of the window may display "No response", but this will disappear after a few moments, as the process is continuing without any problems.
   Allow batch updates: Select whether to allow batch program updates when the latest version of the batch program is detected to have been released before execution. Normally, check the option to allow it.
   Verbose log mode / Debug mode: These checks are used to gather information to investigate the cause of a problem or other problem with the batch program that creates the mod. Check these options when instructed to do so by the tool's author. Normally, both should be turned off.
   Copy command line: If you want to execute the voice mod creation batch program with your settings as command line options, select this menu item to copy the command line string to the clipboard so that you can execute the batch program by simply opening the command prompt and pasting the string The batch program can then be execute by opening the command prompt and pasting the string.
   
10. In the Help menu, you can switch display languages and get other information.
    Language: Allows you to switch the display language for the entire window.
    Instructions / Visit website: Displays the top page of the website that distributes this instruction manual and this tool using the default browser application configured in the OS.
    About: Displays the version information of this tool.
    

Notes:

Refer to the respective instruction manuals for notes on the mod creation batch program and creation process.

• When the tool is launched while connected to the Internet, it will automatically self-update itself if it detects that the latest version of this tool has been released.
  
• This tool can continue to be used without problems when the WoWS version is updated, as long as changes in the game's resource structure do not affect it. However, to ensure that the mod creation batch can accurately detect the WoWS version, please be sure to launch the game for the first time after installing or updating the WoWS game client.
  
• If this tool is started while the WoWS launcher software or game client is running, a warning will be given, but it can still be started. However, if the game client or launcher in the target WoWS installation directory is running when the mod creation starts, an error will occur and creation will not be possible.
  
• If single-byte characters %, !, &, or ^ contained in the full pathname of the location where this tool is located, where WoWS is installed, or where the sound effect mod to be integrated is located, this tool cannot be used and should be renamed accordingly.
  
• If you have created and installed a voice mod and it does not appear in the modification options in the in-game settings, please use the Voice Mod Manager to check and resolve the issue.
  
• When you execute mod creation in verbose log mode or debug mode, a file named "mod_xxx_voice_en.log" in verbose log mode or "debug_xxx_bat.part*.cab" (xxx is one of arp, hsf, azr, or lgh, * is a number) in debug mode is created in the "(the folder where you installed the tool)\bin\bat" folder. When instructed by the author of the tool, please send these files to the author via the mail form page of our website.
  

Uninstall:

• If you no longer need the tool, you can remove it by using the uninstaller. If you have removed the shortcut to the uninstaller from the Start menu, you can find the uninstaller unins000.exe in the folder where you installed this tool.
  
• This tool and batch program does not record configuration information in OS-managed areas such as the registry.
  

System Requirements:

• This tool has been tested to work with the Windows10 22H2. This tool is designed to work in any environment that can run WoWS, but it may not always work correctly.
  
• Microsoft Edge WebView2 Runtime (Application execution environment using Edge for Chromium) is required to execute this tool. If you have the latest version of Edge available, there is no particular need to install it separately. If WebView2 Runtime is not installed, download and install the one that matches your environment (usually the x64 version) from the Microsoft website.
  
• PowerShell must be installed to handle downloads, zip file expansion, etc. in the execution of this tool and batch programs.
  
• If you experience any problems, we would appreciate it if you could provide us with more detailed information such as "your environment", "under what situation", "what you did", "what happened", etc. using the feedback submission form of our website.
  
• This tool and batch program is designed to work even if your version of WoWS is the Steam, EpicGames, or MicrosoftStore version, but has not been tested on those versions by the author.
  

Copyrights:

• This tool and batch are copyrighted by the author kani_cream_syumai.
  
• Extcmd2.cab is packaged from binaries distributed on the GnuWin project site, the Windows version of GNU, with only selected commands and libraries needed to execute the batch. The licenses for this software are listed on the corresponding pages.
  
• Ionic.Zip.dll is protected by the Microsoft Public License (Ms-PL).
  
• XMLStarlet is open source freeware under the MIT License.
  
• Wowsunpack.exe is copyrighted by Wargaming.net, Inc.
  

(C) 2016-2023 kani_cream_syumai