Whitelist System

Manage trusted users and roles to prevent false antinuke triggers

Overview

The Whitelist system allows you to designate trusted users and roles who are exempt from antinuke protections. This prevents false positives when legitimate administrators or bots perform actions that might otherwise trigger antinuke punishments.

Whitelisted users and roles can perform protected actions without being punished by the antinuke system.

---

Access Control

Only the following can manage the whitelist:

• Server Owner — Full access to all whitelist features
• Extra Owners — Users added by the server owner
• Antinuke Admins — Users designated by the server owner

---

Commands

whitelist add

Add a user or role to the antinuke whitelist to exempt them from protections.

Syntax

~whitelist add <user/role>

Aliases: wl add
Permissions: Server Owner or Antinuke Admin

Always whitelist your trusted staff members and essential bots to avoid accidental punishments.

whitelist remove

Remove a user or role from the antinuke whitelist.

Syntax

~whitelist remove <user/role>

Aliases: wl remove
Permissions: Server Owner or Antinuke Admin

whitelist list

View all whitelisted users and roles for your server.

Syntax

~whitelist list

Aliases: wl list Permissions: Server Owner or Antinuke Admin

The list displays both individual users and roles that have been whitelisted.

whitelist check

Check if a specific user or role is whitelisted.

Syntax

~whitelist check <user/role>

Aliases: wl check
Permissions: Server Owner or Antinuke Admin

When checking a user, the command will also show if they’re whitelisted through any roles they have.

whitelist clear

Clear the entire antinuke whitelist (both users and roles).

This will remove ALL whitelisted users and roles. Use with caution!

Syntax

~whitelist clear

Aliases: wl clear Permissions: Server Owner or Antinuke Admin

---

How Whitelisting Works

The whitelist system operates on two levels:

User Whitelist

Individual users can be added to the whitelist by their user ID. When a user is whitelisted:

• They can perform any antinuke-protected actions
• They bypass all antinuke checks
• Their whitelist status is independent of their roles

Role Whitelist

Entire roles can be whitelisted. When a role is whitelisted:

• Anyone with that role is automatically whitelisted
• Multiple roles can be whitelisted
• Users inherit whitelist status from all their whitelisted roles

---

Whitelist Hierarchy

The whitelist system checks permissions in the following order:

1. Server Owner — Always bypasses antinuke (cannot be removed)
2. Whitelisted Users — Individually added users
3. Whitelisted Roles — Users with whitelisted roles
4. Non-whitelisted — Subject to all antinuke protections

The server owner is inherently trusted and doesn’t need to be added to the whitelist.

---

Aliases

The whitelist command has several convenient aliases for faster usage:

wl

Main alias

wl add

Quick add

wl remove

Quick remove

wl list

Quick list

wl check

Quick check

wl clear

Quick clear

---

Best Practices

1. Whitelist Essential Staff

   Add all trusted administrators and moderators to prevent false triggers during legitimate moderation actions.

   ~whitelist add @Administrator Role
   ~whitelist add @Moderator Role
   
2. Whitelist Essential Bots

   Add legitimate bots that need elevated permissions (like music bots or utility bots).

   ~whitelist add @Music Bot
   ~whitelist add @Utility Bot
   
3. Regular Audits

   Periodically review your whitelist to ensure only trusted users and roles remain.

   ~whitelist list
   
4. Remove When Necessary

   Remove users or roles when they’re no longer trusted or leave the staff team.

   ~whitelist remove @former-staff
   

---

Common Use Cases

Whitelisting Administrative Roles

~whitelist add @Administrator
~whitelist add @Server Manager
~whitelist add @Head Moderator

This ensures your administrative team can perform server management tasks without triggering antinuke protections.

Whitelisting Essential Bots

~whitelist add @Mimu
~whitelist add @Dyno
~whitelist add @Custom Bot

Legitimate bots that manage roles, channels, or server settings should be whitelisted.

Checking Whitelist Status

~whitelist check @staff-member
~whitelist check @Admin Role

Verify if a user or role is protected before they perform sensitive actions.

Cleaning Up the Whitelist

~whitelist list
~whitelist remove @inactive-user
~whitelist remove @deprecated-role

Regular maintenance keeps your whitelist secure and up-to-date.

---

Important Notes

Security Considerations

• Only whitelist users you completely trust
• Whitelisted users can bypass ALL antinuke protections
• Compromised whitelisted accounts can cause significant damage
• Review your whitelist regularly, especially after staff changes

Role-Based Whitelisting

When you whitelist a role, all members with that role are automatically trusted. This is more efficient than adding users individually but requires careful role management.

Quick Access

Use short aliases like wl add, wl remove, and wl check for faster whitelist management during active moderation sessions.

---

Troubleshooting

User still getting punished despite being whitelisted

Possible causes:

• User was added after the action was detected
• Wrong user was whitelisted
• Cache needs to refresh (wait a moment and try again)

Solution: Verify the user is correctly whitelisted with ~whitelist check @user

Can't add user or role to whitelist

Possible causes:

• You don’t have permission (need Server Owner or Antinuke Admin)
• User/role doesn’t exist or was deleted
• Invalid mention or ID

Solution: Ensure you’re using proper mentions and have the required permissions

Whitelist appears empty but users are whitelisted

Possible causes:

• Database error
• Whitelist was recently cleared

Solution: Re-add trusted users and roles, then verify with ~whitelist list