Leveling Tracker - Lailloken/Exile-UI-Legacy GitHub Wiki

tracks your campaign-progress and dynamically overlays leveling-guides generated via exile-leveling created by HeartofPhos onto the game-client

highlights gems and items from the build-guide in the vendor-window with a single hotkey-press

generates search-strings to quickly bulk-buy every gem in the build-guide from vendors (primarily for twink-leveling)

optional: tracks your level and notifies you when gems from the guide or manually-added items are ready to be equipped (primarily designed for twink-leveling)

optional: import screenshots of your PoB skilltree to access and overlay them on-demand while playing

optional: a timer can be set up to record your act and total campaign time which will also be logged in a CSV-file for statistical analysis

main UI-elements:

• toggle button that can be placed anywhere within the client-window by dragging

• text-panel displaying the guide that can be placed at the top or bottom edge of the screen via the settings menu

• gear-tracker panel at the bottom edge of the screen

general inputs:

• clicking the tracker button will show/hide the guide overlay

• right-clicking the tracker button will show/hide the gear tracker

• holding TAB when a step in the guide is tagged with [img] will display an illustration of what is described

• optional holding the omni-key while the skilltree is open will display the overlay with PoB-skilltree screenshots

this feature has its own section in the settings menu, with UI and sub-feature settings

• this is also where guides are imported

open the LLK-UI settings menu (by clicking the LLK-UI panel or typing .llk into chat) and click leveling tracker

after enabling the feature by checking the box, the toggle button will appear at the bottom edge of the screen

• this button can be resized in the settings menu and re-positioned by dragging

• left-clicking the button will toggle the guide-overlay

• right-clicking the button will toggle the gear tracker

UI settings can be changed once a guide has been imported

open exile-leveling

if you want to import a PoB-build with gems, click 'build' at the top of the UI and paste the code

when you're done, click the menu button and '3rd-party export'

tab into the game, open the LLK-UI settings menu, go to leveling tracker, and click 'import guide'

after successfully importing a guide, you can left-click the toggle-button to hide/show the overlay:

• its UI settings (font size/color, opacity) can be changed in the settings menu while it's on screen

it will show at the bottom edge of the screen by default but can also be set to show at the top

it does not block clicks (except for the '<<' and '>>' buttons which are used to go to the previous/next page)

most of the time, it will show multiple steps of the guide and refer to a specific location in the last line

• once you enter that specific location the overlay will switch to the next page and show the following steps

• the whole campaign can be played without having to interact with the overlay manually (unless you want to skip certain steps, or have to go back a few steps because you accidentally triggered a switch too early)

