Documentation

Staff Tools

Moderator Guide

Moderators keep GearCheck running smoothly: evidence misses, wrong threads, support tickets, manual reviews, and everything between.

Who Counts as a Mod?

By default, anyone with one of these permissions can use mod commands:

  • Administrator permission
  • Manage Messages permission

You can also configure a specific mod role using /mod set-mod-role role:@Officers. Anyone with that role will have access to all mod commands, even without Manage Messages.

Score Overrides

This is probably the mod tool you will use the most. When someone has the right build but automated evidence parsing gave them a bad score, you can set a score floor.

/mod override build:tank-build score:85

The override sets a floor, not an exact score. If the member later submits better evidence and gets 90%, the score stays at 90%. The floor only kicks in when the automated score is lower than the override.

When to use overrides

  • You can clearly see the gear is correct in the submitted evidence, but the parser missed things due to image quality, formatting, or a known catalog gap.
  • The build spec is missing aliases, and you do not want to make the member wait while you fix them. Override now, fix aliases later.
  • A game update changed item names, and the build spec has not been updated yet.

Thread Transfers

Sometimes the wrong person starts a gearcheck thread, or someone needs to verify on a different character. The transfer command lets you change who owns the thread.

/mod transfer user:@SomePlayer

This updates the thread ownership and resets the workflow. The new owner starts fresh with the build selection. Run this command inside the thread you want to transfer.

Dashboard Refresh

If the dashboard in a thread gets out of sync, for example if buttons stop responding after a bot restart, you can force a refresh:

/mod refresh

This regenerates the entire dashboard message with fresh buttons and the latest state. All existing scores and progress are preserved. The old dashboard message gets replaced with a new one.

Monitoring Active Workflows

Want to see who is currently going through a gearcheck? The active command gives you an overview of all in-progress workflows.

/mod active

This shows you thread names, owners, selected builds, and current status. Useful for keeping an eye on things during verification sessions, or for finding threads that got abandoned.

Thread Info

For a deep look at a specific thread, run /mod info inside that thread. You will see the thread owner, which builds they have selected, their scores, any overrides that have been applied, and the current workflow state.

/mod info

This is the first thing to check when someone reports a problem with their gearcheck. It tells you everything the bot knows about that thread.

Dashboard Review Queue

The dashboard review queue is the staff-friendly view of sessions that need human attention. It includes failed or partial checks, structured evidence summaries, links back to the Discord thread, and filters for build, activity, member, verdict, and manual-review state.

Use it when a Discord thread is too noisy or when you need to process a batch of reviews. The Discord commands still work, but the dashboard is better for sorting, filtering, comparing, and exporting.

Web Inbox

Notification rules can send messages to Discord channels, DMs, and the Web Inbox. The inbox gives staff a dashboard-native place to review alerts without hunting through Discord. It is especially useful for review queue alerts, RaidHelper readiness gaps, support ticket activity, billing attention, and operational notices.

Inbox entries are driven by the same notification rules as Discord delivery, so if an expected item is missing, check the notification rule, destination, cooldown, quiet hours, and dedupe settings.

Support Tickets

Members can submit support tickets with /support. Tickets go to the configured support user, set by the admin with /admin set-support-user, and are also visible to mods.

Viewing Open Tickets

/mod tickets

This shows all open tickets for the server, along with who submitted them and when. Review each ticket, take action such as overriding or fixing a build, and then resolve it.

Resolving a Ticket

/mod resolve-ticket ticket:42

Marks the ticket as resolved. The member who submitted it will not get a notification, so you may want to follow up in the thread or DM them if the situation warrants it.

Cleanup

Over time, threads get archived or deleted, but the bot's config entries for those threads stick around. The cleanup command prunes stale data.

/mod cleanup

This removes config entries for threads that no longer exist. It is safe to run at any time and will not affect active threads. Good practice to run periodically in busy servers.

Audit Log

If an admin has configured an audit channel with /admin set-audit-channel, the bot logs key events there automatically:

  • Score calculations and status changes
  • Mod overrides and who applied them
  • Role assignments and removals
  • Thread transfers
  • Build changes, including creates, deletes, and edits
  • Failsafe lockouts

The audit log is your paper trail. If there is ever a question about what happened or who did what, it is all there. We recommend setting this up early, especially in larger servers.

The dashboard also includes an event ledger and data inventory for staff who need searchable history, filtered exports, and a fuller view of what the guild has produced over time.

Tips for Mods

  • Check /mod info before overriding. It shows you what the bot actually saw in the evidence, which helps you decide whether the override is warranted.
  • If you keep overriding the same item, the real fix is probably adding an alias. Tell your build editor to check /pack test and update the item.
  • Run /mod active periodically during verification sessions to catch threads that are stuck or abandoned.
  • Set up the audit channel early. You will be glad you did the first time someone disputes a score.

Related