Tutorial/Extracting with OverTool

From owdev
Jump to: navigation, search

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 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 Tracer. 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 Blender, Maya, and 3DS Max.

By default, the OWM format is used while exporting. You can use the + 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

  1. Extract OverTool. Mine was extracted to E:\Overwatch\Software\toolchain
  2. Open the OverTool folder, then click in the address bar at the top. Type cmd 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 cmd then hit enter. Type e: to switch to the E: drive (or whichever drive you have Overtool installed on). Once on the right drive, type cd \Overwatch\Software\toolchain. This will get you to E:\Overwatch\Software\toolchain, even if you started out in D:\1001 Kitten Pics.
  3. 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 overtool d:\Overwatch m while overtool d:\Overwatch M E:\Overwatch\Data\Maps "King's Row" will export King's Row to my E:\Overwatch\Data\Maps 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 overtool "d:\Overwatch PTR" m. The following sections will go into these modes and mode options in greater detail.

Characters

OverTool has several functions useful for extracting characters.

  1. 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 t mode to list all of the characters and their items. Example command: overtool d:\Overwatch t
  2. Choose the character you want to export. We'll go with everyone's favorite: Tracer.
  3. To export a character's data, you need to use mode x. We can export the models and textures using the skin option mode.
    • We can also extract sprays by using spray or icons with the icon mode option. We can also mix-and-match all three options to extract multiple items. This would look like skin+spray+icon to extract all three.
    • We can also limit which skins are extracted by using <character>=<skin name> option. An example of this would be skin "d.va=white rabbit" to only export D.Va's White Rabbit skin.
  4. Using the x mode and the skin option, export your character's model. Example command: overtool d:\Overwatch x E:\Overwatch\Data\Characters skin Tracer will export all of Tracer's models, textures, and animations for each of the skins to the E:\Overwatch\Data\Characters folder.
  5. Convert any images you want to load, if your 3D software can't read the native DDS files.
  6. Import the model to your 3D software using the scripts above.

You can also extract all of the Character's voice lines:

  1. Use the v mode to extract a character's voice lines. Example command: overtool d:\Overwatch v E:\Overwatch\Data\Characters Tracer will export all of Tracer's voice lines into the E:\Overwatch\Data\Characters folder.
    • NOTE: This dumps ALL of the sound files for Tracer, and currently does not rename any of them.
  2. Follow the 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.

  1. Use option m to get a list of all the available maps. Example command: overtool d:\Overwatch m
  2. 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.
  3. Type overtool d:\Overwatch M E:\Overwatch\Data\Maps "Estádio das Rãs" to extract Estádio das Rãs into the E:\Overwatch\Data\Maps folder. Please note that extracting maps requires a capital M, while listing the maps requires a small m.
  4. Once the command has finished, all of the models, textures, materials and the map itself should be available for importing.

Troubleshooting

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 "Soldier: 76", Torbjorn needs to be Torbjörn, and Lucio needs to be Lúcio.
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 t option to look at the included characters, or m 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 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. 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 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 CASCExplorer tutorial with the 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 ModelTool.exe 0000000002B1.00C o -L Tracer.obj This will extract the first LOD of the raw Tracer Model to a Tracer.obj file.
What is the src directory? Why does the OverTool page say I need to download CASCExplorer? The src 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.