PollUnban¶
The pollunban command (also available as pub) allows server moderators to lift a previously applied poll restriction from a member, restoring their ability to use Tux's poll creation features.
Syntax¶
The pollunban command can be used in two ways:
Slash Command:
/pollunban member:@user [reason:STRING] [silent:true/false]
Prefix Command:
$pollunban @user [reason] [-silent]
Aliases:
pub
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
member |
Member | Yes | The member to restore poll access for. |
Flags¶
This command supports the following flags:
| Flag | Type | Default | Description |
|---|---|---|---|
reason |
String | No reason provided | The reason for the poll unban (positional). |
-silent |
Boolean | False | If true, Tux will not attempt to DM the user. |
reason¶
The reason for restoring poll access, logged in the moderation case and included in the DM notification. In the prefix command, this is a positional flag. In slash commands, it is a standard argument.
- Type: String
- Default: "No reason provided"
-silent¶
Whether to suppress the DM notification to the user.
- Type: Boolean
- Default: False
- Aliases:
-s,-quiet
Permissions¶
Bot Permissions¶
Tux requires no special Discord permissions for this command, as it is handled internally via its database.
User Permissions¶
Users need appropriate moderation permissions to use this command.
Permission System
Command permissions are configured per-guild using Tux's dynamic permission system. Configure via /config commands or see the Permission Configuration guide.
Usage Examples¶
Basic Poll Unban¶
Restoring poll access for a member.
/pollunban member:@user reason:"Manual release"
With Reason¶
$pollunban @user Behavior improved, restriction lifted
Response¶
When executed successfully, Tux will:
- Update its internal database to remove the poll ban for the user.
- Attempt to DM the user informing them they can once again create polls (unless
-silentis used). - Create a new moderation case for the poll unban.
- Post a confirmation message in the current channel.
- Log the action in the designated moderation log channel.
Error Handling¶
Common Errors¶
Error: Lacking Permission Rank¶
When it occurs: Your internal Tux permission rank is lower than what's required to use this command.
Solution: Contact a server administrator to check your rank.
Error: User Not Poll Banned¶
When it occurs: You attempt to unban a user who does not have an active poll restriction.
Solution: No action needed.
Related Commands¶
/pollban- Prevent a member from creating polls./cases- View the moderation history for poll bans.