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
Configuration Panel:
/cog name_enforcement
| Setting | Description |
|---|---|
| Enabled | Toggle the Name Enforcement system on or off. |
| Banned Words | Disallow any name containing specific words or phrases. |
| Disallowed Names | Disallow exact display names (one per line). |
| Immune Roles | Roles allowed to bypass nickname enforcement. |
| Immune Users | Specific users allowed to bypass nickname enforcement. |
| Reset | Restore all enforcement settings back to defaults. |
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
- Explain rules to users when joining
- Be consistent with enforcement
- Exempt special cases appropriately
- Document banned words clearly
- Consider cultural sensitivity