Utility Commands

This module contains generally useful, atomic commands that aren't otherwise categorized into a dedicated module.

These commands might be safe for use by anyone, or locked behind in-Discord permissions.

NSFW Images Detection Tools

As part of its moderation tooling, GiselleBot implements an (experimental) NSFW images detection system using TensorFlow.js as its base.

The detection system is based on Infinite Red's NSFW JS library and GantMan's Inception v3 Keras Model for NSFW detection to classify any image as a composition of 5 categories:

• Drawings: Safe for work drawings (including anime).
• Hentai: Hentai and pornographic drawings.
• Neutral: Safe for work neutral images.
• Porn: Pornographic images, sexual acts.
• Sexy: Sexually explicit images, not pornography.

The module was furtherly converted into a back-end module and customized with a caching system to enhance its performance.

Here's an example of an output of this command, and the corresponding censored image:

Server-related Tools

/serverinfo

Command Syntax

/serverinfo

Command Description

Prints a bunch of info about the current server.

Permissions Needed

• User: None.

Examples

/serverinfo

/invites create

Command Syntax

/invites create [channel:{channel}] [expires_after:{time code}] [max_uses:{number}] [temporary:{true/false}] [unique:{true/false}] [alias:{text}]

Command Description

Creates an instant invite to the current server. All parameters are optional, here are the meanings of each parameter and the default values:

• channel selects a target channel for the invite. The user running the command must have "Manage Server" and "Create Instant Invite" permissions in the target channel. Default: the current channel.
• expires_after sets how long the invite should last (use the time code syntax, e.g. 1h). Default: no expiration.
• max_uses sets the maximum number of uses for the invite. Default: unlimited uses.
• unique creates a unique invite if true, or uses an existing one with similar settings otherwise. Timed invites are always unique by default. Default: false (use an existing if available).
• temporary sets whether members that joined via the invite should be automatically kicked after 24 hours if they have not yet received a role. Default: false.
• alias adds an optional label (maximum 32 characters long) to the invite. If the Members logger with invites tracking is active (refer to the Logger section in the Administration module documentation) the alias will be shown in /invites usage. Default: no alias.

Permissions Needed

• User: Manage Server, Create Instant Invite. Discord's command-permissions picker only gates on Manage Server; Create Instant Invite is a separate in-code check (see Layer 3).
• Bot: Create Instant Invite

Examples

/invites create
/invites create channel:#welcome expires_after:1h max_uses:10 alias:launch-event

/invites prune

Command Syntax

