GrapevineLARP

Home of the Grapevine LARP Administration Utility

Searching for Characters

The “Search for Characters…” command in the Characters menu displays a window you can use to find characters meeting complex search criteria. You could search for all characters with a Generation lower than ten, Media Influence of at least three, or theNightmares Flaw, for example.

At the top of the window is a dropdown list of saved searches. Select one to perform that search automatically. These can also be used from the Characters or the Statistics windows to examine the lists of characters that they match.

Creating a Search

First, use the “Any” or “All” option buttons to select whether you want to find characters that match any of the criteria you specify, or all the criteria to specify. Matching all defines a narrower search than matching any.

Next, use the “Add Term” button to add a new search term. It should appear with a number 1 in front of it. If you previously selected a saved search from the dropdown list, this term may already be there. If there are more terms following it, click the “Remove Term” button until you’ve reduced the terms to just one.

Now use the first drop-down list of the term to select some character aspect, such as Generation or Influence. Use the next drop-down list to choose the type of match you want to make. Check the NOT checkbox beneath it if you want to match characters that don’tfit the criterion you specify.

If the character aspect you chose is a single-item text field like Clan or Nature, the types of match include:

  • Contains. Matches if the aspect contains your search text.
  • Equals. Matches if the aspect is exactly equal to your search text.

If the aspect you chose is a single-item numerical field like Generation or Rage, the types of match include the following, which all correspond to basic mathematical comparisons:

  • Is Less Than. (x < y)
  • Is No More Than. (x <= y)
  • Equals. (x = y)
  • Is At Least. (x >= y)
  • Is Greater Than. (x > y)

If the aspect you chose is any kind of list, such as a list of Physical Traits or Merits, the types of match are:

  • Total Less Than. Matches if the total is less than the given number.
  • Total No More Than. Matches if the total is less than or equal to the given number.
  • Total. Matches if the total number of items in the list match the number you specify.
  • Total At Least. Matches if the total is equal to or greater than the given number.
  • Total More Than. Matches if the total is greater than the given number.
  • Contain. Matches if one Trait in the list partially matches the text you specify.
  • Contain the Note. Matches if the note of one Trait in the list partially matches the text you specify.
  • Contain Less Than. Matches if the list contains less than the given number of the given Trait (but contains at least one).
  • Contain No More Than. Matches if the list contains no more than the given number of the given Trait (but contains at least one).
  • Contain Exactly. Matches if the list contains exactly the given number of the given Trait.
  • Contain At Least. Matches if the list contains at least the given number of the given Trait.
  • Contain More Than. Matches if the list contains more than the given number of the given Trait

The last field is where you type the text or the number you’re searching with. Sometimes there will be two fields, the first for text and the second for a number.

Once you’ve entered all the search criteria, you can click the “Add Term” button to add more criteria. If you want to remove criteria, click the “Remove Term” button.

Last, use the “Sort by” dropdown list, and the associated “Ascend” or “Descend” option, to choose how your list will be sorted. Usually you will sort by name or by the values that match your search terms; but sometimes you may want to see list of all characters sorted by their total Physical Traits, for example.

When you’re ready to search, click “Perform Search.”  If any characters match your criteria, the list at the top of the screen fills with their names. Select any name and click the “Show Character” button to load the character sheet.

If no characters matched your criteria, “0 Results” appears beneath the empty list.

If a character does not even qualify for a search, the search will not match it. A search for “Glamour is Less Than 4,” for example, will never match a vampire. Vampires don’t have the Glamour value and don’t even qualify.

Saving Searches

Click “Save Search” if you’d like to save a search and make it available to the dropdown lists in such places as the Characters window and Statistics window. Grapevine will prompt you for a name under which to save the search. If you enter one that is already in use, you’ll be prompted to confirm that you want to overwrite the existing search.

Deleting Searches

After selecting one of the saved searches from the dropdown list, click “Delete Search” to remove it.

Most Recent Search

In any other area of Grapevine that allows you to select or view characters by a saved search, a search called “Most Recent Search” will appear after you have used the Search for Characters window. Selecting it will return the same results as the last search you performed in this window.