Skip to content

Apply d4lf patch #627

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
chrizzocb wants to merge 16 commits into
base: main
Choose a base branch
from
Open

Apply d4lf patch #627

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
a09fcee
Apply d4lf patch
chrizzocb Feb 1, 2026
75f7367
Update importer_config.py
chrizzocb Feb 1, 2026
c5fb45b
Apply review fixes (ordering/imports/readme)
chrizzocb Feb 1, 2026
d4429d3
fixed version / Run prek (format/lint)
chrizzocb Feb 1, 2026
209467c
information directly from d4data
chrizzocb Feb 1, 2026
7671fc9
original connection fix
chrizzocb Feb 1, 2026
e362074
import this information directly from d4data
chrizzocb Feb 1, 2026
708ac9f
WIP: sync local changes
chrizzocb Feb 1, 2026
5387046
no separate execution
chrizzocb Feb 1, 2026
1c396d3
README: reorder common issues
chrizzocb Feb 2, 2026
6583d1d
treated Windows as the default runtime
chrizzocb Feb 2, 2026
4764802
no .json, paragon is stored in .yaml file
chrizzocb Feb 2, 2026
3ccbb5e
Refactor paragon overlay to tkinter and align with Cam/ResManager
chrizzocb Feb 2, 2026
539c5bf
update readme.md
chrizzocb Feb 2, 2026
1abe48c
YAML paragon data in overlay + docs and defaults
chrizzocb Feb 3, 2026
4940bdd
Readme fixes +renaming in import profile gui
chrizzocb Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 34 additions & 19 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ feature request or issue reports join the [discord](https://discord.gg/YyzaPhAN6
- Automatically marks all common, magic, and optionally rare gear as junk
- Quickly move items from your stash or inventory
- Supported resolutions are all aspect ratios between 16:10 and 21:9
- Paragon Overlay with optional import from supported build planners (Mobalytics, Maxroll, D4Builds)

## How to Setup

Expand Down Expand Up @@ -47,18 +48,28 @@ feature request or issue reports join the [discord](https://discord.gg/YyzaPhAN6
- Use the hotkeys listed in d4lf.exe to run filtering. By default, F11 will run the loot filter and filter your items.
- For most common issues, if something is wrong, you will see an error or warning when you start d4lf.exe. Join our [discord](https://discord.gg/YyzaPhAN6T) for more help.

### Updating an existing installation
#### Paragon overlay

All configurations are stored in a separate location so all you need to do is download the newest version and delete your old version. This can be done manually by downloading from the [releases page](https://github.com/d4lfteam/d4lf/releases) or by running autoupdater.bat.
D4LF can import Paragon boards from supported build planners and show them in-game using the Paragon overlay.

Your profiles and configuration should continue to work. The only exception to this is if the major version of the release changes. In that case, a change was made that will make previous profiles no longer work.
**How to use**

Example 1: You're on version 5.1.14 and updating to 5.2.0. Your profiles will continue to work fine.
1. Import your build from a supported planner (Mobalytics / Maxroll / D4Builds).
1. Enable **Import Paragon** in the importer (optional). Paragon data will be stored in your profile YAMLs in the profiles folder (default: `~/.d4lf/profiles`).
1. Toggle the Paragon overlay using the hotkey (default **F10**, configurable in *Advanced options*).

Example 2: You're on version 5.1.14 and updating to 6.0.0. Your profiles will no longer work and you'll need to update or re-import them on the newest version.
**Tips**

- Overlays may not work in exclusive fullscreen; use **borderless windowed** if the overlay does not appear.
- Planner websites can change over time. If an import/export stops working, it may need an importer update.

### Common problems

- Paragon overlay does not appear / does nothing
- Ensure Diablo IV is running in **borderless windowed** (exclusive fullscreen may block overlays).
- Ensure your profiles folder contains `*.yaml`/`*.yml` profile files with a top-level `Paragon:` section (default: `C:/Users/<WINDOWS_USER>/.d4lf/profiles`).
- Check/adjust `advanced_options.toggle_paragon_overlay` (default `f10`) and ensure it is not conflicting with other hotkeys.
- If the overlay is off-screen, delete `d4_overlay_config.json` next to `d4lf.exe` to reset its position.
- The GUI crashes immediately upon opening, with no error message given
- This almost always means there is an issue in your params.ini. Delete the file and then open the GUI and configure
your params.ini through the config tab. Using the GUI for configuration will ensure the file is always accurate.
Expand Down Expand Up @@ -90,6 +101,7 @@ The config folder in `C:/Users/<WINDOWS_USER>/.d4lf` contains:
automatically.
- **params.ini**: Different hotkey settings and number of chest stashes that should be looked at. Management of this
file should be done through the GUI in the config window.
- **profiles/\*.yaml**: Profiles including embedded Paragon data for the integrated overlay (top-level `Paragon:`). Generated/updated by the importer when "Import Paragon" is enabled. Default location: `C:/Users/<WINDOWS_USER>/.d4lf/profiles`

### params.ini

Expand Down Expand Up @@ -117,19 +129,21 @@ The config folder in `C:/Users/<WINDOWS_USER>/.d4lf` contains:
| --------- | --------------------------------- |
| inventory | Your hotkey for opening inventory |

| [advanced_options] | Description |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| move_to_inv | Hotkey for moving items from stash to inventory |
| move_to_chest | Hotkey for moving items from inventory to stash |
| run_filter | Hotkey to start/stop filtering items |
| run_filter_force_refresh | Hotkey to start/stop filtering items with a force refresh. All item statuses will be reset |
| run_vision_mode | Hotkey to start/stop vision mode |
| force_refresh_only | Hotkey to reset all item statuses without running a filter after |
| exit_key | Hotkey to exit d4lf.exe |
| log_lvl | Logging level. Can be any of [debug, info, warning, error, critical] |
| process_name | Process name of the D4 app. Defaults to "Diablo IV.exe". In case of using some remote play this might need to be adapted |
| vision_mode_only | If set to true, only the vision mode will be available. All functionality that clicks the screen is disabled. |
| fast_vision_mode_coordinates | If you are using fast vision mode, provide the location on screen where you want the overlay to appear. For example, you could provide (500, 800) |
| [advanced_options] | Description |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| move_to_inv | Hotkey for moving items from stash to inventory |
| move_to_chest | Hotkey for moving items from inventory to stash |
| run_filter | Hotkey to start/stop filtering items |
| run_filter_force_refresh | Hotkey to start/stop filtering items with a force refresh. All item statuses will be reset |
| run_vision_mode | Hotkey to start/stop vision mode |
| force_refresh_only | Hotkey to reset all item statuses without running a filter after |
| exit_key | Hotkey to exit d4lf.exe |
| toggle_paragon_overlay | Hotkey to open/close the Paragon overlay (default: f10) |
| paragon_overlay_source_dir | Folder containing profile YAML files with embedded Paragon data (top-level `Paragon:`) for the overlay. Leave blank to use the default: `~/.d4lf/profiles` |
| log_lvl | Logging level. Can be any of [debug, info, warning, error, critical] |
| process_name | Process name of the D4 app. Defaults to "Diablo IV.exe". In case of using some remote play this might need to be adapted |
| vision_mode_only | If set to true, only the vision mode will be available. All functionality that clicks the screen is disabled. |
| fast_vision_mode_coordinates | If you are using fast vision mode, provide the location on screen where you want the overlay to appear. For example, you could provide (500, 800) |

### GUI

Expand All @@ -143,7 +157,8 @@ automatically picked up and no restart is necessary.

Current functionality:

- Import builds from maxroll/d4builds/mobalytics
- Import builds from maxroll/d4builds/mobalytics (optionally import Paragon data)
- Toggle the integrated Paragon overlay (default hotkey: F10) and configure its JSON folder via "Paragon Folder"
- Complete management of your settings through the config tab
- A beta version of a manual profile editor/creator

Expand Down
212 changes: 212 additions & 0 deletions assets/lang/enUS/paragon_maxroll_ids.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,212 @@
{
"boards": {
"Paragon_Barb_00": "Start",
"Paragon_Barb_01": "Hemorrhage",
"Paragon_Barb_02": "Blood Rage",
"Paragon_Barb_03": "Carnage",
"Paragon_Barb_04": "Decimator",
"Paragon_Barb_05": "Bone Breaker",
"Paragon_Barb_06": "Flawless Technique",
"Paragon_Barb_07": "Warbringer",
"Paragon_Barb_08": "Weapons Master",
"Paragon_Barb_10": "Force of Nature",
"Paragon_Druid_00": "Start",
"Paragon_Druid_01": "Thunderstruck",
"Paragon_Druid_02": "Earthen Devastation",
"Paragon_Druid_03": "Survival Instincts",
"Paragon_Druid_04": "Lust for Carnage",
"Paragon_Druid_05": "Heightened Malice",
"Paragon_Druid_06": "Inner Beast",
"Paragon_Druid_07": "Constricting Tendrils",
"Paragon_Druid_08": "Ancestral Guidance",
"Paragon_Druid_10": "Untamed",
"Paragon_Necro_00": "Start",
"Paragon_Necro_01": "Cult Leader",
"Paragon_Necro_02": "Hulking Monstrosity",
"Paragon_Necro_03": "Flesh-eater",
"Paragon_Necro_04": "Scent of Death",
"Paragon_Necro_05": "Bone Graft",
"Paragon_Necro_06": "Blood Begets Blood",
"Paragon_Necro_07": "Bloodbath",
"Paragon_Necro_08": "Wither",
"Paragon_Necro_10": "Frailty",
"Paragon_Paladin_00": "Start",
"Paragon_Paladin_01": "Castle",
"Paragon_Paladin_02": "Shield Bearer",
"Paragon_Paladin_03": "Fervent",
"Paragon_Paladin_04": "Preacher",
"Paragon_Paladin_05": "Divinity",
"Paragon_Paladin_06": "Relentless",
"Paragon_Paladin_07": "Sentencing",
"Paragon_Paladin_08": "Endure",
"Paragon_Paladin_09": "Beacon",
"Paragon_Rogue_00": "Start",
"Paragon_Rogue_01": "Eldritch Bounty",
"Paragon_Rogue_02": "Tricks of the Trade",
"Paragon_Rogue_03": "Cheap Shot",
"Paragon_Rogue_04": "Deadly Ambush",
"Paragon_Rogue_05": "Leyrana's Instinct",
"Paragon_Rogue_06": "No Witnesses",
"Paragon_Rogue_07": "Exploit Weakness",
"Paragon_Rogue_08": "Cunning Stratagem",
"Paragon_Rogue_10": "Danse Macabre",
"Paragon_Sorc_00": "Start",
"Paragon_Sorc_01": "Searing Heat",
"Paragon_Sorc_02": "Frigid Fate",
"Paragon_Sorc_03": "Static Surge",
"Paragon_Sorc_04": "Elemental Summoner",
"Paragon_Sorc_05": "Burning Instinct",
"Paragon_Sorc_06": "Icefall",
"Paragon_Sorc_07": "Ceaseless Conduit",
"Paragon_Sorc_08": "Enchantment Master",
"Paragon_Sorc_10": "Fundamental Release",
"Paragon_Spirit_0": "Start",
"Paragon_Spirit_01": "In-Fighter",
"Paragon_Spirit_02": "Spiney Skin",
"Paragon_Spirit_03": "Viscous Shield",
"Paragon_Spirit_04": "Bitter Medicine",
"Paragon_Spirit_05": "Revealing",
"Paragon_Spirit_06": "Drive",
"Paragon_Spirit_07": "Convergence",
"Paragon_Spirit_08": "Sapping"
},
"glyphs": {
"Rare_001_Intelligence_Main": "Enchanter",
"Rare_002_Intelligence_Main": "Unleash",
"Rare_003_Intelligence_Main": "Elementalist",
"Rare_004_Intelligence_Main": "Adept",
"Rare_005_Intelligence_Main": "Conjurer",
"Rare_006_Intelligence_Main": "Charged",
"Rare_007_Willpower_Side": "Torch",
"Rare_008_Willpower_Side": "Pyromaniac",
"Rare_009_Willpower_Side": "Cryopathy",
"Rare_010_Dexterity_Main": "Tactician",
"Rare_011_Intelligence_Side": "Guzzler",
"Rare_011_Willpower_Side": "Imbiber",
"Rare_012_Intelligence_Side": "Protector",
"Rare_012_Willpower_Side": "Reinforced",
"Rare_013_Dexterity_Side": "Poise",
"Rare_014_Dexterity_Side": "Territorial",
"Rare_014_Strength_Main": "Turf",
"Rare_014_Strength_Side": "Turf",
"Rare_015_Dexterity_Side": "Flamefeeder",
"Rare_016_Dexterity_Side": "Exploit",
"Rare_016_Intelligence_Side": "Exploit",
"Rare_016_Strength_Side": "Exploit",
"Rare_017_Dexterity_Side": "Winter",
"Rare_018_Dexterity_Side": "Electrocute",
"Rare_019_Dexterity_Side": "Destruction",
"Rare_020_Dexterity_Side": "Control",
"Rare_020_Intelligence_Main": "Control",
"Rare_020_Intelligence_Side": "Control",
"Rare_021_Strength_Main": "Ambidextrous",
"Rare_022_Strength_Main": "Might",
"Rare_023_Strength_Main": "Cleaver",
"Rare_024_Strength_Main": "Seething",
"Rare_025_Strength_Main": "Crusher",
"Rare_026_Strength_Main": "Executioner",
"Rare_027_Strength_Main": "Ire",
"Rare_028_Strength_Main": "Marshal",
"Rare_029_Dexterity_Side": "Bloodfeeder",
"Rare_030_Dexterity_Side": "Wrath",
"Rare_031_Dexterity_Side": "Weapon Master",
"Rare_032_Dexterity_Side": "Mortal Draw",
"Rare_033_Intelligence_Side": "Revenge",
"Rare_033_Willpower_Side": "Revenge",
"Rare_033_Willpower_Side_Necro": "Revenge",
"Rare_034_Intelligence_Side": "Undaunted",
"Rare_034_Willpower_Side": "Undaunted",
"Rare_035_Intelligence_Side": "Dominate",
"Rare_035_Willpower_Side": "Dominate",
"Rare_035_Willpower_Side_Necro": "Dominate",
"Rare_036_Willpower_Side": "Disembowel",
"Rare_037_Willpower_Side": "Brawl",
"Rare_038_Intelligence_Main": "Corporeal",
"Rare_039_Willpower_Main": "Fang and Claw",
"Rare_040_Willpower_Main": "Earth and Sky",
"Rare_041_Intelligence_Side": "Wilds",
"Rare_042_Willpower_Main": "Werebear",
"Rare_043_Willpower_Main": "Werewolf",
"Rare_044_Willpower_Main": "Human",
"Rare_045_Intelligence_Side": "Bane",
"Rare_045_Strength_Side": "Bane",
"Rare_046_Dexterity_Side": "Abyssal",
"Rare_046_Intelligence_Side": "Keeper",
"Rare_047_Dexterity_Side": "Fulminate",
"Rare_047_Intelligence_Side": "Fulminate",
"Rare_048_Dexterity_Side": "Tracker",
"Rare_048_Intelligence_Side": "Tracker",
"Rare_049_Dexterity_Side": "Outmatch",
"Rare_049_Strength_Main": "Outmatch",
"Rare_049_Strength_Side": "Outmatch",
"Rare_050_Dexterity_Main": "Spirit",
"Rare_050_Dexterity_Side": "Spirit",
"Rare_050_Willpower_Side": "Spirit",
"Rare_051_Dexterity_Side": "Shapeshifter",
"Rare_052_Dexterity_Main": "Versatility",
"Rare_053_Dexterity_Main": "Closer",
"Rare_054_Dexterity_Main": "Ranger",
"Rare_055_Dexterity_Main": "Chip",
"Rare_055_Dexterity_Side": "Chip",
"Rare_055_Willpower_Side": "Chip",
"Rare_056_Dexterity_Main": "Frostfeeder",
"Rare_057_Dexterity_Main": "Fluidity",
"Rare_058_Intelligence_Side": "Infusion",
"Rare_059_Dexterity_Main": "Devious",
"Rare_060_Dexterity_Side": "Warrior",
"Rare_061_Intelligence_Side": "Combat",
"Rare_062_Dexterity_Side": "Gravekeeper",
"Rare_063_Intelligence_Side": "Canny",
"Rare_064_Intelligence_Side": "Efficacy",
"Rare_065_Intelligence_Side": "Snare",
"Rare_066_Dexterity_Side": "Essence",
"Rare_067_Strength_Side": "Pride",
"Rare_068_Strength_Side": "Ambush",
"Rare_069_Intelligence_Main": "Sacrificial",
"Rare_070_Intelligence_Main": "Blood-drinker",
"Rare_071_Intelligence_Main": "Deadraiser",
"Rare_072_Intelligence_Main": "Mage",
"Rare_073_Intelligence_Main": "Amplify",
"Rare_074_Willpower_Side": "Golem",
"Rare_075_Willpower_Side": "Scourge",
"Rare_076_Strength_Main": "Diminish",
"Rare_076_Strength_Side": "Diminish",
"Rare_077_Willpower_Side": "Warding",
"Rare_078_Willpower_Side": "Darkness",
"Rare_079_Dexterity_Side": "Exploit",
"Rare_080_Strength_Main": "Twister",
"Rare_081_Strength_Main": "Rumble",
"Rare_082_Dexterity_Main": "Explosive",
"Rare_083_Intelligence_Side": "Nightstalker",
"Rare_084_Intelligence_Main": "Stalagmite",
"Rare_085_Dexterity_Side": "Invocation",
"Rare_086_Dexterity_Side": "Tectonic",
"Rare_087_Willpower_Main": "Electrocution",
"Rare_088_Intelligence_Main": "Exhumation",
"Rare_089_Willpower_Side": "Desecration",
"Rare_090_Dexterity_Main": "Menagerist",
"Rare_091_Strength_Side": "Hone",
"Rare_092_Intelligence_Side": "Consumption",
"Rare_093_Dexterity_Main": "Fitness",
"Rare_094_Intelligence_Side": "Ritual",
"Rare_095_Dexterity_Main": "Jagged Plume",
"Rare_096_Strength_Side": "Innate",
"Rare_097_Dexterity_Main": "Wildfire",
"Rare_098_Strength_Side": "Colossal",
"Rare_100_Dexterity_Main": "Talon",
"Rare_101_Strength_Side": "Hubris",
"Rare_102_Dexterity_Main": "Fester",
"Rare_103_Strength_Main": "Sentinel",
"Rare_104_Dexterity_Side": "Honed",
"Rare_105_Strength_Main": "Law",
"Rare_106_Willpower_Side": "Arbiter ",
"Rare_107_Strength_Main": "Resplendence",
"Rare_108_Intelligence_Side": "Judicator",
"Rare_109_Dexterity_Side": "Feverous",
"Rare_110_Strength_Main": "Apostle",
"Rare_Dex_Generic": "Headhunter",
"Rare_Int_Generic": "Eliminator",
"Rare_Str_Generic": "Challenger",
"Rare_Will_Generic": "Headhunter"
}
}
Loading