Documentation

Command Reference

Every slash command the bot offers, organized by who uses them. All commands are slash commands, and all of them work inside your Discord server.

Commands marked with a tier badge require that tier or higher. Everything else works on the Free tier.

For Everyone

These commands are available to all server members. No special permissions needed.

/gearcheck my-builds

View your build history across all threads in this server. Shows every build you've been scored on, your best score, and current status.

/gearcheck my-builds
/gearcheck build-info

View detailed info about a specific build, including its categories, item counts, and weight configuration.

Parameters: build (required)

/gearcheck build-info build:tank-build
/gearcheck builds

List all available builds for this server, organized by activity. Shows category names and the server's current build limit.

/gearcheck builds
/support

Submit a support ticket. The bot sends it to the configured support user or mod team. Use this if you think something is wrong with your score or need help with the process.

/support
/guide overview

Overview of all guide topics. A quick reference card with links to each section.

/guide overview
/guide setup

Step-by-step admin setup guide, right inside Discord. Covers inviting the bot, installing packs, configuring channels, and testing.

/guide setup
/guide user

How to use the gearcheck system as a regular member. Covers creating threads, uploading screenshots, and understanding your score.

/guide user
/guide mod

Moderator tools reference. Quick overview of overrides, transfers, tickets, and audit logging.

/guide mod
/guide builds

Build and pack editing guide. Covers creating builds, adding items, tuning aliases, and using /pack test.

/guide builds
/guide tiers

Compare Free, Subscriber, and Premium plans. Shows what's included in each tier and current pricing.

/guide tiers

For Admins

These commands require Manage Server or Administrator permission in Discord.

/gearcheck setup

Mark the current channel as a gearcheck channel for a specific activity. After this, threads created in the channel will get a gearcheck dashboard.

Parameters: activity (required)

/gearcheck setup activity:raids
/gearcheck set-role-gateSubscriber+

Require a role to see a specific build in the gearcheck dropdown. Useful for progressive verification where you need Build A before you can attempt Build B.

Parameters: build (required), role (required)

/gearcheck set-role-gate build:hard-mode role:@Verified-Normal
/gearcheck clear-role-gate

Remove the role gate from a build, making it visible to everyone again.

Parameters: build (required)

/gearcheck clear-role-gate build:hard-mode
/admin settings

View the current bot configuration for this server. Shows tier, enabled plugins, configured roles, channel settings, and build limits.

/admin settings
/admin set-tier

Set the guild tier for testing purposes. This is a temporary override, useful during setup.

Parameters: tier (required)

/admin set-tier tier:subscriber
/admin set-verified-roleSubscriber+

Set the default fallback role assigned when someone passes a gear check. For per-activity roles, use /admin set-activity-role.

Parameters: role (required), score (optional, default 85)

/admin set-verified-role role:@Verified
/admin set-activity-roleSubscriber+

Set a verified role for a specific activity with its own score threshold. Overrides the default role.

Parameters: activity (required), role (required), min_score (optional, default 85)

/admin set-activity-role activity:wurmmy role:@Wurmmy-Verified
/admin activity-roles

View all per-activity role assignments and the default fallback.

/admin activity-roles
/beta

Redeem a beta access code to unlock all subscriber features.

Parameters: code (required)

/beta A7K2MX9P
/admin set-support-user

Configure who receives support tickets submitted via /support.

Parameters: user (required)

/admin set-support-user user:@OfficerLead
/admin set-audit-channel

Set a channel where the bot logs gearcheck events like score changes, overrides, and role assignments.

Parameters: channel (required)

/admin set-audit-channel channel:#gearcheck-log
/admin redeem

Redeem an access code to upgrade your guild's tier.

Parameters: code (required)

/admin redeem code:ABC123-XYZ
/admin generate-code

Generate an access code that can be redeemed by another server. Administrator only.

Parameters: tier (required)

/admin generate-code tier:subscriber
/admin enable-plugin

Enable an optional plugin for this server. Plugins add game-specific intelligence like trophy detection.

Parameters: plugin (required)

/admin enable-plugin plugin:trophy_detection
/admin disable-plugin

Disable a plugin for this server.

Parameters: plugin (required)

/admin disable-plugin plugin:trophy_detection
/admin plugins

List all available plugins and their current status for this server.

/admin plugins

For Build Editors

These commands require Manage Server permission. They let you create and modify the build specs that the gearcheck system uses.

/pack create-build

Create a new build. Give it a name and assign it to an activity. The build starts empty, and you add categories and items to it.

Parameters: name (required), activity (required)

/pack create-build name:Healer PvE activity:dungeons
/pack clone-build

Deep-copy an existing build under a new name. Copies all categories, items, aliases, and weights. Saves time when builds are similar.

Parameters: source (required), name (required), activity (optional)

/pack clone-build source:tank-build name:Off-Tank activity:raids
/pack delete-build

Permanently delete a build. This cannot be undone.

Parameters: build (required)

/pack delete-build build:old-build
/pack add-category

Add a gear category to a build. Categories group related items together (weapons, armor, trophies, etc.).

Parameters: build (required), name (required), weight (optional, default 1.0), target (optional)