important note: tracking is only active while the overlay is on screen, so it needs to be up permanently (otherwise you'll have to do some manual catching up)

if a step includes buying gems or items from vendors, you can long-press the omni-key while the vendor-window is open to highlight them

this feature needs to be enabled in the settings menu

once enabled, the buttons underneath the guide-overlay will include two timers

• the left timer represents the current act time, the right one the time of the total run

• the buttons can still be used to go forward/backward, and right-clicking them will pause the timer (represented by a gray background)
  

how to set it up / start a run

• you need to click "reset progress" in the settings menu in order to return to the first step of the guide

• right-clicking a button while being in the Twilight Strand will start the timers from 00:00

there's basic CSV-logging to a "campaign runs.csv" file in the main folder of the script

• times are added as you complete acts

• having the file open in the background may make it read-only, preventing the script from adding any more act times

the timer runs independently of the guide or its progress, and instead uses your current location to transition between acts

the timer only runs while the guide-overlay is on screen

the timer stops while in hideout (for trades, etc.), but it does NOT enter pause-mode as above, i.e. it will automatically continue without user-input upon leaving the hideout

the timer stops while neither the PoE client nor an LLK-UI window/overlay are focused, i.e. while you're alt-tabbed

starting a new session / restarting the script will put the timer into pause-mode, requiring you to right-click a button whenever you wish to continue

the timer sees a run as completed upon entering the Karui Shores: the buttons will turn green and the timers will stop

this is mainly designed around twink-leveling but can be used in different ways

you can add items to this UI, and it will notify you once you have reached their level requirements

importing a build via exile-leveling will automatically add all gems in that build to the tracker, so you don't have to do it manually

this can be used without importing a guide/PoB-build beforehand

right-click the toggle-button to show/hide the gear-tracker panel:

this panel will always be positioned at the bottom-edge of the client-window

while this panel is open, a small black square is visible somewhere around where the flashing skill-point button is (might differ from resolution to resolution, especially UltraWide, but it's somewhere in the bottom-left in the client-window):

• this panel shows the number of items that can now be equipped

• in this state, this square can be repositioned by dragging (I would recommend putting it somewhere on top of the skill-point button because you look at it so regularly while leveling)

• once the gear-tracker panel is closed, this small one will switch to only showing the number and being unclickable:

  

the drop-down list contains the most recent characters found in the client-log; select the one you're going to play

• characters have to be at least level 2 to appear in this list

while the gear tracker is open, omni-clicking items (default: middle mouse-button) will add them to the tracker

• it may need additional work regarding which items to accept, so please provide feedback

by default, the tracker will only show items up to 5 levels above your character's level in order to not be too cluttered

• equippable items will be highlighted in green

• left-click items to highlight them in game (for vendors or stash)

• right-click items to remove them from the tracker

• click the 'select character' label to highlight all green items (may not work correctly if too many items are green)

the tracker can be closed by pressing ESC

unlike the leveling-guide overlay, this panel is not meant to be on screen all the time (only open it if the indicator shows that gear is ready)

importing a guide with gems from exile-leveling will also import available notes on specific gems

long-pressing the omni-key while hovering over a gem will open a tooltip displaying the note

• while the tooltip is open, a regular omni-click is enough to open the next tooltip for another gem

• pressing ESC will close the tooltip

upon importing a guide that contains gems, a string for the search-strings feature will be generated and saved

• this string highlights all required gems for an imported build in the vendor window

• this is meant to be used for pre-/bulk-purchasing gems when starting a new character (or when switching guides halfway through)

the "search-strings" section of the settings menu will have a new search entry for "hideout Lilly" which has to be calibrated and tested first

• if you need to access this gem-string before having unlocked Lilly in your hideout, simply calibrate it using a regular vendor (and then disable the "hideout Lilly" search again until you have unlocked her, otherwise regular vendor strings may clash with it)

pressing the omni-key when Lilly's gem window is open will paste the search-string into the search-field

this search-string will highlight gems for each individual gem-tab in the vendor window in sequence

• open the first vendor-tab and press the omni-key

• if gems are highlighted, buy them; if none are highlighted, switch vendor-tabs until you find highlighted gems and buy them

• scroll down once: if gems are highlighted, buy them; if not, switch tabs again

• repeat until every required gem has been bought

open the settings menu, go to the screen-checks section, and correctly set up the 'skilltree' image-check

• this step is necessary, otherwise the omni-key will not trigger the overlay

go to the 'leveling tracker' section in the settings menu

there are two methods of importing screenshots

you can either click 'open skilltree-folder' to open the folder where screenshots are stored, and then put your own screenshots in there

• the image-files need to be in .jpg, .bmp, or .png format

• for sorting purposes, file names should start with "[XX] " (make sure to include a 0 if the number is single-digit: 01, 02, 03 ... 09, 10, 11, etc.)

• the file-name will also be the caption underneath the image in the overlay, but the "[XX] " will be automatically omitted

• images of ascendancy-trees need to be named "[labX]" (you can add up to 5; the fifth is for potential end-game respecs)

• the images will be overlaid in 1:1 scaling: so if you download screenshots that are higher resolution than your screen, you'll have to edit and scale them down first

or you can check the box for a PoB 'integration', which enables screen-capping via the middle mouse-button in PoB:

• Youtube clip

• after capping an area, a setup-window with a preview and text-field will open

• the edit field underneath can be used to add a caption (it cannot be blank since this text will also be the file-name)

• the field will initially be filled with a sample caption/file-name (it's the number this image will take in the sequence)

• the field also has a drop-down list that can be used to save the screen-cap with an existing caption/file-name, or to specifically save it as an ascendancy skilltree

• right-clicking an entry in the drop-down list will delete the specific screenshot and remove the entry (except lab entries)

• the screen-cap can be cropped before saving: left-clicking the preview-image sets the top-left corner of the cropping area, right-clicking the bottom-right corner

• press ENTER to complete the import, or ESC to abort

• the image-files can be managed by opening the folder via the 'open skilltree-folder' button in the settings menu

things to consider when naming/captioning

• it's a good idea to include the masteries in the caption (the video-clip above shows an example)

• since the caption is also the file-name, you should always keep them short and to the point (there's a limit on how long a file-path can be)

• the overlay accesses the files alphabetically, so keep that in mind when naming them

  • either include the sample text ([xx], when capping in PoB) in your customized caption, or use a consistent pattern (such as "act 1 - yadda yadda", "act 2 - bla bla", etc.)

• if numbers are a relevant factor for ordering, a zero has to be added before single-digit numbers so that they will be ordered 01, 02, 03, 04... 10, 11 instead of 1, 10, 11, 2, 3, 4... (even if it's not required in the Windows file-explorer)

  • the strings "act X" and "actX" will automatically be converted to "act 0X" and "act0X" (as shown in the clip), the user has to take care of the rest

• underneath the screenshot, there's the caption that the user can adds during import and a gray bar that represents how close this image is to the end of the sequence

• releasing the omni-key will hide the overlay again

• right-clicks switch to the next image, long right-clicks to the previous one

• you can use the number-keys 1 to 0 to jump to specific images (1-10)

• the overlay will always open the image that was last viewed, and this also carries over between sessions

• hovering over the lab-icons will display the corresponding ascendancy skilltree

user-requested, and based on leveling-guides generated via exile-leveling created by HeartofPhos, who has been a huge help and implemented an export-feature based on this request

I found this idea interesting enough to persue implementation (I also wanted to do something with the client-log, so this was a good opportunity)

this quickly became a trip to Struggle Town because of miscommunication with the creator of exile-leveling, which almost made me drop this implementation

the gear tracker and gem search-strings were random ideas and kept me going eventually