Stash‐Ninja

Feature Overview

• fetches poe.ninja prices and overlays price-tags onto the grid of every fixed-structure stash tab in the game

• 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

• optional: offers bulk-sale suggestions/management when pricing items

• optional: lets you specify a minimum trade value (i.e. an "I don't want to do trades below X chaos" value)

  • bulk-sale suggestions will adapt to this value

  • there's also an option to automatically configure profiles in a way that facilitates finding (stacks of) items that meet/exceed this value

• 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 stash-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 slightly if there aren't any folders

  • you can simply put a random tab (e.g. dump tab) into a folder

• 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

• within the game, open the tab you want to set up and long-press the omni-key (default: middle mouse-button) while hovering over an item in the tab

  • as soon as the overlay is active, the settings menu should detect which tab is active
    

  • if you want to use this features for tabs within a stash folder, you'll have to check the box shown below (the overlay has to be offset in order to align correctly)
    

  • fine-tune the gap value on the right until all the price-tags more or less align with the in-game stash

Setting Up Price-Range Limits

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

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

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

  • specifying the measuring unit will set every price-tag to that specific unit

  • leaving this blank will disable the profile entirely

  • % refers to change in price compared to one week ago

• the top-right 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 bot-right 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, or -999 for %)

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
  

  • if the tab is divided into sub-tabs, their selection-boxes will be highlighted by additional overlay-buttons
    

  • if you click a button to switch sub-tabs in game, the stash-ninja overlay will also switch accordingly

• 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, and what it means:

sell all 7 for:	sell stacks of 3 (+1 unit left-over) for:	sell stacks of 2 (+1 unit left-over) for:	sell 1 unit for:
301 chaos	129 chaos	86 chaos	43 chaos
2 divines	1 divine	1 divine

• 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 are some items that don't stack outside of specific tabs, which means the feature cannot read the stack-size

• in that case, the suggested bulk-sizes will be highlighted in a faint red
  

• since the feature cannot read your available stock, the suggested bulk-sizes will be placeholder-values ranging from 5 to 1, and you'll have to figure out yourself which one applies the best

---

• suggested bulk-sales will be grayed out if the price exceeds a full inventory of a specific currency
  

• if your stock exceeds a full inventory, bulk-sizes will be adjusted accordingly and highlighted in a blue-ish gray
  

---

• 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
    

Optional setting: automatic profiles based on minimum trade value

• there is an option to automatically configure profiles 1 to 4 based on the specified minimum trade value (chaos), i.e. the "I don't want to do trades under X chaos" value

  • the main goal is to make it easier to find (stacks of) items that meet that minimum trade value (i.e. that are worthwhile to sell)

  • how it works: activating profile X will highlight item-slots according to a specific price-range, and stacks of X (same number as the profile) or greater will meet the minimum trade value

  • rough rule of thumb: highlighted items meet the trade value if: stack-size >= profile # (more detailed example below)

• profile 5 will be left untouched, in case a vendor/trash tier profile is applicable

• price-range customization will be grayed out if this option is enabled
  

---

example: 20c minimum trade value

explanation	screenshot
profile 1: - every item-slot worth at least 20c will be highlighted - any stack of at least 1 meets the minimum trade value
profile 2: - every item-slot worth between 10 and 19.99c will be highlighted - any stack of at least 2 meets the minimum trade value
etc.