OWLib

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 580 Open GitHub ↗

DataTool is a program that lets you extract models, maps, and files from Overwatch.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DataTool - OWLib [![Build Status](https://github.com/overtools/OWLib/actions/workflows/dotnet.yml/badge.svg)](https://github.com/overtools/OWLib/actions/workflows/dotnet.yml) [![Discord](https://img.shields.io/discord/346445737367699456.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/XM93ZdB)

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

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

Join the Discord here: [https://discord.gg/XM93ZdB](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.

0. Make sure Overwatch is installed.
1. Download the latest release from our Discord
2. Extract the all the files to a folder, do not put it in your Overwatch Directory.
3. Open a command line in the folder where you extracted the files.
4. 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.5 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 `--out` flag to specify where to save the JSON file. 
Example:
```
DataTool.exe "C:\Games\Overwatch" list-heroes --json --out="C:\Games\Extracts\Heroes.json"
```

### Example Extract Commands

Some of the more common extract commands include:
 * extract-unlocks - extract all hero unlocks such as skins, highlight intros, emotes, sprays, icons
 * extract-general - handles extracting 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. 
2025 Blizzard Entertainment, Inc. All rights reserved.

OWLib

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README