gban user - shinyfinder/chatot-smogon GitHub Wiki

Availability: Select Guilds

/gban user <user> [reason]

• user: Username (id) of the person to ban
• reason (Optional): Reason for the audit log/modlog embed. Default: 'Banned from forums'

Example:

/gban user user:123456

• Chatot: Ban Member, Attach Files, View Channel, Send Messages | Send Messages in Threads
• Users: Admin

Summary: Bans specified user from every official and opted-in server.

This command allows you to ban a single user from every official Smogon server and any unofficial servers subscribed to the feature with /opt in. You have the option of selecting their username (if they are in the guild in which the command is run) or entereing their user ID. If no reason is provided, the message defaults to 'Banned from forums.' Upon completion, IDs any other Discord accounts that share a common Smogon forum account with the banned user are returned as well. You may consider running this command again for these accounts; however, Discord bans are inherently IP based.

For this command to work, Chatot must have read and post permissions in the channel in which the command is used (the Attach Files permission is needed in case the output would exceed Discord's post character limit). The user who initiated the command will be prompted with a y/n selection, which they respond with in a message. Their followup message must be one of the two choices, otherwise the command will exit. All messages from other users will be ignored before the user has confirmed their intent. The initiator has 1 minute to respond.

Upon total success, the bot will post something along the lines of

I have banned the user from every server I am in.

in the channel in which the command was initiated. If the bot was unable to ban a user from one of its servers, it will instead respond with which servers it had trouble in and something along the lines of the following message

I attempted to ban the provided id(s) from every server I am in, but there were some issues in some.

If logging is enabled, the bot will post an embed to the log channel in each server the user was banned. Similarly, an embed will be posted to the logging channel where the ban failed. Note that if a user is already banned from the server, no log will be emitted.

When the bot joins a new server, SS is given a prompt to mark the server as official, which enforces gbans and disables the server's ability to opt out of them. The default classification when Chatot joins a new server is unofficial opted out. If the server is marked as official, the list of gbans is automatically applied (equivalent to running /syncgban within it).

Note that errors are only relayed to SS for official servers, which ignore the opt-in state and always have gban support enabled. The table below summarizes the gban behavior for different combinations of official and opted-in servers.

The gban group of commands is only usable in the main Discord server by Senior Staff (SS) and Upper Staff.