Alt Tracker Cog

The Alt Tracker cog provides functionality to link and track alternate accounts (alts) for users in your Discord server. This is particularly useful for moderation purposes to identify when users are using multiple accounts.

Features

Account Linking

  • Link Command: Use /alt link <main_user> <alt_user> to link an alternate account to a main account
  • Automatic Validation: Prevents linking the same account to itself and ensures accounts aren’t already linked
  • Moderator Only: Commands require moderator permissions or specific roles configured in the cog settings

Tracking and Management

  • Database Storage: All alt relationships are stored in a dedicated database table
  • Audit Trail: Tracks who linked accounts and when
  • Group Management: Supports linking multiple alts to one main account

Configuration Options

  • Enabled Toggle: Enable or disable the alt tracking system
  • Moderator Roles: Configure which roles can use alt tracking commands
  • Permission Checks: Integrates with Discord permissions and custom role settings

Commands

Command Description Permissions
/alt link <main> <alt> Link an alt account to a main account Moderator roles

Setup

  1. Enable the cog in your server configuration
  2. Configure moderator roles that can manage alt links
  3. Use the link command to associate accounts

Database Schema

The alt tracker uses the VorAltTrackerUsers table with fields for:

  • Server ID
  • User ID
  • Group ID (for linking multiple alts)
  • Moderator information
  • Timestamps

Security Notes

  • Only configured moderators can link accounts
  • All actions are logged for audit purposes
  • Prevents duplicate or invalid linkages