Stash‐Ninja

Feature Overview

• fetches poe.ninja prices and overlays price-tags onto the grid of specific in-game stash tabs

• despite its focus on pricing, it is also somewhat relevant for SSF:

  • high prices can correlate with an item's relevance in the current meta (so better not use it without preparation/research)

  • low prices can tell you which items are safe to vendor (e.g. 3:1 scarab recipe)

• allows seamless switching between up to 5 customizable profiles with different price-limit ranges

• hovering over highlighted items will show the current conversion rates

• the overlay will (un)hide automatically according to mouse movement/actions and try to avoid blocking in-game text/UIs

• pressing TAB while the overlay is on screen will toggle an in-game search using the "note:" string in order to highlight items that have already been priced

User Interface & Settings

• this feature has its own section in the settings menu, with UI and pricing settings

main UI-elements & user interaction	screenshot
profile panel (bottom): - press number-keys 1 to 5 to switch between the displayed profiles price-tags (across the grid): - hover over tagged item-slots to see the currency conversion rates
bulk-sale suggestions when pricing items: - select a target margin at the top, then click a price in the table to paste it into the game's UI

Initial Setup

• make sure your in-game stash has at least one tab-folder

  • the whole stash UI shifts down a bit if a folder is present (and scaling calculations are based on this configuration)

  • the overlay's item-slot grid will be misaligned if there aren't any folders

• the overlay cannot be used with stashes that are within tab-folders (because these also shift down, leading to misalignment)

• open the settings menu by clicking the cogwheel-icon on the main toolbar

• select stash-ninja on the left, then click the enable-checkbox on the right

• under stash tab configuration, select the stash tab you want to set up, and also open it in game
  

  • long-click preview to show the overlay with every single tag enabled

  • check if the tags more or less align with the in-game grid

  • if they don't quite match up, you can fine-tune the gap value on the right and re-check until they align correctly

Setting Up Price-Range Limits

• near the bottom of the settings window, there are five groups of text-boxes

• the left box shows the profile-number (and hence the number-hotkey)

• the top box is used to set the max value for the price-range

  • setting a value x will highlight items up to x and filter out anything above

  • leaving this blank treats the max value as unlimited (basically 999999)

• the bottom box is used to set the min value for the price-range

  • setting a value x will highlight items starting from x and filter out anything below

  • leaving this blank treats the min value as unlimited (basically 0)

• the right box is used to set the measuring unit (C, E, D, %)

  • specifying the currency-type will convert every price-tag to that specific currency

  • leaving this blank will disable the profile entirely

General Usage

• open a stash tab in game and then long-press the omni-key (default: middle mouse-button) while hovering over an item inside the stash

• the overlay will open and display the profile panel below the stash

• it will automatically highlight items according to the most-recently selected profile (or #1 if opened for the first time in the current session)

• while the overlay is active, it will automatically adapt to mouse movement & actions (e.g. hide if it would otherwise block in-game text)

• while the overlay is active, press number-keys 1 to 5 to switch between profiles

• hovering over an item that is highlighted by the overlay will display a panel with current conversion rates

• shift/right-clicking stacks to split/price them will temporarily hide the overlay until you press ENTER or ESC

  • it is important to avoid using the in-game cancel/confirm buttons when splitting/pricing

  • if you accidentally use the cancel/confirm button, you can long-press the omni-key over a scarab to activate the overlay again

Bulk-Sale Suggestions/Management

• there's an optional setting that displays an additional panel when pricing items
  

• at the top, there are buttons to select a preferred target margin which are fully customizable (defaults: 0, 5, 10, 15, 20%)

• on the left, it shows the rough total market value of your stock, as well as rough unit prices

• the rest of the panel is a table divided into columns with different bulk-sizes

• as with splitting stacks, it is very important to press <ESC> when cancelling/discarding, instead of clicking the in-game cancel button

---

• the bulk-sales table in more detail:
  

  • the header-line shows different bulk-sizes you can use to sell your stock: ascending from left to right, it basically gives you the options to sell everything in a single trade, in two trades, in three trades, etc.

  • some options will leave you with left-over stock, represented by the values in parentheses

  • the lines underneath each bulk-size display its price at the chosen target margin ("target" because these are rounded to the closest "convenience price" that doesn't involve change) and the actual margin in parentheses underneath

  • you can click a price, and it will be pasted into the game and locked in
    

---

• when right-clicking an item that is already priced, a reminder will show telling you to switch to note first
  

  • it refers to this:
    

  • the other pricing modes don't support pasting without having to click into the field first

---

• there is an optional setting in the menu to set a minimum trade value (chaos)

  • basically, it lets you specify "I only want to do trades of at least X chaos", which limits the bulk-sale suggestions

  • example no minimum value vs 20 chaos: after setting the value, the table only shows sell 30 scarabs for 41c and sell 15 scarabs for 21c