Skip to content

README_EN.md

Latest commit

 

History

History
106 lines (75 loc) · 3.87 KB

README_EN.md

File metadata and controls

106 lines (75 loc) · 3.87 KB
Raw

简体中文 · English

OWLib DataTool GUI

An unofficial Windows GUI launcher for OWLib DataTool. It reads the commands supported by DataTool and candidate data from the installed game, allowing tasks, resource targets, and options to be selected without manually writing command lines.

This project is not an official OWLib component and is not affiliated with overtools, Blizzard Entertainment, or Microsoft.

OWLib DataTool GUI English interface

Features

  • Automatically discovers public commands supported by DataTool
  • Groups commands into data, hero, audio, and map-related categories
  • Loads heroes, maps, skins, and other resource choices from actual game data
  • Provides drop-down target selection and removable tags for multiple tasks
  • Shows only the query and advanced options supported by the selected command
  • Instant Chinese / English interface switching with a persisted preference
  • Configurable text language, speech language, and server data source
  • Live command preview and DataTool execution log
  • JSON output for query commands
  • Web UI resources embedded in a single executable

Requirements

  • Windows 10 or Windows 11 (x64)
  • Microsoft Edge WebView2 Runtime
  • An installed copy of Overwatch
  • OWLib DataTool

The release executable is self-contained and does not require a separate .NET Desktop Runtime installation.

Installation

  1. Obtain the OWLib DataTool toolchain.
  2. Download OWLibGUI-v0.15.1-win-x64.exe from Releases.
  3. Rename it to OWLibGUI.exe and place it next to DataTool.exe.
  4. Run OWLibGUI.exe, then select the game and output folders.

Recommended directory layout:

toolchain-release/
├─ DataTool.exe
├─ OWLibGUI.exe
└─ other DataTool files

DataTool itself is not distributed in this repository or in the OWLibGUI release.

Usage

  1. Select a command category and command.
  2. Click Load list for commands that support candidate data.
  3. Select a hero, map, or other resource and click Add.
  4. Enable advanced options when needed.
  5. Review the complete command in Command preview.
  6. Click Run.

Selecting All (*) may create a large number of files and take a long time. Make sure the output drive has sufficient free space.

Building from source

.NET 10 SDK and a Windows x64 environment are required.

dotnet restore OWLibGUI/OWLibGUI.csproj
dotnet build OWLibGUI/OWLibGUI.csproj -c Release

Publish a self-contained single-file build:

dotnet publish OWLibGUI/OWLibGUI.csproj `
  -c Release `
  -r win-x64 `
  --self-contained true `
  -p:PublishSingleFile=true `
  -p:IncludeNativeLibrariesForSelfExtract=true

Run the command discovery tests:

dotnet run --project OWLibGUI.SmokeTests/OWLibGUI.SmokeTests.csproj -- "C:\path\to\DataTool.exe"

Repository layout

OWLibGUI/                 Main application, WPF host, and embedded Web UI
OWLibGUI.SmokeTests/      Command, category, localization, and option tests
docs/images/              Chinese and English screenshots

Upstream project and disclaimer

OWLibGUI is only a third-party front end for DataTool. It does not change DataTool's game-data processing. Available features, output formats, and compatibility depend on the installed DataTool version.

This project is not affiliated with Blizzard Entertainment, Inc. Overwatch, Blizzard, and all related names and trademarks belong to their respective owners. Use this tool only in accordance with applicable law, software licenses, and game service terms.

License

This project is released under the MIT License. OWLib/DataTool is a separate upstream project and remains under its authors' license and copyright.