D2RUO Official Docs

🛡️ Diablo 2: Resurrected Utility Overlay (DUO)

A multi-purpose utility overlay (DUO) designed to comprehensively enhance your Diablo 2: Resurrected gameplay. In addition to real-time tracking for the upcoming Terror Zone and Diablo Clone progression across servers, it provides various quality-of-life utilities, such as a highly customizable Buff Skill Timer and an In-game Item Search Dictionary, directly on your game screen.

📢 Notice: As the number of features continues to grow, testing each one takes a considerable amount of time. Therefore, please be understanding if you encounter any minor bugs. Since I also actively use this program for my own gameplay, I will make sure to fix any discovered errors as quickly as possible! 👉 Go to Feedback & Support

📸 Screenshots

1. Next Terror Zone & DClone Progress

Terror Zone Screen Diablo Clone Screen

2. Buff Overlay & Profile Management

Buff Overlay Screen Buff Profile Settings Screen

Capture any skill icon directly from the game screen to set up and manage your own buff durations. Group your skills by profile for different characters or builds using the intuitive settings UI.

3. Real-time Item Search Dictionary

Item Search Screen

Instantly search for Unique/Runeword items, base materials, aliases, and check their market value on Traderie without tabbing out of the game.

4. Speedrun Timer

Speedrun Timer Screen

Intuitively compare and record how much your clear time has improved after changing your equipment or builds.

🚀 Getting Started

1. Download & Preparation

Go to the 👉 Latest Release Page (Click), download the installer (DUO_Setup.exe), and run it.

💡 Notice on Distribution Change: To significantly reduce frequent antivirus false positives caused by the previous .zip extraction method, the app is now distributed as a standard installer. (Easy Explanation: The previous method extracted files silently to a temporary folder upon execution, which antiviruses often suspect as malware behavior. By properly installing the app to a standard directory, it is much more likely to be recognized as a safe and legitimate program.)
- Default Installation Path: %LocalAppData%\Programs\D2R Utility Overlay (You can copy & paste this into your file explorer address bar)
Sign up/Login to d2tz.info and copy your API Key (Token) from the User Profile page.

💡 How to keep your settings when updating:

Auto-Update (Recommended): Simply click the ⚡ Auto-Update button on the overlay when a new version is detected. It will safely download and install the update in the background while preserving all your custom settings and profiles.

Manual Update: If you download the new .exe installer manually, simply run it. It will safely overwrite the files while preserving your old d2_overlay_config.json and profiles.

Auto-Update button display screen

💡 When a new version is detected, the ⚡ Auto-Update button appears at the top of the screen.

2. Run & Configure

Run Diablo 2: Resurrected. (Fullscreen Mode recommended).
Run the D2R Utility Overlay shortcut created on your Desktop or Start Menu. (Run as administrator if your D2R client is also running as admin).
Press Ctrl + Shift + S or right-click the system tray icon to open the ⚙️ Settings window.
Paste your API Key (Token) into the settings and customize layouts, hotkeys, and features.

⌨️ Hotkeys

Category	Hotkey	Function
Global	`Ctrl` + `Shift` + `S`	Open Settings Instantly
Item Search	`Ctrl` + `F`	Open Item Search Window
	`Tab`	(In Search) Toggle Unique / Runeword Tabs
	`↑` / `↓`	(In Search) Navigate Search Results
	`ESC`	Close Search Window
Item Recognition	`Ctrl` + `R`	Drag scan item area manually
	`Ctrl` + `T`	⚡ Auto-detect item tooltip box
Buff Overlay	`PageUp` / `PageDown`	Switch Buff Profiles
	User Defined Keys	Trigger Specific Buff Timer
Speedrun Timer	`Home`	Start / Pause Timer
	`End`	Record Complete (Save Lap Time)
	`Shift` + `Del`	Reset All Records & Stats

✨ Key Features

1. Real-time TZ & DClone Tracker

Custom Favorite Alerts: Get text blinks and sound notifications when your favorite zones are discovered and 5 mins before they start.
Uber Alerts: Choose your expansion (LoD/RotW) and get notified when DClone stages increase.
Smart Polling: Highly optimized API calls to prevent traffic waste.

2. In-game Item Search Dictionary

Powerful & Flexible Search Engine: Search quickly and accurately by English/Korean names, base items, required runes, or well-known aliases. You can use spaces to combine these keywords to find exactly what you’re looking for.
✨ Auto Recognition (OCR) & Custom Settings: Supports two scanning methods to automatically scan and fill in the variable stats of in-game items. (Windows 11 only) You can configure the following additional settings at the bottom of the item search window:
- Drag Scan: Use a hotkey (default Ctrl + R) to manually select an area.
- Auto Box Scan: Use a hotkey (default Ctrl + T) to auto-detect the item tooltip box.
- Hotkey Change: Easily change the default capture hotkeys to any key combinations you prefer.
- Stat Fill Mode Selection: Choose exactly how the scanned numbers are applied (min only, max only, min + max, and even percentage adjustments).
(Easy Explanation: You no longer need to manually type item stats. Just press the hotkey, and the program will read the screen to automatically fill in the values for your Traderie search. You can also fine-tune it to input only minimum or maximum values as needed.)
Seamless Traderie Integration & Custom Favorites: Click the button to instantly open the item’s market value page in your browser. Save customized variable stats to your ‘Favorites’ for quick live price checks.
Advanced Favorites Management: You can right-click a favorite item to rename or duplicate it. Also, you can modify the stats of an already registered favorite and click the [💾 Save Opts] button to update the data.
Ultimate Convenience: Instantly copy item details to your clipboard. The search window automatically becomes semi-transparent when it loses focus.

