View source for Tutorial/Extracting with OverTool

'''Overtool only works with Overwatch 1.13 and below! It does not work with Overwatch version 1.14 and above.'''

{{Overtool}} is a great way of getting data out of Overwatch, as it sorts the data as best it can!

=Overview=
OverTool extracts data into sorted directories, using the in-game names. This means that rather than having to sort through all the files using the [[Tutorial/Extracting|CASCExplorer extraction method]], all the files have been placed in one spot for you. Pulling out Tracer, for example, puts the model, it's textures, and all associated animations into a single folder labeled <code>Tracer</code>. Further, each outfit exists in it's own subdirectory, so the Slipstream outfit and all it's files will be in a Slipstream subfolder.

There are two formats you can extract the models to:
*Raw, original formats. These are what Overwatch reads directly.
*The custom OWM formats. While a WIP, these contain the most usable data for models and maps. They can be imported by [https://owdev.wiki/User:Yukimono/Toolchain#Information Blender], [https://bitbucket.org/Kjasi/owmdl-maya-importer/downloads Maya], and [https://www.dropbox.com/sh/7psr5pwo2g2zjd9/AADhtuMzQzZg-HECBiOit_J4a?dl=0 3DS Max].
By default, the OWM format is used while exporting. You can use the <code>+</code> mode option at the end of the command to export the raw files instead.

You can find additional modes and details on the {{Overtool}} page!

=Software Needed=
* {{Overtool}} by dynaomi
* Overwatch installed on a local hard-drive.

=Steps=
==Prep==
# Extract OverTool. Mine was extracted to <code>E:\Overwatch\Software\toolchain</code>
# Open the OverTool folder, then click in the address bar at the top. Type <code>cmd</code> then press enter. This will open a command-prompt window in the current directory. 
#* Alternatively, you can shift + right-click in the current folder and choose 'Open command window here'
#* If neither of these works for you, click the start button, type <code>cmd</code> then hit enter. Type <code>e:</code> to switch to the E: drive (or whichever drive you have Overtool installed on). Once on the right drive, type <code>cd \Overwatch\Software\toolchain</code>. This will get you to <code>E:\Overwatch\Software\toolchain</code>, even if you started out in <code>D:\1001 Kitten Pics</code>.
# Install the Blender, Maya, and/or 3DS Max plugins/scripts. (Not covered by this tutorial, but highly recommended.)

==Common Usage==
No matter how you use OverTool, it always follows the same pattern:
 overtool "<path:/to/Overwatch>" mode "<path:/to/export/data/to>" "mode options"
An example command, to list all of the maps, would look like <code>overtool d:\Overwatch m</code> while <code>overtool d:\Overwatch M E:\Overwatch\Data\Maps "King's Row"</code> will export King's Row to my <code>E:\Overwatch\Data\Maps</code> folder. Please note that if you have a space in your directory paths, you need to put quotes around the paths. An example of this would be <code>overtool "d:\Overwatch PTR" m</code>.
The following sections will go into these modes and mode options in greater detail.

==Characters==
OverTool has several functions useful for extracting characters.
# The first thing to do is list all of the characters, to see what's available, and how to spell the character's names. Use the <code>t</code> mode to list all of the characters and their items. Example command: <code>overtool d:\Overwatch t</code>
# Choose the character you want to export. We'll go with everyone's favorite: Tracer.
# To export a character's data, you need to use mode <code>x</code>. We can export the models and textures using the <code>skin</code> option mode.
#* We can also extract sprays by using <code>spray</code> or icons with the <code>icon</code> mode option. We can also mix-and-match all three options to extract multiple items. This would look like <code>skin+spray+icon</code> to extract all three.
#* We can also limit which skins are extracted by using <code><character>=<skin name></code> option. An example of this would be <code>skin "d.va=white rabbit"</code> to only export D.Va's White Rabbit skin.
# Using the <code>x</code> mode and the <code>skin</code> option, export your character's model. Example command: <code>overtool d:\Overwatch x E:\Overwatch\Data\Characters skin Tracer</code> will export all of Tracer's models, textures, and animations for each of the skins to the <code>E:\Overwatch\Data\Characters</code> folder.
# [[Tutorial/Convert Overwatch Images to TGA with Photoshop|Convert any images]] you want to load, if your 3D software can't read the native DDS files.
# Import the model to your 3D software using the scripts above.
You can also extract all of the Character's voice lines:
# Use the <code>v</code> mode to extract a character's voice lines. Example command: <code>overtool d:\Overwatch v E:\Overwatch\Data\Characters Tracer</code> will export all of Tracer's voice lines into the <code>E:\Overwatch\Data\Characters</code> folder.
#* NOTE: This dumps ALL of the sound files for Tracer, and currently does not rename any of them.
# Follow the [[Tutorial/Convert Sound files to Ogg|Convert Sound files to Ogg]] tutorial to convert the audio files into a format playable by most media players.

==Maps==
NOTE: Currently, OWMap files can only be imported into Blender, via the Blender Script.
# Use option <code>m</code> to get a list of all the available maps. Example command: <code>overtool d:\Overwatch m</code>
# Find the map you want to export. Our example will be Estádio das Rãs. Now since this has spaces in the name, we will need to put quotes around it in the command.
# Type <code>overtool d:\Overwatch M E:\Overwatch\Data\Maps "Estádio das Rãs"</code> to extract Estádio das Rãs into the <code>E:\Overwatch\Data\Maps</code> folder. Please note that extracting maps requires a capital <code>M</code>, while listing the maps requires a small <code>m</code>.
#Once the command has finished, all of the models, textures, materials and the map itself should be available for importing.

=Troubleshooting=
{| class="wikitable"
! Problem
! Solution
|-
|Why can't I extract Soldier 76, Torbjorn or Lucio?
|OverTool is very exact with their names. You need to use the names exactly as they appear in the character/map listing. This means Soldier 76 needs to be <code>"Soldier: 76"</code>, Torbjorn needs to be <code>Torbjörn</code>, and Lucio needs to be <code>Lúcio</code>.
|-
|I can't find the skin/map I want!
|Make sure you have the latest {{Overtool}}, and have updated Overwatch. Also make sure your keys are up-to-date by checking our [[ow.keys]] page! If you still can't find it, try using the <code>t</code> option to look at the included characters, or <code>m</code> to inquire about maps.
|-
|I got a weird error while extracting!
|Make sure you have the latest {{Overtool}}, and have updated Overwatch. If you've done both of these, you can post about it [https://facepunch.com/showthread.php?t=1491521 here]. Be sure to include an image of the error, a copy of your command that created the error, and your PC's locale.
|-
|I can't see/read/load any texture maps!
|Overwatch natively uses DDS images for textures. If you can't read the DDS files in your software, you will need to convert them. [[Tutorial/Convert Overwatch Images to TGA with Photoshop|Here is a Photoshop Tutorial]] that covers converting the images from DDS to another Photoshop format, such as TGA.
|-
|How can I convert the character's voice files?
|Please follow the [[Tutorial/Convert Sound files to Ogg|Convert Sound files to Ogg]] tutorial to convert 03F/0B2/WEM files to Ogg.
|-
|Where's the music files?
|OverTool currently does not support exporting music. You can use the [[Tutorial/Extracting|CASCExplorer tutorial]] with the [[Tutorial/Convert Sound files to Ogg|Convert Sound files to Ogg]] tutorial to extract and convert all the music files.
|-
|How do I export an OBJ file?
|Use Overtool to extract the RAW Models from the desired character. You will then need to use the ModelTool to convert the raw file into an OBJ, as specified on the {{Overtool}} page. An example of this would be <code>ModelTool.exe 0000000002B1.00C o -L Tracer.obj</code> This will extract the first LOD of the raw Tracer Model to a Tracer.obj file.
|-
|What is the <code>src</code> directory? Why does the {{Overtool}} page say I need to download CASCExplorer?
|The <code>src</code> is the source code for OverTool. The need to download CASCExplorer (or rather, it's source code) is ONLY if you wish to edit the source code. The average user can simply ignore these aspects of the setup process.
|}

[[Category:Tutorials|Extracting]]