JavaScript

(for advanced users)

Index

Notes
Accessing JavaScript
Available Objects in Commands
Supported API Functions
Example

Notes

Bot Designer for Discord allows you to use JavaScript (ES2015).
Discord API is not fully supported yet.
Callbacks aren't supported in JavaScript at the moment.

Accessing JavaScript

Click on settings icon ⚙️ in the app homepage and toggle on "Enable features for advanced users".
Create a new command and set the Scripting Language to "JavaScript".

Available Objects in Commands

Name	Type	Description
`message`	string	Contains author's message.
`commandPrefix`	string	Contains the trigger of this command.
`authorId`	string	Contains the ID of the user that executed this command.
`channelId`	string	Contains channel ID where the command was used.
`userMentions`	array of string values	Contains user mentions.
`roleMentions`	array of string values	Contains role mentions.

Supported API Functions

Name	Description
`setResponse(replyText)`	Where `replyText` is a string value. Sends a message to the channel where the command was used.
`setEmbedResponse(title, description, footer)`	Where `title`, `description`, `footer` are string values. Sends a embedded message to the channel where the command was used.
`setEmbedImage(imageURL)`	Where `imageURL` is a string value. Sets image of the embedded message.
`ban(userID)`	Where `userID` is a string value. Bans a user.
`banWithReason(userID, reason)`	Where `userID` and `reason` are string values. Bans a user with reason.
`unban(userID)`	Where `userID` is a string value. Unbans the user.
`kick(userID)`	Where `userID` is a string value. Kicks a user.
`kickWithReason(userID, reason)`	Where `userID` and `reason` are string values. Kicks a user with reason.
`giveRole(userID, roleID)`	Where `userID` and `roleID` are string values. Gives a role to the user.
`takeRole(userID, roleID)`	Where `userID` and `roleID` are string values. Removes a role from the user.
`channelTyping()`	Shows "Bot is typing..." message.
`createChannel(name, type)`	Where `name` and `type` are string values (`type` must be `text` or `voice`). Creates a channel. Providing wrong `type` will result in throwing an exception which you can catch.
`removeChannel(channelID)`	Where `channelID` is a string value. Deletes a channel.
`pinMessage(channelID, messageID)`	Where `channelID` and `messageID` are string values. Pins a message.
`unpinMessage(channelID, messageID)`	Where `channelID` and `messageID` are string values. Unpins a pinned message.
`sendChannelMessage(channelID, message)`	Where `channelID` and `message` are string values. Sends `message` to the provided channel.

Example

(say command)

var text = message.replace(commandPrefix, " ") // Makes 'text' the user's message without the command trigger.
setResponse(text) // Sets the response as 'text'.