/pack add-category build:tank-build name:Trophies weight:1.5
/pack add-item

Add an item to a build's category. Items are what actually get matched against screenshot text.

Parameters: build (required), category (required), name (required), aliases (optional), target (optional)

/pack add-item build:tank-build category:weapons name:Sword and Shield aliases:SnS,S&S
/pack edit-item

Edit an item's aliases, exclusions, or target. Use this to tune matching when items aren't scoring correctly.

Parameters: build (required), category (required), item (required), aliases (optional), excludes (optional), target (optional)

/pack edit-item build:tank-build category:armor-perks item:Refreshing excludes:Refreshing Move
/pack remove-item

Remove an item from a build's category.

Parameters: build (required), category (required), item (required)

/pack remove-item build:tank-build category:weapons item:Fire Staff
/pack bulk-edit-item

Update an item across all builds at once. Useful for fixing a common alias or exclusion across your entire pack.

Parameters: item (required), aliases (optional), excludes (optional), target (optional)

/pack bulk-edit-item item:Refreshing aliases:Refrshing,Refreshlng
/pack test

Test a build against sample text to verify matching. Paste text from a screenshot and see how the scoring engine handles it. Essential for tuning aliases.

Parameters: build (required), text (required)

/pack test build:tank-build text:Refreshing, Freedom, Resilient, Sword and Shield
/pack view

View a build's full specification, including all categories, items, aliases, weights, and thresholds.

Parameters: build (required)

/pack view build:tank-build
/pack list

List all builds for this server, organized by activity, with category summaries.

/pack list
/pack install-templateSubscriber+

Install a curated template pack. Templates come with pre-configured builds, categories, items, and aliases for specific games.

Parameters: template (required)

/pack install-template template:new_world_mutations
/pack exportSubscriber+

Export your server's entire pack as a JSON file. Useful for backups or migrating to another server.

/pack export
/pack importSubscriber+

Import a pack from a JSON file attachment. Merges with your existing builds (does not overwrite).

Parameters: file (required, .json attachment)

/pack import file:[attach your .json file]
/pack shareSubscriber+

Generate a share code for your server's pack. Other servers can use this code to import your builds.

/pack share
/pack import-codeSubscriber+

Import a pack from a share code. Merges the shared builds into your server's pack.

Parameters: code (required)

/pack import-code code:ABC123
/pack my-shares

List all share codes you have created, with their usage and expiration status.

/pack my-shares
/pack revoke-share

Revoke a share code you created. The code will no longer work for anyone who hasn't already used it.

Parameters: code (required)

/pack revoke-share code:ABC123

For Moderators

Mod commands require Manage Messages, Administrator, or the configured mod role. See the Moderator Guide for detailed workflows.

/mod override

Set a score floor for a build in the current thread. The member's displayed score won't go below this value. Use when OCR clearly failed but the gear is correct.

Parameters: build (required), score (required)

/mod override build:tank-build score:85
/mod transfer

Transfer thread ownership to another user. Use when someone verified on the wrong character or the wrong person started the thread.

Parameters: user (required)

/mod transfer user:@SomePlayer
/mod refresh

Refresh the dashboard in the current thread. Use when the dashboard gets out of sync or buttons aren't reflecting the latest state.

/mod refresh
/mod active

View all threads with in-progress gearcheck workflows in this server. Shows thread names, owners, and current status.

/mod active
/mod info

View detailed gearcheck info for the current thread, including the owner, selected builds, scores, and workflow state.

/mod info
/mod set-mod-role

Set the moderator role for gearcheck commands. Members with this role can use all /mod commands.

Parameters: role (required)

/mod set-mod-role role:@Officers
/mod tickets

View all open support tickets for this server.

/mod tickets
/mod resolve-ticket

Mark a support ticket as resolved.

Parameters: ticket (required)

/mod resolve-ticket ticket:42
/mod cleanup

Clean up config entries for archived or deleted threads. Removes stale data from the bot's database.

/mod cleanup
/mod review-queue

View verification sessions flagged for manual review (low confidence or partial scores).

/mod review-queue
/mod approve

Approve a verification session in the review queue.

Parameters: session (required, autocomplete), comment (optional)

/mod approve session:a1b2c3d4
/mod reject

Reject a verification session in the review queue.

Parameters: session (required, autocomplete), comment (optional)

/mod reject session:a1b2c3d4 comment:bad screenshots

RaidHelper Integration

Overlay gear readiness on RaidHelper event signups. Requires a RaidHelper API key from your server.

/raidhelper setupSubscriber+

Configure RaidHelper integration with your server's API key.

Parameters: api_key (required), channel (optional)

/raidhelper setup api_key:YOUR_KEY
/raidhelper readinessSubscriber+

Show gear readiness for a RaidHelper event. Select from upcoming events or leave blank for the next one.

Parameters: event (optional, autocomplete)

/raidhelper readiness
/raidhelper eventsSubscriber+

List upcoming RaidHelper events with their IDs.

/raidhelper events
/raidhelper watchSubscriber+

Add a channel to auto-watch for RaidHelper event embeds.

Parameters: channel (required)

/raidhelper watch channel:#raid-signups