(New Feature) Paragon board overlay, including updates to all importers to import the paragon board#627
Merged
cjshrader merged 37 commits intod4lfteam:mainfrom Feb 16, 2026
Merged
Conversation
Fix ImportConfig defaults (CI)
cjshrader
requested changes
Feb 1, 2026
Contributor
cjshrader
left a comment
cjshrader
left a comment
There was a problem hiding this comment.
Thank you so much for your work here, this is a good start and will be a cool feature.
Beyond the comments I've left, can you also make sure you've run prek and resolved any issues it might report?
https://github.com/d4lfteam/d4lf/blob/main/README.md#formatting--linting
Ran prek locally (uv run prek run -a) and pushed the resulting formatting/lint fixes. CI should now be clean.
cjshrader
requested changes
Feb 1, 2026
I updated the overlay to load Paragon data from the current profiles/*.yaml format (top-level Paragon written by paragon_export.py), while keeping legacy .json support for older exports. Also updated the default source directory and README references from ~/.d4lf/paragon/*.json to ~/.d4lf/profiles/*.yaml to match the new workflow
Update importer checkbox label and description Align README wording with new Paragon workflow
cjshrader
changed the title
cjshrader
requested changes
Feb 7, 2026
Tried to fix everything. take a look at it.
cjshrader
requested changes
Feb 8, 2026
…_plus_paragon_overlay into feature/d4lfpatch
Readme changes
see latest discord message
last fix.
Reverted the drop_item method to the previous funcitonality, which seems to work fine
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Release notes — Paragon Import/Export + Integrated Paragon Overlay
This patch adds full Paragon JSON export to D4LF’s build importers and integrates a Paragon overlay directly into D4LF (no separate overlay executable needed). It also improves naming consistency across sources and restores live file logging.
What’s new
Paragon Import / Export (to overlay-compatible JSON)
Export boards with rotation (0/90/180/270), glyph slug (if present), and a 21×21 node map (441 nodes) per board.
Export location defaults to ~/.d4lf/paragon (or your configured user dir).
Integrated Paragon overlay
Overlay module is now shipped inside D4LF and can be launched as a dedicated mode of the same app.
Multi-JSON folder loading
Overlay can load a single JSON file or a folder containing multiple *.json builds, with a build selector.
Configurable global hotkey toggle
New hotkey setting to start/stop the overlay (default F10).
CLI support
d4lf.exe --paragon-overlay ""
Importer improvements
Mobalytics: exports stable, “friendly slug” names.
Maxroll: exports friendly slugs instead of internal IDs and fixes missing helper references that could crash export.
D4Builds: fixes Paragon navigation logic and improves board naming; adds class-prefixed slugs for consistency.
Fixes
Live logfile writing restored
Fixes a regression where D4LF stopped updating live logs under d4lf/logs by preserving the file handler during GUI initialization.
Overlay reliability
Startup stability improvements and easier diagnostics via overlay-side logging.
Adds a practical recovery for “off-screen” overlay placement (delete d4_overlay_config.json next to d4lf.exe to reset).
New / used configuration keys
advanced_options.toggle_paragon_overlay (default: F10)
advanced_options.paragon_overlay_source_dir (set via the “Paragon Folder” button; defaults to ~/.d4lf/paragon)
Notes / limitations
Overlays typically won’t render over exclusive fullscreen; use borderless windowed in Diablo IV.
Website DOM changes can break scrapers (importers may need selector updates over time).