Modules Documentation 101

Throughout the whole documentation website, you'll find different ways of explaining commands and a few keywords to indicate particular ways of writing a parameter.

Server/Guild, Channel, Message, Role, User IDs

Each entity in Discord is mapped with a unique ID. Knowing what an ID is, and how to get the ID of a said entity is crucial to knowing how a bot works. Obtaining an ID also requires that you have Discord's Developer Mode active.

There are a lot of guides and tutorials about how to activate Developer Mode and how to get an ID for an entity in Discord. This link will bring you to the official Discord support page about this topic.

Obtaining a role ID may be trivial: you can obtain the role ID by prepending a role mention with \, but that message will still mention the role. For most slash-command options you won't need to do this at all - Discord's own autocomplete lets you pick a user, channel, or role directly (no ID typing required), and only options that specifically ask for a raw ID (like /owner guild leave server_id) need one pasted in by hand.

Command Syntax Notation

Throughout this documentation, a command's syntax is shown as a single invocation line, for example:

/ban user:{user} [reason:{text}] [rule:{rule}] [duration:{time code}] [delay:{time code}] [delete_days:{0-7}]

Since these are real Discord slash commands, you never have to memorize this notation to actually use one - typing / followed by the command name shows every option, its description, and whether it's required, right inside Discord as you type.

Content Policy

What is not allowed

• NSFW content: pornography and sexually explicit or excessively sexual material, excessive gore or extreme violence, and content promoting or glorifying self harm, suicide or harming others.
• Sexual content involving minors, real or drawn/animated, under any circumstances.
• Illegal content, including pirated or illegally acquired material.
• Hateful, harassing, obscene or otherwise offensive content.

Where it applies

This applies to everything the bot sends, stores or processes on your behalf, in every module, whether you type it in a command, or set it up in the dashboard. That includes messages sent through GiselleBot, greeting and verification messages, form questions and messages, reminders, embeds, and any image or file you attach.

You are responsible for the custom content you configure or send through GiselleBot in your server, and the owners of the bot are not liable for content created by third parties through its features. This is why greeting and verification messages carry a disclaimer pointing to the Terms of Service.

Automatic checks

Where a feature accepts images, they may be automatically checked, and anything flagged as NSFW is dropped instead of being processed or delivered. For example, /send message and the dashboard's Message Composer drop the whole message if one of its attached images is flagged, and the AutoModerator's NSFW Images trigger lets a server act on NSFW images posted by its members.

Reporting and enforcement

Report any offensive, inappropriate, obscene, unlawful or otherwise objectionable content you come across in the bot's features as soon as possible. The bot's owners may act on that content, and on the people who posted it, at their discretion, including interrupting the service for the users involved.

Some features are explicitly marked as NSFW, and should only be used by people who are old enough to access such content in their country.

Premium Notes

A bolded Premium note on a page means that feature, or a higher limit for it, needs a Premium subscription on the server it is used in. Premium applies to a server, not to an account, and every one of those notes links to Premium Perks, which lists the two tiers, their prices, and exactly what each one raises.

Time Format Code

Standard Time Code

Time durations are indicated through the use of a standard time format, which consists of 5 (or 6) time bits:

If specified, the time code may allow an extra bit, s for second(s). Each time bit has to be prepended with an actual (positive, integer) number, or omitted if the corresponding time bit would be set to 0.

That said, a typical time code would be like this:

2mo6h40m = 2 months, 6 hours, 40 minutes

Timestamp Mentions

While the standard time code represents a time span (or duration) in an explicit form (e.g. 3 hours; 10 minutes from now; etc.), each command that supports a time code can also be used with a "timestamp mention" (refer to Message Formatting, "Unix Timestamp" or "Unix Timestamp (Styled)").

When using timestamp mentions as a time code replacement, GiselleBot will automatically convert the timestamp into the corresponding "time from now" interval to be used as time span.

This may be particularly useful in some use cases when trying to trigger an action at a certain time of a day (e.g. reminders, repeating messages, scheduled commands, etc.).