Skip to content

Search strings

Jump to bottom
Lailloken edited this page Mar 23, 2023 · 20 revisions

** Out of date. Refer to these release notes **

Feature Overview

  • single-hotkey solution to access multiple search-strings for various search-fields in the game

  • currently supported: stash, vendors, Gwennen, bestiary index

  • create context-menus for individual in-game searches

  • simple search-strings: simply paste a saved string into the search-field

  • advanced search-strings: switch between multiple sub-strings via scrolling


User Interface & Settings

  • this feature does not have any UI-elements other than context-menus

  • general inputs:

    • omni-key: triggers the context-menu (or search) when a supported in-game UI is open

    • scroll-wheel: switches between sub-strings (if a search has been set up this way)

  • this feature has its own section in the settings menu where all strings are listed and new ones can be added


Requirements

  • each available use-case has an image-check that has to be set up in the settings menu in order to use this feature

Setup

  • click 'add string' to open the search-string configuration window
    image

    • name: how the shortcut will be displayed in the context-menu; it has to be unique, otherwise an existing search with the same name will be overwritten (only use numbers and regular letters!)

    • use-cases: which search-field the shortcut will be available in

    • string 1: the string to be pasted when left-clicking the shortcut in the context-menu

    • string 2: the string to be pasted when right-clicking the shortcut in the context-menu

    • enable scrolling: whether the string uses advanced features activated by scrolling the mouse-wheel


  • example 1: search for unique items (simple search)
    image

    image
    image


  • example 2: search with two strings (left- & right-click)
    image
    NOTE: if you want to indicate that a search has a secondary string, use a capital i or a vertical bar ( | ) in the name

  • example 3: search-string with scrollable number value
    image

    • clicking the shortcut in the context-menu will paste "item level: 86"

    • a tooltip will follow the mouse to indicate that scroll-mode is on image

    • scrolling down will decrease the number by 1 (and up increase it by 1) and paste the new string


  • example 4: search with multiple sub-strings
    image

    • clicking the shortcut will paste the first sub-string in the list

    • scrolling down will paste the next sub-string in the list, scrolling up will paste the previous sub-string


General Usage

  • context-menus are activated by pressing the omni-key (default: middle mouse-button) while a supported window is open

    • if only one search-string is set up for a specific window, the context-menu will not show and the search-string is immediately activated instead

Managing searches

  • right-clicking an entry in the list will show options to edit or delete it
    image

  • long-clicking an entry will show a popup with information about the search
    image


Limitations: harvest

  • to access the context-menu for searches while harvest-crafting, you have to toggle the mini-map into the corner first

    • search-strings are only accessible when a window with a search-field and the inventory are open at the same time

    • when accessing the harvest crafting-bench, both cannot be open at the same time; toggling the mini-map tricks the script into thinking the inventory is open


Remarks

  • this is an extension of the Gwennen regex-feature and the beastcrafting search

  • I find this useful for quickly doing frequent searches

  • I created the 'scrolling' feature to be able to do 'top-down' searches for things like oils or item level

Clone this wiki locally