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

Name Validation

  • Pingable Check: Detect names with insufficient ASCII characters
  • Automatic Correction: Change invalid names to account usernames
  • Immune Roles: Allow certain roles to bypass enforcement
  • Immune Users: Specific users exempt from enforcement

Enforcement Rules

  • ASCII Requirement: Minimum consecutive ASCII characters
  • Unicode Handling: Process special characters appropriately
  • Account Fallback: Use account name when display name invalid
  • Notification: Inform users of name changes

Moderation Tools

  • Manual Enforcement: Force name checks on all users
  • Banned Words: Prevent certain words in names
  • Audit Logging: Track all name enforcement actions
  • Appeal Process: Allow users to request exemptions

Commands

Command Description Permissions
/enforce_names Check and fix all usernames Administrator
/name_config View name enforcement settings Administrator

Configuration

  • Enabled: Toggle name enforcement
  • Immune Roles: Roles that can use any name
  • Immune Users: Users exempt from enforcement
  • Banned Words: Words not allowed in names

Best Practices

  1. Clear Communication: Explain rules to users
  2. Reasonable Requirements: Don’t be too restrictive
  3. Exemption Process: Handle special cases
  4. Cultural Sensitivity: Respect diverse naming conventions