Build System

Builds are the foundation of the gearcheck system. A build defines exactly what gear your members need to have. When someone uploads a screenshot, the bot compares it against the build and gives them a score. This page explains every layer of how builds work.

What Is a Build?

A build is a gear specification. Think of it as a checklist that says "to be verified for this content, you need these items." Every build has a name (like "Tank Build" or "Healer PvE"), and it belongs to an activity.

Builds contain categories, and categories contain items. When the bot scores a screenshot, it works through each category and checks how many of the required items it can find in the OCR text.

Activities

An activity is a grouping label for your builds. Common examples: "Raids," "Dungeons," "PvP," "Wars." When you set up a gearcheck channel with /gearcheck setup activity:raids, the channel will only show builds that belong to that activity.

This keeps things organized. Your raiders see raid builds. Your dungeon runners see dungeon builds. Nobody has to scroll through a list of builds they don't care about.

Categories

Categories are the gear types within a build. For example, a build might have categories for Weapons, Armor Perks, Amulet, Ring, and Trophies. Each category gets scored separately, and the category scores combine into the overall build score.

Categories can have different weights (more on that below), so you can make some categories count more than others toward the final score.

Items

Items are the individual things being checked within a category. If your "Armor Perks" category needs Refreshing, Freedom, and Resilient, those are three items. Each item gets matched against the OCR text from the screenshot.

When adding items, think about what text the bot will see in the screenshot. The name should match what actually appears on screen, and you can add aliases to catch variations.

Aliases

Aliases are alternative names for an item. They exist because OCR isn't perfect, and because games sometimes display things differently than you'd expect. The bot uses fuzzy matching, so it can handle small typos on its own. But aliases help in cases where the difference is bigger.

For example:

• An item named "Sword and Shield" might also appear as "SnS" or "Sword & Shield" in screenshots.
• OCR might read "Refreshing" as "Refrshing" or "Refreshlng".
• A perk might be shortened in the UI compared to its full name.

Good aliases make the difference between a 60% score and a 95% score. If your members are getting lower scores than expected, check aliases first.

Excludes

Excludes prevent false positives. Sometimes an item name is a substring of another item, and the bot might match the wrong one. For example, "Refreshing" is part of "Refreshing Move." If your build needs Refreshing but not Refreshing Move, you can add "Refreshing Move" as an exclusion on the Refreshing item.

When the bot sees "Refreshing Move" in the OCR text, it won't count it as a match for the "Refreshing" item. This keeps your scores accurate.

Weights

Not all categories are equally important. Weights let you control how much each category counts toward the final score. By default, every category has a weight of 1.0. You can increase a weight to make a category count more, or decrease it to make it count less.

For example, if trophies are harder to get and more important for your content, you might give the Trophies category a weight of 1.5. That means it contributes 50% more to the final score than a category with weight 1.0.

Thresholds

Thresholds determine what status a member gets based on their score. There are four status levels:

Rule Types

Each item in a build can have a rule type that controls how it affects scoring:

Game Data Search (New World)

New World packs have access to the full game database in the web build editor. Type a perk or item name to search, and selecting a result auto-fills aliases, excludes, and description fragments for accurate OCR matching. You can also type custom names without selecting from the dropdown.

Trophy Detection (New World)

Enable trophy detection on builds to auto-detect combat trophies from trophy grid screenshots. Select which types are required (Angry Earth, Wildlife, Lost) and the bot handles the rest. Ultimate Combat Trophies count toward all types. Target is always 3 (one per house). Requires the trophy_detector_nw plugin to be enabled.

Templates vs Custom Builds

You can start from a template pack or build everything from scratch. Templates are pre-configured builds with categories, items, and aliases already set up. They save a lot of time if your game has one available.

You can also install a template and then customize it. Installed templates are fully editable, so you can add, remove, or change anything after installation.