Skip to content

Stash‐Ninja

Lailloken edited this page Jun 30, 2024 · 28 revisions

Feature Overview

  • overlays poe.ninja prices onto the grid of every fixed-structure stash tab

  • also applicable to SSF: find low-value scarabs for vendoring, know which ones are high-value and require specific setups for best returns

  • seamless switching between up to 5 customizable price-range filters

  • optional: shows an item's price history

  • optional: offers (bulk-)sale management when pricing items

  • press TAB while the overlay is active to toggle highlighting for items that are currently listed for trade


GeForce Now Differences

  • the omni-key can't access clipboard data, so the feature is activated via a dedicated hotkey (default: F2)

    • pressing the hotkey will open a selection menu of the supported stash tabs
      image

    • click an entry to open the overlay for a specific tab

  • bulk-sale management can't read your stock, so it can't check if your listing is valid


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 highlighted item-slots to see currency-equivalent prices
image
(bulk-)sale management:
- click a currency icon to toggle the listings-table on the right
- right-click an icon to refresh the listings-table
- click a price-point in the table to load it into the panel
- hover over the confirm-button and scroll to adjust stack-size
- click confirm to paste the listing into the game
image

Initial Setup

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

    • 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
      image

    • 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)
      image

    • 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
    image

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

  • the bot-left box specifies which values to show (C, E, D, %), i.e. chaos, exalt, divine, or last week's price-change

    • leaving this blank will disable the profile entirely
  • 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
    image

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

    • 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 currency-equivalent prices

    image

  • 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

Bulk-Sale Management

  • if the enable bulk-sale management setting is enabled, right-clicking an item in a tab while Stash-Ninja is active will open the panel

  • when first right-clicking an item, the right-most column will show the stack's market value according to poe.ninja prices

    image

  • to list an item, you have to get live prices by clicking one of the icons:

    image

    • whenever you fetch live prices, a median will be calculated and pre-selected as the new global price for that item (which will also be the price displayed on price tags in the general overlay)

    • this will also unlock the sell X for Y columns on the left and enter the corresponding stack-size and price values

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

    • if you accidentally cancel it via the in-game buttons, you can click the x button in the top-right

  • when clicking a currency icon, a table will also fold out on the right, showing what kind of listings are currently open on the exchange

    image

    • this table can be closed by clicking the icon again or pressing ESC
  • the first column shows current price-points on the exchange, and the currently-selected one is highlighted in green, while the current median price-point is highlighted with a yellow border

    • it's important to note that every row corresponds with a price-point, not a listed item (i.e. each row is a summary of every item listed at that price-point)

    • you can click any price-point to select it as the new global price and also apply it to the main panel

  • the second column shows the number of listings at each price-point (these are visualized by a bar underneath), and the header shows the total number of open listings

    • the idea is to visualize whether there are specific concentrations of listings around specific price-points
  • T+XX:YY underneath the first two columns shows how much time has elapsed since fetching the price data

    • you can right-click the currency icons to fetch the latest price data

  • the combined third/fourth columns are enabled by default but can be toggled by clicking the < / > button in the top-right

    • they show stock levels at a given price-point (both the overall stock and the highest stock held by a single seller), with bars underneath as visualization

    • the idea is to identify potential "price walls" where large amounts of stock have to be bought up first before the general market price can go any higher

    • the second stock-column can be used to identify how individuals with large stock are pricing their items and what kind of "bulk-tax" they take


  • you can hover over the sell X for Y columns and scroll the mouse-wheel to adjust stack-size and final price according to the price-point

    image image
    • it will stop you from scrolling past your actual stock (except for unstackable edge-case items that don't show stack-size in the tooltip)

    • it will also stop you from scrolling past the point of a full inventory's worth of items in either the sell of for column

    • you can also press the middle mouse-button to reset the values to what they were at the beginning

  • click confirm to paste the listing-string into the game's pricing UI


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
    image

example: 20c minimum trade value

image

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
image
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
image
etc.

Clone this wiki locally