Discord
Creates an API to send messages to a Discord channel.
How to use
Important: The Discord API is (for security reasons) only available on server side.
Simple message example
You can decide if you want to create a Discord API object based only on a webhook url (one hook + multiple players) or based on a specific player (one hook + one player).
One hook + one player
In this case an API object is created for a specific player and avatar image. This API object is used to send messages in the name of that specific player given in API object creation.
One webhook + multiple players
Alternatively you can use this code snippet (results in the same but uses request object instead of simplified message
method):
Example with modifiable embeds
Commands / Objects
exports.nss_libs:getDiscordApi(resource_name, webhook_url, username, avatar_url):NssLibsDiscordApi
exports.nss_libs:getDiscordApi(resource_name, webhook_url, username, avatar_url):NssLibsDiscordApi
resource_name
- The name of the resource that uses the Discord API. This is used to identify the resource in the console.webhook_url
- The webhook url of the Discord channel.username
(optional) - The username of the Discord bot or the name of the player that sends the message.avatar_url
(optional) - The avatar url of the Discord bot or the avatar url of the player that sends the message.
Returns a Discord API object NssLibsDiscordApi
.
NssLibsDiscordApi
NssLibsDiscordApi
create(username, avatar_url, message):NssLibsDiscordRequestApi
create(username, avatar_url, message):NssLibsDiscordRequestApi
username
(optional) - The username of the Discord bot or the name of the player that sends the message (overrides the username given inexports.nss_libs:getDiscordApi
).avatar_url
(optional) - The avatar url of the Discord bot or the avatar url of the player that sends the message ( overrides the avatar url given inexports.nss_libs:getDiscordApi
).message
(optional) - The message that is later shown in the default message body of the Discord message. Could benil
if you want to use embeds only.
Returns a request API object NssLibsDiscordRequestApi
.
message(message, temporary_webhook_url)
message(message, temporary_webhook_url)
message
- The message that is shown in the default message body of the Discord message.temporary_webhook_url
(optional) - The webhook url of the Discord channel (overrides the webhook url given inexports.nss_libs:getDiscordApi
).
setUsername(username)
setUsername(username)
username
- The username of the Discord bot or the name of the player that sends the message.
setAvatarUrl(avatar_url)
setAvatarUrl(avatar_url)
avatar_url
- The avatar url of the Discord bot or the avatar url of the player that sends the message.
setWebhookUrl(webhook_url)
setWebhookUrl(webhook_url)
webhook_url
- The webhook url of the Discord channel.
NssLibsDiscordRequestApi
NssLibsDiscordRequestApi
setUsername(username)
setUsername(username)
username
- The username of the Discord bot or the name of the player for that specific request.
setAvatarUrl(avatar_url)
setAvatarUrl(avatar_url)
avatar_url
- The avatar url of the Discord bot or the avatar url of the player for that specific request.
setContent(message)
setContent(message)
message
- The message that is shown in the default message body of the Discord message for that specific request.
enableTextToSpeech()
enableTextToSpeech()
Enables text to speech for that specific request.
addEmbed():NssLibsDiscordRequestEmbedApi
addEmbed():NssLibsDiscordRequestEmbedApi
Adds an embed object to the request and returns it api NssLibsDiscordRequestEmbedApi
.
send()
send()
Sends the request.
NssLibsDiscordRequestEmbedApi
NssLibsDiscordRequestEmbedApi
See Discord webhook documentation for more information about the Discord message embeds.
setTitle(title)
setTitle(title)
title
- The title of the embed.
setAuthor(name, url, icon_url)
setAuthor(name, url, icon_url)
name
- The name of the author.url
(optional) - The url of the author. If name was used, it becomes a hyperlink.icon_url
(optional) - The icon url of the author.
setDescription(description)
setDescription(description)
description
- The description (content) of the embed.
setUrl(url)
setUrl(url)
url
- The url of the embed.
setColor(color)
setColor(color)
color
- The color of the embed. Can be a hex color code or a decimal color code.
setImage(url)
setImage(url)
url
- The url of the image.
setThumbnail(url)
setThumbnail(url)
url
- The url of the thumbnail.
setFooter(text, icon_url)
setFooter(text, icon_url)
text
- The text of the footer.icon_url
(optional) - The icon url of the footer.
setTimestamp()
setTimestamp()
Sets the timestamp of the embed to the current time.
addField(name, value, inline)
addField(name, value, inline)
name
- The name of the field.value
- The value of the field.inline
(optional) - If the field should be inline.
Last updated