Documentation

Discord Commands

Command Reference

Every GearCheck slash command, organized by who uses it. The dashboard handles deeper setup and analytics; Discord stays fast for members, moderators, and quick server operations.

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

For Everyone

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

/gearcheck start

Create your standardized GearCheck thread in the current configured channel. The bot validates the channel mapping, names the thread, posts starter instructions, and pins the dashboard.

Parameters: character (optional)

/gearcheck start character:AskHeinzy
/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
/gearcheck notifications

Manage your personal GearCheck notification preferences in Discord. Use this to opt in or opt out of DMs about your own checks, review outcomes, and related GearCheck activity.

/gearcheck notifications
/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 starting a check thread, submitting build evidence, 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 and Pro 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, members can run /gearcheck start here to create standardized dashboard threads.

Parameters: activity (required)

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

Require a role to see a specific build in the gearcheck dropdown. Useful for progressive gear checks 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-rolePro+

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-rolePro+

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 GearCheck access pass code. Existing access passes still use this command name.

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
/admin clear-activity-role

Remove the verified role for a specific activity. Players verifying for that activity fall back to the global verified role, if one is set.

Parameters: activity (required)

/admin clear-activity-role activity:wurmmy
/admin set-difficulty-rolePro+

Set a verified role for a specific difficulty (for example m10 or hard) with its own score threshold. Difficulty roles sit between per-activity roles and the global fallback in priority order.

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

/admin set-difficulty-role difficulty:m10 role:@M10-Verified min_score:90
/admin clear-difficulty-role

Remove the verified role for a specific difficulty.

Parameters: difficulty (required)

/admin clear-difficulty-role difficulty:m10
/admin set-assistant-role

Map a Discord role to the assistant staff tier. Assistants get view-only access by default; fine-tune what they can do in the web dashboard under Settings > Staff Roles.

Parameters: role (required)

/admin set-assistant-role role:@Assistant
/admin clear-assistant-role

Remove the assistant role mapping and reset assistant users and permissions.

/admin clear-assistant-role
/admin staff

View the current staff configuration: the Admin, Moderator, and Assistant role mappings and permissions for this server.

/admin staff
/admin set-ticket-channel

Set a channel where support tickets are posted as a feed, each with a Resolve button for your team.

Parameters: channel (required)

/admin set-ticket-channel channel:#gearcheck-tickets

For Build Editors

These commands require Manage Server permission. They create and edit packs and builds and the OCR category/item model used to score screenshot-based games.

These commands author the OCR item model. Elder Scrolls Online builds are scored from a character export instead, and are set up in the web Build Editor's ESO Spec tab, not with /pack. See the Build System guide for details.

/pack create-pack

Create a new pack. A pack is the top-level container that holds your builds. Give it a name and, optionally, a game tag and a display emoji. Returns the pack key you'll use in other commands.

Parameters: name (required), game (optional), icon (optional)

/pack create-pack name:New World PvP game:New World
/pack edit-pack

Rename a pack or change its game tag or display emoji. Provide at least one field to change.

Parameters: pack (required), name (optional), game (optional), icon (optional)

/pack edit-pack pack:new-world-pvp name:New World OpenWorld
/pack delete-pack

Permanently delete a pack and every build inside it. This cannot be undone.

Parameters: pack_name (required)

/pack delete-pack pack_name:old-pack
/pack list-packs

List all packs for this server, with each pack's key, build count, category count, and game tag.

/pack list-packs
/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 edit-build

Edit a build's name, activity, difficulty, score thresholds, or guide URL. Provide at least one field to change, handy for renaming or retuning a build without rebuilding it.

Parameters: pack (required), build (required), name (optional), activity (optional), difficulty (optional), verified (optional), tentative (optional), borderline (optional), build_url (optional)

/pack edit-build pack:new-world-pvp build:tank-build name:Main Tank verified:90
/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 edit-category

Edit a category's display emoji or scoring weight. Set weight to 0 to use the automatic weight (1.5x for artifacts/trophies, 1.0x otherwise).

Parameters: pack (required), build (required), category (required), icon (optional), weight (optional, 0 = auto)

/pack edit-category pack:new-world-pvp build:tank-build category:trophies weight:2.0
/pack add-item

Add an item to a build's category. Items are what actually get matched against the build's evidence 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 an OCR-style build against sample text to verify matching. Paste text from evidence 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-templatePro+

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 exportPro+

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

/pack export
/pack importPro+

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 sharePro+

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

/pack share
/pack import-codePro+

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 verified minimum for a build in the current thread. The member's displayed score won't go below this value. Use when automated evidence parsing clearly failed but the build 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 gear checks flagged for manual review (low confidence or partial scores).

/mod review-queue
/mod approve

Approve a gear check in the review queue.

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

/mod approve session:a1b2c3d4
/mod reject

Reject a gear check in the review queue.

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

/mod reject session:a1b2c3d4 comment:wrong export

RaidHelper Integration

Overlay gear readiness on RaidHelper event signups. Requires a server RaidHelper API key from /apikey, not /usersettings.

/raidhelper setupPro+

Configure RaidHelper integration with your server API key.

Parameters: api_key (required), channel (optional)

/raidhelper setup api_key:SERVER_KEY
/raidhelper readinessPro+

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 eventsPro+

List upcoming RaidHelper events with their IDs.

/raidhelper events
/raidhelper watchPro+

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

Parameters: channel (required)

/raidhelper watch channel:#raid-signups