Commands

Rewards Enforcement

Per-user voltage ban system with automatic server tag enforcement. Banned members are blocked at the source — their messages are not stored and game wins are not recorded — so no voltage accrues while a ban is active. They are also excluded from the leaderboard and reward distributions, and their wallet operations are restricted. The auto-enforcement background task runs every 15 minutes — no manual scanning required.

/rewards ban

Ban a member from voltage ranking and wallet operations. While banned, the member's messages are not stored and game wins are not recorded, so no new voltage accrues. They are immediately removed from the leaderboard, excluded from reward distributions, and their /points transfer, /credit, and /debit operations are blocked.

/rewards ban <member> <reason> [public] [channel]
  • member — The member to ban.
  • reason — Reason for the ban (required).
  • public — Optional. Yes/No. Posts the ban embed publicly to the channel.
  • channel — Optional. Route the public embed to a specific channel.

Requires: Discord Administrator OR economy admin (see /settings → Economy → Admin Roles / Admin Members)

Triggers an immediate leaderboard refresh and posts an audit log entry to the Moderation slot of your Audit Logs (every rewards ban is treated as a member sanction; configure under /settings → Audit Logs → Moderation).

/rewards unban

Lift an active voltage ban from a member, restoring their leaderboard eligibility and wallet access.

/rewards unban <member> [reason] [public] [channel]
  • member — The member to unban.
  • reason — Optional reason for lifting the ban.
  • public — Optional. Yes/No. Posts the unban embed publicly.
  • channel — Optional. Route the public embed to a specific channel.

Requires: Discord Administrator OR economy admin (see /settings → Economy → Admin Roles / Admin Members)

Records the unban timestamp and reason. Triggers an immediate leaderboard refresh and posts an audit log entry to the Moderation slot of your Audit Logs.

/rewards bans

View the server's full voltage ban history, paginated at 10 entries per page. Active bans are listed first (newest-first), followed by inactive bans. Auto-bans issued by the tag enforcement system are marked with a 🔴 [AUTO] badge.

/rewards bans [public] [channel]
  • public — Optional. Yes/No. Posts the ban list publicly.
  • channel — Optional. Route the public embed to a specific channel.

Requires: Discord Administrator OR economy admin (see /settings → Economy → Admin Roles / Admin Members)

/rewards tagscan

Enable or disable the periodic server tag enforcement scan for this server. Turning it off immediately lifts all active auto-bans and removes their wallet restrictions, then reports how many were lifted. Turning it on resumes enforcement — the next automatic scan runs within 15 minutes.

/rewards tagscan <on|off>
  • on — Enable periodic server tag enforcement. Next scan runs within 15 minutes.
  • off — Disable enforcement. All active auto-bans are lifted immediately and a leaderboard refresh is triggered.

Requires: Discord Administrator OR economy admin (see /settings → Economy → Admin Roles / Admin Members)

Tag scan defaults to enabled for all servers. The same toggle is also available under `/settings → High Voltage → Administrative` as a `🏷️ Tag Scan: On/Off` button, with identical behaviour (including the auto-ban lift on disable). Disabling is non-destructive for manually-placed bans — only auto-bans (auto_ban=True) are lifted when turned off. Re-enabling does not retroactively re-ban anyone; the next scheduled scan will re-evaluate all members.

/rewards scantag

Manually trigger a server tag compliance scan for all members holding the High Voltage role. Returns a 3-view navigation embed: Scan Summary (members checked, bans issued, bans lifted, already compliant), Banned Members, and Unbanned Members.

/rewards scantag [public] [channel]
  • public — Optional. Yes/No. Posts the scan result publicly.
  • channel — Optional. Route the public embed to a specific channel.

Requires: Discord Administrator OR economy admin (see /settings → Economy → Admin Roles / Admin Members)

Requires high_voltage_role_id to be configured via /settings. If tag scan is disabled via /rewards tagscan off, this command returns an informational embed instead of running — use /rewards tagscan on to re-enable first.

Automatic Tag Enforcement

A background task runs every 15 minutes checking all members with the High Voltage role. Members not displaying the guild's server (clan) tag are automatically voltage-banned. Members with an active auto-ban who subsequently adopt the server tag are automatically unbanned. Manually-placed bans are never modified by the auto system.

Requires high_voltage_role_id to be configured. Auto-bans are flagged with auto_ban=True and attributed to the bot. Audit log entries are posted as [REWARDS AUTO-BAN] and [REWARDS AUTO-UNBAN]. Silently skipped per guild if the High Voltage role is not configured. When a member is auto-banned, Voltcord immediately sends a message in the channel where they last spoke, mentioning them and explaining the ban. The message is followed by the Voltage How embed showing active multipliers and eligible channels. If the member has not sent any message since the bot started, the notification is silently skipped.