Getting Started

1. Invite the Bot

Click the Invite Bot button on the homepage or use the invite link your server admin shared. The bot will ask for a few permissions during setup:

• Manage Roles so it can assign verified roles automatically when someone passes a gearcheck.
• Manage Threads so it can create and manage gearcheck threads in your designated channels.
• Send Messages / Embeds for the dashboards, score breakdowns, and status updates inside threads.
• Read Message History so it can find and process evidence posted in threads.
• Attach Files for exporting packs and sharing score reports.

You need Manage Server permission in your Discord server to invite the bot.

2. Get Oriented

Once the bot is in your server, you have two ways to get started:

3. Install a Template or Build From Scratch

Builds are the specs your members need to match. They can be checked with different evidence sources depending on the game: OCR screenshots, ESO CharacterMarkdown exports, TONL exports, or another supported adapter. You have two options here:

Option A: Install a Template Pack

Template packs are pre-built gear specs curated for specific games and activities. If your game has a template available, this is the fastest way to get going.

Template installation requires a Subscriber plan. On the Free plan, you can build everything manually.

Option B: Build From Scratch

Start by creating a build, then add categories and items to it. This gives you total control over what gets checked.

Check the Build System docs for the full breakdown of categories, items, aliases, weights, and thresholds.

4. Set Up a GearCheck Channel

Pick a channel in your server and tell the bot to use it for gearchecks. You need to specify which activity the channel is for, so the bot knows which builds to show.

After this, when someone creates a thread in that channel, the bot will post a dashboard with all the builds available for that activity. Members pick a build, submit the evidence that build expects, and hit Continue.

You can set up multiple channels with different activities. For example, one channel for raid gearchecks and another for dungeon gearchecks.

5. Configure the Mod Role

By default, anyone with Manage Messages or Administrator permission can use mod commands such as overrides and transfers. If you want to give mod access to a specific role instead, set it up:

6. Test Your Build

Before sending your members through the gearcheck, test it yourself. The /pack test command lets you paste sample text and see how an OCR-style build matches it. For ESO builds, use the dashboard import and test flow with a real Markdown or TONL export so you can validate structured fields before members submit.

The bot will show you exactly which items matched, which were close, and which were missed. If something is not matching when it should, add more aliases to that item.

7. Run Your First Real GearCheck

You are ready. Tell your members to head to the gearcheck channel, create a thread, and follow the dashboard prompts. Here is what happens from their perspective:

1. 1They create a thread in the gearcheck channel.
2. 2The bot posts a dashboard. They pick a build from the dropdown.
3. 3They submit the evidence the build asks for: screenshots for OCR, a pasted CharacterMarkdown export for ESO Markdown, or a TONL text file/export for advanced ESO checks. Then they click Continue.
4. 4The bot parses the evidence, scores it against the selected spec, and shows a breakdown of matches, partial matches, misses, and review notes.
5. 5If the score hits the verified threshold, the bot assigns the verified role if configured. If not, the member can try again with updated gear, clearer evidence, or the correct export format.