3. Powerful Buff Overlay

Profile & Skill Management: Create, duplicate, and manage multiple buff profiles. Register new skills effortlessly using the built-in screen capture tool.
Smart Buff Clear Ignore: Prevent accidental buff timer resets by registering keys like your inventory hotkey as ‘Ignore if Prev Key’.
Highly Customizable UI: Adjust icon sizes, timer and hotkey text sizes/positions, and time display formats (seconds or MM:SS) to suit your preferences.
Custom Alerts: Assign custom audio files (.wav, .mp3) to individual skills, and configure specific volumes and flash alert thresholds.

4. Speedrun Timer

Record Comparison: Optimized for measuring clear time variations due to equipment swaps or build changes. It intuitively displays the time difference from the previous run.
Real-time Statistics: Provides a clean, fixed-size UI that displays your current elapsed time alongside runs, average clear time, and your best record.

5. UI & Convenience

Click-through: Mouse clicks pass right through the overlay.
Auto-Hide: Automatically hides when switching to another app. Fully supports multi-client setups.
Free Layout: Drag and drop panels anywhere. Vertical modes are also supported.
Auto-Update: seamless background updates with a 1-click update button.

💡 Custom Tips

Open Install Folder: Right-click the DUO icon in the system tray (bottom right) and select 📂 Open Install Folder to instantly access the directory. Use this convenient feature for the customizations below!
Custom Fonts: Place your font files inside the fonts folder located in the install folder, and they will be available for selection in the settings.
Custom Alert Sounds: Place your desired audio files (.wav, .mp3) inside the sounds folder to use them as custom alerts.
Profile Sharing & Backup: Copy the profiles folder within the install directory to easily back up your custom buff profiles or share them with others.

📂 File & Folder Descriptions

Structure inside your installation directory (C:\Users\<YourUsername>\AppData\Local\Programs\D2R Utility Overlay):

File / Folder	Description
`DUO.exe`	Main executable file.
`act_map.json`	⚠️ Essential TZ area level and Act data (Do not delete).
`area.json`	⚠️ Essential TZ translation data (Do not delete).
`d2_overlay_config.json`	Auto-saved user preferences.
`profiles/`	Folder containing your captured buff icons and `skills.json`.
`sounds/`	Place your custom `.mp3` or `.wav` files here for buff alerts.
`item/data/`	Database files used for the item search dictionary.
`fonts/`	Default built-in fonts. You can add your own font files here.
`models/`	Folder where modules required for automatic item recognition are stored.

⚖️ Open Source License Notice:

This program dynamically links PySide6, which is licensed under LGPLv3.

This program uses Tesseract OCR and pytesseract for text recognition on the game screen, which are licensed under the Apache License 2.0.

💻 Tested Environment & Troubleshooting

OS: Windows 11 Pro 25H2 (64-bit)
Display: 2560x1440 (QHD)
Game: Diablo 2: Resurrected (Recommended: Fullscreen Mode)
Build: Python 3.12 (PySide6)

🛡️ Security & False Positives (Antivirus Blocks/Deletions) This program uses the keyboard module to detect your in-game hotkeys. Although switching to a standard installer (.exe) distribution significantly reduces false positives, some antivirus software may still incorrectly flag and block its execution. (Easy Explanation: Intercepting keyboard input is a method frequently used by malicious programs, so it is a natural phenomenon for antivirus software to be suspicious and block it by default.)

If the program won’t run or the shortcut does not work, please try the following steps:

Add to Exclusions (Recommended): Add the installation folder (C:\Users\<YourUsername>\AppData\Local\Programs\D2R Utility Overlay) to your antivirus exclusion/exception list.
Keep the Default Path: Installing the program in the default AppData\Local directory helps reduce false positives, as it is a standard system directory for application data. It is recommended not to change this path.
Disable Smart App Control: If you are using Windows 11, you may need to turn off Smart App Control if it blocks execution.
Star the GitHub Repo: Leaving a Star ⭐ on this GitHub repository helps build the software’s reputation metric over time, which may help reduce false positives from reputation-based filters.

☕ Contact & Support

💡 Bug Reports & Feature Requests (Feedback)

If you encounter any bugs or have ideas for new features, please feel free to let me know using the methods below!

GitHub Issues (Recommended): Please leave a post on the GitHub Issues page (Click).
Email: You can always send an email to miabohoja1@gmail.com.

☕ Support (Donation)

This program is 100% free to use for everyone! However, if you found this tool helpful for your gameplay and wish to support its ongoing development, you can optionally buy the developer a coffee. Your support is always greatly appreciated!

👉 Buy me a coffee via PayPal (For non-Korean users)

Credits: Data provided by D2TZ.info