fdd336fe91
- Doc site UI improvements and fixes
- Added Discord widget
- Fixed some styling issues
- Added command docs briefs and details
- Briefs are shown in the right-hand panel
- Details can be shown by clicking `Open full details`
- Added ShaiWatchers' logo as the site favicon
- Moved HTML template to static file for responsiveness improvements
48 lines
2.1 KiB
HTML
48 lines
2.1 KiB
HTML
<h1>/usercards_rescan — Reconcile & refresh all cards</h1>
|
||
<p>One-shot maintenance pass that makes the server’s user cards match reality.</p>
|
||
|
||
<h2>Access</h2>
|
||
<ul>
|
||
<li><strong>Moderator-only</strong> — requires the Discord permission <em>Manage Server</em>.</li>
|
||
<li>Must be used in a server channel (not DMs). The result is sent <em>ephemerally</em>.</li>
|
||
</ul>
|
||
|
||
<h2>What it fixes</h2>
|
||
<ol>
|
||
<li><strong>Rules / RoE agreement</strong>
|
||
<ul>
|
||
<liReads reactions from your configured Rules and RoE messages.</li>
|
||
<li>Adds/removes the corresponding roles so roles match the reactions.</li>
|
||
</ul>
|
||
</li>
|
||
<li><strong>Nickname claim & reviews</strong>
|
||
<ul>
|
||
<li>If a member has an “accept” reaction on the Nickname message but has <em>no</em> pending/verified record and <em>no</em> open review, it opens a <em>pending nickname review</em> for them.</li>
|
||
<li>If a member <em>removed</em> their Nickname reaction, it clears any pending/verified state.</li>
|
||
</ul>
|
||
</li>
|
||
<li><strong>User cards</strong>
|
||
<ul>
|
||
<li>Updates (or recreates) the embed for each member in the configured “users list” channel.</li>
|
||
<li>Card color reflects: Rules, RoE, and Nickname status (✅ verified / ✔️ pending / ❌ not done).</li>
|
||
<li>Uses a stable footer marker (<code>UID:<id></code>) to find/edit the right card; cleans up duplicates.</li>
|
||
</ul>
|
||
</li>
|
||
</ol>
|
||
|
||
<h2>Expected output</h2>
|
||
<p>The command replies (ephemeral) with counts like:</p>
|
||
<pre>Reconciled from messages. Changes — Rules: 3, RoE: 2, Nickname (added): 1, Nickname (removed): 0. Refreshed cards for 154 members.</pre>
|
||
|
||
<h2>Setup notes</h2>
|
||
<ul>
|
||
<li>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.</li>
|
||
<li>Won’t ping anyone; all posts/edits are sent with <em>no mentions</em>.</li>
|
||
</ul>
|
||
|
||
<h2>Tips</h2>
|
||
<ul>
|
||
<li>Run after importing a server, restoring from backup, or after downtime.</li>
|
||
<li>Large servers: this may take a moment while it walks members and edits cards. It’s safe to run again.</li>
|
||
</ul>
|