serenity

Configuration

Prefix, language, command permissions and the switches every server touches once.

Replace [prefix] with your server's prefix.

Prefix

Serenity's default prefix is ;.

// Syntax
[prefix]prefix [new prefix]

// Example
;prefix !
;prefix none

Needs Manage Server. Up to 7 characters, and none puts it back to the default.

// Syntax
[prefix]selfprefix [prefix]

// Example
;selfprefix .

A self prefix is yours alone and works in every server Serenity is in — handy if you can never remember which server uses which prefix.

Mentioning the bot always works as a prefix, no matter what you set. @Serenity help is the way back in when someone changes the prefix and forgets it.

Language

;language list
;language set german
;language reset

Sets the language Serenity answers in for this server.

Turning Commands Off

// Syntax
[prefix]command disable [scope] [command]

// Example
;command disable channel ban
;command disable server pp

scope is channel or server. [prefix]command enable reverses it, and [prefix]command list shows what's currently off.

Whole modules can go too:

;disablemodule add server fun
;disablemodule list
;disablemodule remove server fun

Restricting Commands to a Role

// Syntax
[prefix]restrictcommand add [command] [role]

// Example
;restrictcommand add ban @Senior Mod

The command then needs that role on top of its normal permission. Useful for handing a dangerous command to a subset of the people who could technically run it.

;restrictcommand list
;restrictcommand remove ban @Senior Mod

Aliases

// Syntax
[prefix]alias add [alias] [command]

// Example
;alias add p purge
;alias add yeet kick
;alias list
;alias remove p

Ignoring Channels

;ignore add #bot-spam
;ignore list
;ignore remove #bot-spam

Serenity stops responding to commands in an ignored channel. Administrators are not affected, so you can still work in there.

Automatic Roles

// Syntax
[prefix]autorole add [role]

// Example
;autorole add @Member

Every new member gets that role on join. Bots have their own list so they don't end up with your member role:

;autorole bots add @Bots
;autorole list
;autorole clear

Autorole and a verification gate work against each other — handing out the member role on join defeats the point of making people verify for it.

Image Only Channels

;imageonly add #media
;imageonly list
;imageonly remove #media

Messages without an attachment or link get deleted in those channels.

Server Appearance

With Manage Server you can change the server itself from chat:

;set name My Server
;set icon [url]
;set banner [url]
;set splash [url]

Leaving the url off and attaching an image works too.

Punishment Messages

The message Serenity posts — and the DM it sends — for every punishment can be replaced with your own embed code:

;invoke ban [embed code]
;invoke dm ban [embed code]
;invoke variables

Each of ban, unban, tempban, kick, mute, unmute, jail and unjail has both a channel version and a dm version.

Writing Embed CodeHere, you can learn about how to script embeds for commands that support this feature.