Troubleshooting

A few things to check:

• Is the bot online? Check the member list. If it's showing offline, the bot might be restarting or experiencing downtime.
• Does it have the right permissions? The bot needs permissions to read messages, send messages, and manage threads in the channels where it operates. Check the channel permission overrides as well as the bot's role permissions.
• Are commands synced? Slash commands can take up to an hour to sync after the bot is first invited. If you just added it, give it some time. You can also try restarting your Discord client to force-refresh the command list.

The gearcheck dashboard only appears in threads created in channels that have been set up with /gearcheck setup. If the channel hasn't been configured yet, threads created there won't trigger anything.

Also make sure the thread was created afterthe channel was set up. Threads that existed before setup don't retroactively get dashboards.

If the channel is set up but the dashboard still isn't appearing, check that the bot has permission to send messages and manage threads in that channel.

The score is based on what the OCR engine could read from your screenshots. Click the Show Details button on your score breakdown to see exactly which items matched, which were "maybe" matches, and which were missed.

Common reasons for lower-than-expected scores:

• Blurry or compressed screenshots
• UI elements covering the gear text
• Missing aliases in the build (admin can fix with /pack edit-item)
• Items not included in the build spec at all

See the How Scoring Works page for a detailed explanation.

Discord requires the bot's role to be abovethe role it's trying to assign in the role hierarchy. Go to Server Settings, then Roles, and drag the bot's role above the verified role.

Also confirm the bot has the Manage Roles permission. Without it, the bot can't assign any roles at all, regardless of hierarchy.

If buttons on the dashboard or score breakdowns stop responding, it usually means the bot restarted. Discord buttons are tied to the bot's session, and when the bot comes back online, it should recover automatically.

If buttons still don't work after a minute or two, try running /mod refresh in the thread to regenerate the dashboard with fresh buttons.

A build might not show in the dropdown for a few reasons:

• Wrong activity.The channel is set up for a specific activity (like "raids"), and only builds assigned to that activity appear. Check what activity the channel uses and what activity the build belongs to.
• Role gate.The build might be gated behind a role that the member doesn't have. Check with /gearcheck build-info to see if a role gate is set.

If you score very low on the same build multiple times in a row, the failsafe system locks the build for you. This prevents score spamming.

To get unlocked, ask a mod to review your screenshots and either override your score or unlock the build. They can see your submissions in the thread using /mod info.

Template installation requires the Subscriber or Premium tier. If you're on the Free tier, the command will be rejected. Check your tier with /admin settings.

If you are on the right tier and it still fails, make sure you have Manage Server permission. Also check that the template name is correct. The autocomplete dropdown will show you available templates.

Share codes can have usage limits and expiration dates. If the code was already redeemed the maximum number of times, or if it has passed its expiration date, it won't work anymore.

Ask the person who generated the code to create a new one with /pack share. They can also check the status of their existing codes with /pack my-shares.

Importing shared packs also requires the Subscriber or Premium tier on the receiving server.