/usercards_rescan — Reconcile & refresh all cards
One-shot maintenance pass that makes the server’s user cards match reality.
Access
- Moderator-only — requires the Discord permission Manage Server.
- Must be used in a server channel (not DMs). The result is sent ephemerally.
What it fixes
- Rules / RoE agreement
- Adds/removes the corresponding roles so roles match the reactions.
- Nickname claim & reviews
- If a member has an “accept” reaction on the Nickname message but has no pending/verified record and no open review, it opens a pending nickname review for them.
- If a member removed their Nickname reaction, it clears any pending/verified state.
- User cards
- Updates (or recreates) the embed for each member in the configured “users list” channel.
- Card color reflects: Rules, RoE, and Nickname status (✅ verified / ✔️ pending / ❌ not done).
- Uses a stable footer marker (
UID:<id>
) to find/edit the right card; cleans up duplicates.
Expected output
The command replies (ephemeral) with counts like:
Reconciled from messages. Changes — Rules: 3, RoE: 2, Nickname (added): 1, Nickname (removed): 0. Refreshed cards for 154 members.
Setup notes
- Relies on your configured IDs (ENV/INI): Rules/RoE/Nickname message IDs and their role IDs, the Full Access role, the user-cards channel, and the mod/modlog channels.
- Won’t ping anyone; all posts/edits are sent with no mentions.
Tips
- Run after importing a server, restoring from backup, or after downtime.
- Large servers: this may take a moment while it walks members and edits cards. It’s safe to run again.