Verification Module¶
The Verification Module links Discord accounts to Torn accounts and automatically synchronises nicknames and roles - so your server always reflects who each member actually is in Torn.
Guild Module
This module is configured per Discord server via Guild Configuration.
Overview¶
When a member verifies, the bot confirms their Torn identity via the API and then applies configured roles and a formatted nickname. Roles can be assigned based on server membership, faction membership, or specific faction positions (e.g. Leader, Co-leader, or custom position names).
Verification can happen manually via /verify, automatically on join (if configured), or in bulk via /verifyall. Members can re-run /reverify to refresh their roles and nickname if their Torn details have changed.
Override roles allow specific members to be excluded from automated nickname or role syncing.
Common Misconfiguration
Position names in the verification config are case-sensitive and must match exactly as they appear in Torn.
Key Features¶
- Link Discord accounts to Torn accounts via Torn API key
- Role assignment by server membership, faction membership, or faction position
- Multiple nickname sync formats (Username, Username [ID], [Tag] Username, etc.)
- Optional welcome message sent to new server members
- Bulk verification via
/verifyall - Role override and nickname override roles to protect specific members
- Auto-verification on member join
Commands¶
| Command | Description | Permission Required |
|---|---|---|
/verify |
Link your Discord account to your Torn account | None |
/reverify |
Refresh your Torn info, roles, and nickname | None |
/verifyall |
Bulk verify all unverified members in the server | Verify All |
Tip
/verify accepts an optional user parameter - staff can use this to verify a specific member on their behalf.
Prerequisites¶
- A Guild API Key must be set (public or limited access).
- Verification roles must be configured in Guild Config - Verification Module.
Configuration¶
This module is configured via the Guild Config - Verification Module page.
| Setting | Default | Summary |
|---|---|---|
| Verification Roles | null |
Sub-menu to configure roles for members, factions, and positions |
| Role Override Role | null |
Role that prevents automated role removal for a member |
| Nickname Sync | Username [ID] |
Format applied to verified members' nicknames |
| Nickname Override Role | null |
Role that prevents automated nickname changes for a member |
| Welcome Channel | null |
Channel where welcome messages are sent for new members |
| Welcome Message | Welcome {user} to {guild_name} |
Message text sent in the welcome channel |
Nickname Sync Formats¶
| Format | Result |
|---|---|
| Disabled | Nicknames are not changed |
| Username Only | TornUsername |
| Username [ID] | TornUsername [12345] |
| [FacTag] Username | [TAG] TornUsername |
| [FacTag] Username [ID] | [TAG] TornUsername [12345] |
| Username [ID] [FacTag] | TornUsername [12345] [TAG] |