DOCSEARCHbyAlgolia
Submit Docs

Diablo IV Companion

repository·master·Indexed 43 days ago

https://github.com/josdemmers/diablo4companion

An in-game overlay application for Diablo IV that assists players with gear optimization, loot filtering, and build management. It features support for importing builds from D2Core, D4Builds, InfinityBuilds, Maxroll, and Mobalytics, as well as paragon board visualization, trade value tracking, and customizable system presets for various screen resolutions and HDR/SDR modes.

Tokens
5.8K
Snippets
3
Records
15
Agent score
52%

What's inside Diablo IV Companion

  1. Overview of Diablo IV Companion Features

    master

    Diablo IV Companion is an in-game overlay designed to help players optimize gear and builds. Key features include:

    • Loot Filter: Filters items based on affixes, aspects, runes, sigils, affix value, and item power.
    • Tuning Prism Hints: Displays matching tuning prisms for specific affixes.
    • Trading Lists: Tracks valuable items and displays their trade value in-game.
    • Build Import: Supports importing builds from:
      • D2Core.com
      • D4Builds.gg
      • InfinityBuilds.gg
      • Maxroll.gg
      • Mobalytics.gg
    • Paragon Overlay: Visualizes paragon boards.
    • Multi-language Support: Supports multiple languages (see wiki for translation instructions).

  3. Key Features of Diablo IV Companion

    master

    The application includes the following capabilities:

    • Loot Filtering: Supports filtering by affixes, aspects, runes, and sigils. Users can filter by affix value and item power.
    • Trade Lists: Tracks valuable items and displays their trade value within the game.
    • Build Importing: Supports importing builds from:
      • D4Builds.gg
      • Maxroll.gg
      • Mobalytics.gg
    • Paragon Overlay: Allows importing Paragon boards (refer to the wiki for usage).
    • Multilingual Support: The application supports multiple languages.

  4. Use the Diablo IV Companion interface

    master

    The application features a navigation menu with several functional areas:

    Affixes, Trade, and Registration

    • Affixes (Afijos): Manage and filter affixes, aspects, sigils, uniques, and runes. You can create, select, or delete affix presets. Use the import/export buttons to share builds or import builds from D4Builds, Maxroll, and Mobalytics.
    • Trade (Comercio): Access trade-related features.
    • Registration (Registro): Manage user registration.

    Overlay and Customization

    • Overlay: Toggle the in-game overlay on or off. This can be done via the navigation menu or the button located in the top-left corner within the game.
    • Language: Change the language used for affixes.
    • Presets: Create and manage affix presets. You can add specific affixes to a preset to control them while playing.

  5. Install and Set Up Diablo IV Companion

    master

    Follow these steps to install and configure the application:

    1. Download: Get the latest version from the Releases page.
    2. Run: Extract the downloaded files and execute D4Companion.exe.
    3. System Preset: Go to settings and select a Preajuste del sistema (System Preset) that matches your screen resolution.
      • Note: Ensure you click the update/download button to get the latest version.
      • Use the recommended settings for your specific resolution.
    4. Affix Configuration:
      • Go to Afijos (Affixes).
      • Create a new Preajuste de Afijos en Equipamiento (Equipment Affix Preset).
      • Alternatively, import a build from D4Builds, Maxroll, or Mobalytics.
      • Select your preferred affixes for each item slot. Double-click an affix to add or remove it from the list.

  6. Use the Diablo IV Companion overlay and presets

    master

    The Diablo IV Companion provides an overlay to monitor gear affixes, aspects, sigils, uniques, and runes in-game.

    Managing Affix Presets

    • Navigation: Use the menu to access Affixes, Trade, Logging, Debug, and Settings.
    • Presets: Create, select, or delete affix presets. You can import builds from external sources like D4Builds, Maxroll, and Mobalitics using the import buttons.
    • Monitoring: Select an affix to add it to your current preset. Once added, you can view an overview of selected affixes for each gear slot. You can click an affix to change its color or double-click the name to remove it.
    • Filtering: Use the filter feature to narrow down affixes.
    • Switching Types: Toggle between viewing affixes, aspects, sigils, uniques, and runes.

    Configuring System Presets

    To ensure the overlay works correctly with your screen, you must select a preset matching your resolution:

    1. Select Resolution: Choose the preset that matches your monitor resolution.
    2. Download Manager: Use the download manager to acquire community-created system presets.
    3. Custom Presets: If you need a specific configuration not provided, refer to the wiki to create your own.

  7. Install Diablo IV Companion

    master

    Follow these steps to set up the application:

    1. Download the latest version from the GitHub Releases page.
    2. Extract the downloaded files and run D4Companion.exe.
    3. Open Settings and select a System preset that matches your monitor's resolution (e.g., use 1440p_SMF for a 2560x1440 or 3440x1440 monitor).
      • Important: Click the update/download button first to ensure you have the latest version.
      • Use the recommended app settings provided for your specific resolution.
    4. Navigate to Affixes and create a new Gear Affix Preset, or import an existing build from supported sites like D2Core, D4Builds, InfinityBuilds, Maxroll, or Mobalytics.
    # Run the application after extraction
