{"id":18109561,"url":"https://github.com/overtools/OWLib","last_synced_at":"2025-03-29T16:30:49.470Z","repository":{"id":20352680,"uuid":"89700972","full_name":"overtools/OWLib","owner":"overtools","description":"DataTool is a program that lets you extract models, maps, and files from Overwatch.","archived":false,"fork":false,"pushed_at":"2025-03-22T02:21:50.000Z","size":28533,"stargazers_count":386,"open_issues_count":1,"forks_count":42,"subscribers_count":25,"default_branch":"develop","last_synced_at":"2025-03-22T02:22:01.043Z","etag":null,"topics":["blizzard","blizzard-games","blte","casc","csharp","datatool","extraction","modeling","ngdp","overtools","overwatch","overwatch-2","tact"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/overtools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-28T11:43:55.000Z","updated_at":"2025-03-22T02:21:54.000Z","dependencies_parsed_at":"2023-10-28T13:25:05.293Z","dependency_job_id":"ae50ebce-9575-421c-a03d-788c4405bd98","html_url":"https://github.com/overtools/OWLib","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/overtools%2FOWLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/overtools%2FOWLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/overtools%2FOWLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/overtools%2FOWLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/overtools","download_url":"https://codeload.github.com/overtools/OWLib/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246213447,"owners_count":20741725,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blizzard","blizzard-games","blte","casc","csharp","datatool","extraction","modeling","ngdp","overtools","overwatch","overwatch-2","tact"],"created_at":"2024-11-01T00:01:51.238Z","updated_at":"2025-03-29T16:30:49.461Z","avatar_url":"https://github.com/overtools.png","language":"C#","readme":"# 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=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/XM93ZdB)\n\nSeries of programs (tools) to interact with the Overwatch files.\n\n## Downloads \u0026 Help\nDownloads 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.\n\nJoin the Discord here: [https://discord.gg/XM93ZdB](https://discord.gg/XM93ZdB)\n\nIf the discord invite link does not work, paste `XM93ZdB` into the invite link box when clicking `Add Server \u003e Join Server`\n\n## How to use\nDataTool is a command line application which means you need to know how to use a command line.\n\n0. Make sure Overwatch is installed.\n1. Download the latest release from our Discord\n2. Extract the all the files to a folder, do not put it in your Overwatch Directory.\n3. Open a command line in the folder where you extracted the files.\n4. Run DataTool.exe via command line for a list of help and supported commands.\n\nMost commands follow the structure `DataTool.exe \u003coverwatch_directory\u003e \u003cmode\u003e [mode args]`\n\n### Blender Addon\nIn 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\u003cbr\u003e\nReleases and updates for the addon are also posted on our Discord linked above.\u003cbr\u003e\n**Blender 3.5 or above is required.**\n\n### Example List Commands\n```\nDataTool.exe \"C:\\Games\\Overwatch\" list-heroes\nDataTool.exe \"C:\\Games\\Overwatch\" list-unlocks\nDataTool.exe \"C:\\Games\\Overwatch\" list-maps\nDataTool.exe \"C:\\Games\\Overwatch\" list-achievements\n```\n\n#### JSON output\nMany of the list commands support JSON output.\u003cbr\u003e\nTo do this you must provide the `--json` flag as well as an `--out` flag to specify where to save the JSON file.\u003cbr\u003e\nExample:\n```\nDataTool.exe \"C:\\Games\\Overwatch\" list-heroes --json --out=\"C:\\Games\\Extracts\\Heroes.json\"\n```\n\n### Example Extract Commands\n\nSome of the more common extract commands include:\n * extract-unlocks - extract all hero unlocks such as skins, highlight intros, emotes, sprays, icons\n * extract-general - handles extracting all class unlocks such as all class sprays and icons and portraits\n * extract-maps - extract maps\n * extract-hero-voice - extracts all heroes voicelines and groups them by type (kinda)\n * extract-conversations - extracts all hero conversations\n\nIn most cases when using extract commands, you must provide the name of what you want to extract or use `*` for everything.\u003cbr\u003e\nSee below for some examples.\n\n#### Example Commands\n```\nTracers Overwatch 1 Skin (You can enter the name of any skin):\nDataTool.exe \"C:\\Games\\Overwatch\" extract-unlocks \"C:\\Games\\Extracts\" \"Tracer|skin=Overwatch 1\"\n\nAll Heroes Overwatch 1 Skins:\nDataTool.exe \"C:\\Games\\Overwatch\" extract-unlocks \"C:\\Games\\Extracts\" \"*|skin=Overwatch 1\"\n\nAll Heroes Skins (will take long time):\nDataTool.exe \"C:\\Games\\Overwatch\" extract-unlocks \"C:\\Games\\Extracts\" \"*|skin=*\"\n\nEverything - includes skins, emotes, highlight intros, etc. (will take very long time)\nDataTool.exe \"C:\\Games\\Overwatch\" extract-unlocks \"C:\\Games\\Extracts\" *\n\nExtract Dorado map\nDataTool.exe \"C:\\Games\\Overwatch\" extract-maps \"C:\\Games\\Extracts\" \"Dorado\"\n\nExtract All Maps (will take a long time)\nDataTool.exe \"C:\\Games\\Overwatch\" extract-maps \"C:\\Games\\Extracts\" *\n\nExtract Tracers Voicelines\nDataTool.exe \"C:\\Games\\Overwatch\" extract-hero-voice \"C:\\Games\\Extracts\" Tracer\n\nExtract Tracers Conversations\nDataTool.exe \"C:\\Games\\Overwatch\" extract-conversations \"C:\\Games\\Extracts\" Tracer\n```\n\n#### Extract Unlocks filters\nThe extract unlocks command supports extracting a lot of data and you can filter to specifically what you want.\u003cbr\u003e\nThe command structure looks like: `DataTool.exe \u003coverwatch_directory\u003e extract-unlocks \u003coutput_directory\u003e [filters]`\u003cbr\u003e\nFilters follow the format `{hero name}|{type}={item name}`. You can specify `*` for the hero name or the type for everything.\u003cbr\u003e\nValid types include: skin, icon, spray, victorypose, emote, voiceline\n\n#### Example Filters\n```\n\"*\"                                   // Everything (all heroes skins, sprays, etc) (very slow)\n\"*|skin=*\"                            // All Heroes Skins\n\"Tracer|skin=Overwatch 1\"             // Tracers Overwatch 1 skin\n\"Reaper|spray=*\"                      // Reaper's sprays\n\"Reaper|voiceline=*\"                  // Reapers unlockable voicelines\n```\n\n### Tool Flags\nThere is also a variety of flags you can use that can change how some of the extract commands work.\n```\n--subtitles-with-sounds - Extracts subtitles in txt files next to the audio files (default false)\n--voice-group-by-hero - When extracting voicelines, groups them by the hero (default true)\n--voice-group-by-type - When extracting voicelines, groups them by the type (default true)\n--voice-group-by-skin - When extracting voicelines, groups them by the skin (default false)\n--voice-group-by-locale - When extracting voicelines, groups them by the locale (default false)\n```\n\n## Disclaimer\nThis project is not affiliated with Blizzard Entertainment, Inc.\u003cbr\u003e\nAll trademarks referenced herein are the properties of their respective owners.\u003cbr\u003e\n2025 Blizzard Entertainment, Inc. All rights reserved.\n","funding_links":[],"categories":["Archive-GameReverse","Game \u0026 Studio Tools","Community"],"sub_categories":["Blizzard Entertainment","Github"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovertools%2FOWLib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovertools%2FOWLib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovertools%2FOWLib/lists"}