📘 Effects
Publish/Crosspost Message
Publish or crosspost a message to a news channel. This will only work if the message is in a news channel.
Execute X Using Bot
|Since|v4.0.0|class:version|
This effect is for utilities purpose. It will wrap the actual effect from DiSky and execute it using the specified bot. The syntax MUST come from DiSky, and at least ONE bot MUST be loaded (if the specified one is wrong / not loaded)
Change
|Since|v4.0.0|class:version|
No description provided.
(add|give) %objects% to (%~objects%) (with|using) %-bot%
increase %~objects% by (%objects%) (with|using) %-bot%
give %~objects% (%objects%) (with|using) %-bot%
set %~objects% to (%objects%) (with|using) %-bot%
remove (all|every) %objects% from (%~objects%) (with|using) %-bot%
(remove|subtract) %objects% from (%~objects%) (with|using) %-bot%
reduce %~objects% by (%objects%) (with|using) %-bot%
(delete|clear) (%~objects%) (with|using) %-bot%
reset (%~objects%) (with|using) %-bot%
Manage Command Permissions
|Since|v4.0.0|class:version|
This effect allows you to manage the permissions of slash commands, with the following rules: - By default, the command is marked as ENABLED, and anyone can see & use it. - You can DISABLE completely the command (first pattern), only admins will be able to use it. - Or you can ENABLE the commands for specific PERMISSIONS (second pattern).
EffUpdateCommand
|Since|v4.0.0|class:version|
No description provided.
Unregister Command
|Since|v4.0.0|class:version|
Unregister a specific slash command from local or global context of a bot. You must provide the command's name. Keep in mind this SHOULD NOT be used! The best way remains to update bot's commands without the command you want to delete!
OpenModal
|Since|v4.0.0|class:version|
No description provided.
Archive / Unarchive Thread
|Since|v4.4.0|class:version|
Archive or unarchive a specific thread.
Ban Member
|Since|v4.0.0|class:version|
Bans a member from a guild.
Connect / Disconnect Bot
|Since|v4.9.0|class:version|
Connect or disconnect a bot to a specific audio channel (or disconnect it from the current one). The bot must have the required permissions to connect to the channel. If using the disconnect pattern, only the guild will be required.
CreateAction
|Since|v4.0.0|class:version|
No description provided.
Create Emote
|Since|v4.0.0|class:version|
Create a new emote in a specific guild. The name must be between 2 and 32 chars and the guild should not have an emote with the same name. The URL will represent the image, and can be either a web URL or a local path.
create new emote named "test" with url "https://static.wikia.nocookie.net/leagueoflegends/images/a/ae/This_Changes_Everything_Emote.png/revision/latest/scale-to-width-down/250?cb=20211019231749" in event-guild and store it in {_emote}
make emote with name "test2" with path "plugins/path/image.png" in event-guild and store it in {_emote}
CreateInvite
|Since|v4.0.0|class:version|
No description provided.
Create Post
|Since|v4.4.4|class:version|
Create a new post in a forum channel. The output value will be the newly created thread channel.
Create Scheduled Event
|Since|v4.0.0|class:version|
Create a new scheduled event in a specific channel or at a specific place. If you use the second pattern (without channel), you'll have to specify the guild where the event will be created, and a start & end date. If you use the first pattern (with channel), you'll just have to specific the channel itself and a start date. Scheduled events currently only support stage & voice channels.
Create Thread
|Since|v4.0.0|class:version|
Create a new thread in a text channel with a base name. The bot used in that effect will automatically join the thread, so you don't have to make it join yourself. If you create a private thread, then you cannot specify a message. Else, the Thread will be created based on the specified message. Creating private thread need the guild to be level 2 or more, else it'll throw an exception.
Defer Interaction
|Since|v4.0.0|class:version|
Only usable in interaction event, currently button click/dropdown update/modal event! This will force the interaction to be acknowledge, you have 3 seconds to do so, the effect will send a success message to Discord or hold the interaction to send a message later. Keep in mind that replying in an interaction event will automatically defer the interaction, and therefore you don't need to defer it. If you need to wait more than 3 seconds use the and wait pattern An interaction can only be deferred once!
Destroy Discord Entity
|Since|v4.0.0|class:version|
Destroy on Discord the wanted entity.
Edit Message
|Since|v4.4.0|class:version|
Edit a specific message/interaction hook to show a new rich or simple message. The interaction hook will only be editable for the next 15 minutes once it's sent!
Kick Member
|Since|v4.0.0|class:version|
Kick a specific member out of its guild. You can also specify a reason if needed.
Load Members
|Since|v4.0.0|class:version|
Load every members of a guild. This effect will also cache members that were not, so execution may be delayed. consider calling this effect once, then use the default member expression to get the members.
Lock / Unlock Thread
|Since|v4.4.0|class:version|
Lock or unlock a specific thread.
Move Member
|Since|v4.0.0|class:version|
Move a member to another voice chat. You can only move a member if they were previously in a voice channel.
Move Role Above/Under Role
|Since|v4.0.0|class:version|
Move a specific role above or under another role within the same guild. The indexes will be updated automatically.
Mute Member
|Since|v4.0.0|class:version|
Mute or unmute a member in their guild.
Open Private Channel
|Since|v4.0.0|class:version|
Opens a private channel with a specific user. The opened channel can be null and an exception can be thrown if the user does not accept message.
Post Message
|Since|v4.4.0|class:version|
Posts a message to a message-channel. You can send messages in a text, private, news, post or thread channel.
Purge Messages
|Since|v4.0.0|class:version|
Discord provide a better way to delete multiple messages at once. This effect only works with messages, and a list is recommended here. If you want to delete a single message, use the destroy effect.
Reply With
|Since|v4.4.0|class:version|
Reply with a specific message to the channel where a message-event was triggered. It can also be used to acknowledge & reply to an interaction, such as button click or slash command. In interaction only, you can use the keyword 'hidden' to reply with an ephemeral message (only the executor can see it). Therefore, the value stored in the variable, if specified, will be an interaction hook, and not a compete message. You can also provide a message as reference. The replied message be linked with the provided one.
RetrieveBans
|Since|v4.0.0|class:version|
No description provided.
RetrieveEmotes
|Since|v4.0.0|class:version|
No description provided.
RetrieveEmotes
|Since|v4.0.0|class:version|
No description provided.
RetrieveInvite
|Since|v4.0.0|class:version|
No description provided.
RetrieveInvites
|Since|v4.0.0|class:version|
No description provided.
Retrieve Logs
|Since|v4.11.0|class:version|
Retrieve the audit logs of a guild.
RetrieveMember
|Since|v4.0.0|class:version|
No description provided.
RetrieveMessage
|Since|v4.0.0|class:version|
No description provided.
Retrieve Messages
|Since|v4.0.0|class:version|
Retrieve last X messages from a specific message channel. You can retrieve up to 100 last messages, others will be ignored. Don't forget to use 'purge' effect to delete a lot of messages the most enhanced way ever.
RetrieveOwner
|Since|v4.0.0|class:version|
No description provided.
Retrieve Profile
|Since|v4.0.0|class:version|
Retrieve the profile of the specified user. Profile represent mainly the banner of the user, could return the accent color if non set.
Retrieve Sticker
|Since|v4.0.0|class:version|
Retrieve a sticker from a guild using its per-guild name. This will return a sticker from the guild, not a global one.
Retrieve Stickers
|Since|v4.0.0|class:version|
Retrieve every stickers (and cache them) from a specific guild.
Retrieve Thread Members
|Since|v4.0.0|class:version|
Retrieve every members (and cache them) from a specific thread.
Retrieve Threads
|Since|v4.0.0|class:version|
Retrieve every threads (and cache them) from a specific guild. This effect will only get back the ACTIVE thread, and will pass on the archived ones.
RetrieveUser
|Since|v4.0.0|class:version|
No description provided.
RetrieveEventValue
|Since|v4.0.0|class:version|
No description provided.
Send typing
|Since|v4.0.0|class:version|
Sends the typing status to discord. This is what is used to make the message "X is typing..." appear. Typing status lasts for 10 seconds.
Shutdown Bot
|Since|v4.0.0|class:version|
Stop and disconnect a loaded bot from DiSky & discord. If any requests was still remaining, they will be executed before the actual bot shutdown Using the force pattern will cancel all requests and shutdown the bot instantly.
Suppress Reaction
|Since|v4.1.1|class:version|
Suppress one or more reactions of a message. You can also specific the user who added the emote to remove it one time. Without any specified user, it will be the bot's self user that removes the emote.
TimeOut Member
|Since|v4.0.0|class:version|
Timeout a member (temporal exclusion) for a specific duration and with an optional reason. You can either timeout UNTIL a specific date (Skript date), or FOR a specific timespan (Skript timespan). This also can be used to remove the current time out, if the bot has the permission to do so.
Unban User
|Since|v4.0.0|class:version|
Unbans a user from a guild.
Return
|Since|v4.0.0|class:version|
No description provided.
Download Attachment
|Since|v4.0.0|class:version|
Download the specific attachment to a file path.
EffAddField
|Since|v4.0.0|class:version|
No description provided.
Add Welcome Screen Channel
|Since|v4.10.0|class:version|
Add a channel to the welcome screen of a guild. Can only be used in a 'modify welcome screen' section.
discord command setup <guild>:
trigger:
modify welcome screen of arg-1:
change the screen description to "Welcome to the server! Please read the rules and get roles before chatting."
add channel with id "937001799896956991" named "Read our rules" with reaction "?" to the screen
add channel with id "952199041335316520" named "Get roles" with reaction "??" to the screen
Welcome Screen Description
|Since|v4.10.0|class:version|
Change the description of the welcome screen. Can only be used in a 'modify welcome screen' section.
discord command setup <guild>:
trigger:
modify welcome screen of arg-1:
change the screen description to "Welcome to the server! Please read the rules and get roles before chatting."
add channel with id "937001799896956991" named "Read our rules" with reaction "?" to the screen
add channel with id "952199041335316520" named "Get roles" with reaction "??" to the screen
Play First Track
|Since|v4.9.0|class:version|
Play the specified track in the specified guild. You can specify either the track must be forced to play, and interrupt the current one.