Search strings - Lailloken/Lailloken-UI GitHub Wiki

Feature Overview

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

  • create context-menus for every single search-field in the game

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

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

  • comes with strings for beast-crafting flasks by default

User Interface & Settings

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

  • general inputs:

    • omni-key (tap, not hold): triggers the context-menu (or search) when a specific in-game UI is open

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

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

Setup: Simple Searches

  • use-cases have to be defined, set up, and calibrated in the settings menu before the script can access search-specific strings

    • in this example, search-strings for Gwennen's gamble window will be set up

    • setting up different use-cases is the same, you only have to replace the screen element that is unique to the specific use-case/vendor

  • open the settings menu and go to the search-strings section

    • there is an edit-field next to 'add search:' into which the name of a use-case has to be entered
      image

    • after entering a name and pressing enter, the new search will be added to the list under use-cases currently set up:
      image

  • each use-case has a built-in screen-check that reads the screen whenever the omni-key is pressed in order to find a specific UI-element

    • red text highlights that this screen-check has to be calibrated and tested first

    • click cal to initiate screen-capping

    • the Windows snipping tool will open with which to screen-cap an area of the in-game UI that is unique to the use-case in question
      image

    • after that, click test (red highlighting will persist until a test has returned a positive result)

  • click edit to open the configuration window in order to add one or more strings to this use-case
    image

    • this is where you add entries to the context-menu of that search, i.e. the menu that will pop up when pressing the omni-key
    • type in a name into the edit-field and press enter to add a new entry to the list
      image
    • click an entry to make the big edit-field on the right accessible, then paste the string you want to use into it
      image

  • pressing (tap, not hold) the omni-key while Gwennen's gamble window is on screen should now activate the search-strings feature

    • if only one entry has been set up (as in this example), the string will be immediately pasted into the in-game search field, without showing the context-menu

    • if multiple entries have been set up, a context menu will appear from which an entry can be selected
      image

Setup: Advanced Searches

  • individual entries can be set up in a different way in order to access advanced string-pasting

  • example 1: search-string with a number-value that can be modified on the fly

    • to make a number within a string modifiable, enclose it within semi-colons in the configuration window
      image

    • activating this entry in game will paste the string into the search-field and enter 'scroll-mode' during which scrolling the mouse-wheel will modify the number by 1
      image image

    • a reminder-tooltip will follow the cursor as long as this scroll-mode is active

  • example 2: search-string with multiple sub-strings

    • to make an entry use multiple sub-strings that can be scrolled between, paste multiple lines of strings into the big edit-field in the configuration window
      image

    • activating this entry in game will paste the first string into the search-field and enter 'scroll-mode' during which scrolling the mouse-wheel will switch between the various sub-strings

    • a reminder-tooltip will follow the cursor and display the current and maximum sub-string index as long as this scroll-mode is active

General Usage

  • context-menus are activated by pressing (tap, not hold) 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 pasted instead

Limitations: searches in UIs that aren't fullscreen and don't involve the inventory

  • pressing the omni-key will not activate any features as long as this UI-element is in the top-right corner of the screen:
    image

  • many in-game UIs with searches automatically open the inventory or cover this element, which solves this limitation

  • if you want to activate the search-strings feature for a search that doesn't, you have to manually open the inventory or toggle the minimap and then press the omni-key