/invites prune [max_uses:{# of uses (inclusive) to consider invites "unused"}] [user:{user}] [channel:{channel}]

Command Description

Deletes unused invites (invites with 0 uses), or invites under a certain number of uses (inclusive). You can specify the number of uses to consider an invite as "unused" with max_uses (default: 0).

You can filter by invite creator through the user option, or by invite target channel through the channel option.

Up to 100 invites will be pruned for each command use. If you need to prune more than that, use the command multiple times. This command might be slow and seem temporarily unresponsive for high amount of invites being pruned.

Permissions Needed

• User: Manage Server. Also re-checked in-code, not just gated by Discord's command-permissions picker (see Layer 3).
• Bot: Manage Server

Examples

/invites prune user:@cycloptux
/invites prune channel:#greeter max_uses:5

/invites usage

Command Syntax

/invites usage [user:{user}] [channel:{channel}]

Command Description

Shows usage stats about active invites in the current server.

You can filter by invite creator through the user option, or by invite target channel through the channel option.

Permissions Needed

• User: Manage Server. Also re-checked in-code, not just gated by Discord's command-permissions picker (see Layer 3).
• Bot: Manage Server

Examples

/invites usage
/invites usage channel:#welcome

Message-related Tools

/rawmessage

Command Syntax

/rawmessage message:{message id or link} [channel:{channel}]

Command Description

Shows a specific message content in its "raw" version, making markdown-formatted messages or embeds easy to copy and paste.

Embeds can be re-sent through GiselleBot using /send embed. This might not work 100% of the times for complex embeds.

Permissions Needed

• User: None.

Examples

/rawmessage message:123456789098765432
/rawmessage message:123456789098765432 channel:#rules
/rawmessage message:https://discord.com/channels/533372744130363392/534171951732752394/534751296847216642

/savechat

Command Syntax

/savechat [count:{# of messages}] [channel:{channel}]

Command Description

Dumps a certain number of messages from the given channel (defaults to the current channel) into a .csv file.

The file will be sent to the author of the command via Direct Message. Instead of receiving the actual file as Discord attachment, the author will receive:

• An URL to an encrypted .zip file containing the actual .csv.
• The password to decrypt the archive.

If count isn't specified, the default value of 150 messages will be used. The maximum number of messages you can save is 2000.

Permissions Needed

• User: Manage Messages. Also re-checked in-code, not just gated by Discord's command-permissions picker (see Layer 3).

Examples

/savechat count:500

/emojify

Command Syntax

/emojify text:{word(s) to convert, or one emoji name} [verbose:{true/false}]

Command Description

Converts a sequence of words into a sequence of emojis, provided the bot has access to the emojis.

Emoji names are case-sensitive.

By default, this command only tries to fetch emojis from the current server, effectively limiting its usefulness.

By setting one, or more, server(s) as emojify source servers (see below), GiselleBot will look for emojis in those servers as well as the current server when /emojify is used.

Setting verbose to true looks up that one emoji name instead of converting text, and shows which server it was fetched from.

Permissions Needed

• User: None.

Examples

/emojify text:BlobOwO BlobPats
/emojify text:BlobOwO verbose:true

Delete DM Message (context menu)

How to use it

Right-click one of the bot's messages in your DM with it -> Apps -> Delete DM Message.

Description

Deletes that direct message. This can be particularly useful as a privacy/security feature to delete previously sent passwords to encrypted archives, in order to make them completely unrecoverable.

Role-related Tools

/role members

Command Syntax

/role members role:{role} [format:{mention/id}]

Command Description

Prints the list of users that currently have the specified role. Users will be printed using their username (default behavior), but you can use the format option to specify whether you want the list to be printed using the user IDs or mentions.

The list will always be sorted in alphabetical order based on the users' usernames.

Permissions Needed

• User: None.

Examples

/role members role:@Discord Moderator
/role members role:@Verified format:id

/role add

Command Syntax

/role add role:{role} [user1:{user}] [user2:{user}] [user3:{user}] [user4:{user}] [user5:{user}] [everyone:{true/false}]

Command Description

Adds a role to up to 5 individual users, or to everyone in the server (set everyone:true instead of picking users - this asks for confirmation before running, since it affects the whole server).

Permissions Needed

• User: Manage Roles. Discord's command-permissions picker for /role itself is open to everyone; Manage Roles is enforced in-code for this subcommand (see Layer 3).
• Bot: Manage Roles

Examples

/role add role:@Discord Moderator user1:@cycloptux user2:@NaviKing
/role add role:@Verified everyone:true

/role remove

Command Syntax

/role remove role:{role} [user1:{user}] [user2:{user}] [user3:{user}] [user4:{user}] [user5:{user}] [everyone:{true/false}]

Command Description

Removes a role from up to 5 individual users, or from everyone in the server (set everyone:true instead of picking users - this asks for confirmation before running, since it affects the whole server).

Permissions Needed

• User: Manage Roles. Discord's command-permissions picker for /role itself is open to everyone; Manage Roles is enforced in-code for this subcommand (see Layer 3).
• Bot: Manage Roles

Examples

/role remove role:@Discord Moderator user1:@cycloptux user2:@NaviKing
/role remove role:@Verified everyone:true

Role Menus

/rolemenu posts a set of buttons in a channel that let members assign or remove one of your server's self-assignable roles by clicking.

/rolemenu create

Command Syntax

/rolemenu create group:{role group} [channel:{channel}]

Command Description

Posts a new self-assignable role menu for the given role group. Defaults to the current channel if channel is omitted.

Permissions Needed

• User: Manage Roles

Examples

/rolemenu create group:Colors
/rolemenu create group:Colors channel:#roles

/rolemenu remove

Command Syntax

/rolemenu remove [message_id:{message id}] [channel:{channel}]

Command Description

Deactivates a role menu - its buttons stop working, but the message itself is not deleted. Defaults to the most recent role menu message in the given channel (or the current channel) if message_id is omitted.

Permissions Needed

• User: Manage Roles

Examples

/rolemenu remove
/rolemenu remove message_id:123456789098765432

/rolemenu update

Command Syntax

/rolemenu update [message_id:{message id}] [channel:{channel}]

Command Description

Refreshes a role menu's buttons to match its role group's current roles (useful after adding/removing roles from the group). Defaults to the most recent role menu message in the given channel (or the current channel) if message_id is omitted.

Permissions Needed

• User: Manage Roles

Examples

/rolemenu update
/rolemenu update message_id:123456789098765432

Other Tools

URL Shortener (dashboard)

/snowflake

Command Syntax

/snowflake id:{Discord snowflake}

Command Description

Extracts the time from a valid Discord snowflake, showing it in multiple relative and absolute formats.

Permissions Needed

• User: None.

Examples

/snowflake id:123456789098765432