./D4Companion.exe

  8. Configure Debug and System settings

    master

    The Debug (Debug) and Configuration (Configuración) menus allow for fine-tuning the application's behavior:

    Debugging

    • Debug Info: Toggle debug information visibility.
    • Image Comparison: Use similarity thresholds to compare images (a lower value requires a closer match; the recommended default is 0.05).
    • Navigation: Cycle through previous or next debug images.
    • Screenshots: Capture a screenshot for debugging purposes.

    System and Display Configuration

    • Window Mode: Set the application as a 'topmost' window.
    • Tooltip Width: Set the width of the information tooltips. The default for 1440p is 500.
    • Blur Filtering: Adjust thresholds for filtering blurry images. The default for SDR is 70/255.
    • OCR Accuracy: Set the minimum acceptable match for text converted via OCR (default is 80%).
    • Area Offsets: Adjust offsets for affix/aspect descriptions. These are typically managed via system presets.

  9. Manage Gear Affix Presets

    master

    To use the loot filter, you must define what affixes you are looking for:

    1. Go to the Affixes section in the app.
    2. Create a new Gear Affix Preset or import one from a supported build site.
    3. For each item slot, select your preferred affixes.
    4. Interaction: Double-click an affix to add it to or remove it from your current list.

  10. Manage System Presets and Downloads

    master

    To ensure the application works correctly with your specific monitor setup, use the System Presets feature:

    1. Select a Preset: Choose the preset that matches your screen resolution.
    2. Download Community Presets: Use the download manager to acquire system presets created by the community.
    3. Automatic Application: When you download or select a system preset, recommended settings for resolution (like tooltip width, blur thresholds, and area offsets) are applied automatically.

    For instructions on creating your own custom preset, refer to the wiki.

  11. Configure Debug and OCR settings

    master

    The Debug menu allows for fine-tuning the OCR (Optical Character Recognition) and image matching behavior used to read in-game data.

    Key Debug Settings

    • Tooltip Dimensions: Set the width of the tooltip (default for 1440p is 500). The height setting limits the item type area of the tooltip.
    • Thresholds:
      • Background Noise: Set thresholds for filtering out noise. Default for SDR is (70/255).
      • OCR Match: Set the minimum acceptable match for OCR converted text (default is 80%).
      • Image Similarity: Set similarity thresholds for matching images. A lower value requires a closer match (default 0.05 is recommended).
    • Area Offsets: Adjust offsets for affixes/aspects descriptions. It is recommended to use settings provided by your specific resolution preset.
    • Window Management: Toggle debug information or set the application as the top-most window.
    • Debugging Tools: Use the screenshot tool, reload the active system preset, or navigate through previous/next debug images.

  12. Configure System Presets for Resolution and HDR

    master

    The application uses System presets to configure the overlay based on your screen resolution and display mode (SDR vs HDR).

    • Resolution Mapping: Presets are designed for both standard and widescreen resolutions. For example, both 2560x1440 and 3440x1440 should use the 1440p presets.
    • Display Mode: Choose between SDR (Standard Dynamic Range) or HDR (High Dynamic Range) presets.
    • Font Size: Presets are categorized by font size: SMF (Medium) or SSF (Small).

    If your specific configuration is not available, you can learn how to create a new System Preset via the wiki.