Skip to content

Toolchain that lets you interact with the Overwatch files and extract models and stuff.

License

Notifications You must be signed in to change notification settings

overtools/OWLib

Repository files navigation

overtools Build Status Discord

Series of programs (tools) to interact with the Overwatch files.

Downloads & Help

Downloads for the tools and updates are posted on our Discord where you can also find support and disccusion around using them.

Join the Discord here: https://discord.gg/XM93ZdB

If the discord invite link does not work, paste XM93ZdB into the invite link box when clicking Add Server > Join Server

How to use

DataTool is a command line application which means you need to know how to use a command line.

  1. Make sure Overwatch is installed.
  2. Download the latest relase from our Discord
  3. Extract the all the files to a folder, do not put it in your Overwatch Directory.
  4. Open a command line in the folder where you extracted the files.
  5. Run DataTool.exe via command line for a list of help and supported commands.

Most commands follow the structure DataTool.exe <overwatch_directory> <mode> [mode args]

Blender Addon

In order to import skins or maps into Blender extracted by the tool, you will need to install our blender addon: https://github.com/overtools/io_scene_owm
Releases and updates for the addon are also posted on our Discord linked above.
Blender 3.4 or above is required.

Example List Commands

DataTool.exe "C:\Games\Overwatch" list-heroes
DataTool.exe "C:\Games\Overwatch" list-unlocks
DataTool.exe "C:\Games\Overwatch" list-maps
DataTool.exe "C:\Games\Overwatch" list-achievements

JSON output

Many of the list commands support JSON output.
To do this you must provide the --json flag as well as an --output flag to specify where to save the JSON file.
Example:

DataTool.exe "C:\Games\Overwatch" list-heroes --json --output "C:\Games\Extracts\Heroes.json"

Example Extract Commands

Some of the more common extract commands include:

  • extract-unlocks - ex all hero unlocks such as skins, highlight intros, emotes, sprays, icons
  • extract-general - handles extracting all all class unlocks such as all class sprays and icons and portraits
  • extract-maps - extract maps
  • extract-hero-voice - extracts all heroes voicelines and groups them by type (kinda)
  • extract-conversations - extracts all hero conversations

In most cases when using extract commands, you must provide the name of what you want to extract or use * for everything.
See below for some examples.

Example Commands

Tracers Overwatch 1 Skin (You can enter the name of any skin):
DataTool.exe "C:\Games\Overwatch" extract-unlocks "C:\Games\Extracts" "Tracer|skin=Overwatch 1"

All Heroes Overwatch 1 Skins:
DataTool.exe "C:\Games\Overwatch" extract-unlocks "C:\Games\Extracts" "*|skin=Overwatch 1"

All Heroes Skins (will take long time):
DataTool.exe "C:\Games\Overwatch" extract-unlocks "C:\Games\Extracts" "*|skin=*"

Everything - includes skins, emotes, highlight intros, etc. (will take very long time)
DataTool.exe "C:\Games\Overwatch" extract-unlocks "C:\Games\Extracts" *

Extract Dorado map
DataTool.exe "C:\Games\Overwatch" extract-maps "C:\Games\Extracts" "Dorado"

Extract All Maps (will take a long time)
DataTool.exe "C:\Games\Overwatch" extract-maps "C:\Games\Extracts" *

Extract Tracers Voicelines
DataTool.exe "C:\Games\Overwatch" extract-hero-voice "C:\Games\Extracts" Tracer

Extract Tracers Conversations
DataTool.exe "C:\Games\Overwatch" extract-conversations "C:\Games\Extracts" Tracer

Extract Unlocks filters

The extract unlocks command supports extracting a lot of data and you can filter to specifically what you want.
The command structure looks like: DataTool.exe <overwatch_directory> extract-unlocks <output_directory> [filters]
Filters follow the format {hero name}|{type}={item name}. You can specify * for the hero name or the type for everything.
Valid types include: skin, icon, spray, victorypose, emote, voiceline

Example Filters

"*"                                   // Everything (all heroes skins, sprays, etc) (very slow)
"*|skin=*"                            // All Heroes Skins
"Tracer|skin=Overwatch 1"             // Tracers Overwatch 1 skin
"Reaper|spray=*"                      // Reaper's sprays
"Reaper|voiceline=*"                  // Reapers unlockable voicelines

Tool Flags

There is also a variety of flags you can use that can change how some of the extract commands work.

--subtitles-with-sounds - Extracts subtitles in txt files next to the audio files (default false)
--voice-group-by-hero - When extracting voicelines, groups them by the hero (default true)
--voice-group-by-type - When extracting voicelines, groups them by the type (default true)
--voice-group-by-skin - When extracting voicelines, groups them by the skin (default false)
--voice-group-by-locale - When extracting voicelines, groups them by the locale (default false)

Disclaimer

This project is not affiliated with Blizzard Entertainment, Inc.
All trademarks referenced herein are the properties of their respective owners.
2022 Blizzard Entertainment, Inc. All rights reserved.