Name Enforcement Cog

The Name Enforcement cog automatically enforces pingable display names by detecting and correcting non-standard character names that cannot be mentioned.

Features

Automatic Name Enforcement

  • Enforces pingable names (minimum 3 consecutive ASCII characters)
  • Automatically renames non-pingable usernames to account username
  • Blocks banned words in display names
  • Runs on member join and nickname changes

Exemptions

  • Immune roles bypass all enforcement
  • Immune users remain unaffected
  • Configurable per-server basis

Commands

Command Description
/name_enforcement view_config View current configuration
/name_enforcement enforce Enforce names on all members
/name_enforcement help Display help information

Configuration

Customize name enforcement with these settings:

  • Enabled - Toggle name enforcement
  • Banned Words - Words forbidden in usernames
  • Immune Roles - Roles that bypass enforcement
  • Immune Users - Users that bypass enforcement

Name Requirements

Names must have at least 3 continuous ASCII characters (a-z, A-Z, 0-9) to be pingable.

Invalid name examples:

  • “🎮” (emojis only)
  • “ア” (non-ASCII characters)
  • “a” (single character)

Valid name examples:

  • “John” (4 ASCII characters)
  • “Player123” (mixed case and numbers)
  • “cool_name” (underscore acceptable)

Best Practices

  1. Explain rules to users when joining
  2. Be consistent with enforcement
  3. Exempt special cases appropriately
  4. Document banned words clearly
  5. Consider cultural sensitivity