Skip to content

🎒 Events

On Bot Creation Scope

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

No description provided.

define [the] [new] bot (with name|named) %string%

No examples provided.

On Discord Command

|Since|v3.0|class:version| |Cancellable|Yes|class:version|

Custom DiSky discord command system. Arguments works like the normal skript's one and accept both optional and require arguments.

discord command <([^\s]+)( .+)?$>

discord command move <member> <voicechannel>:
    prefixes: !
    trigger:
        reply with mention tag of arg-2
        move arg-1 to arg-2

event-user
event-guild
event-discordcommand
event-guildchannel
event-member
event-bot
event-message
event-string

On Disky Command

|Since|v4.0.0|class:version| |Cancellable|Yes|class:version|

Fired when a disky/discord command is executed.

disky command [seen by %-string%]

on disky command:

event-user
event-guild
event-discordcommand
event-member
event-bot
event-message

On Bot Join Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any bot join a new guild.

bot [guild] join[ed] [seen by %-string%]

No examples provided.

event-guild
event-bot

On Bot Leave Event

|Since|v4.11.1|class:version| |Cancellable|No|class:version|

Fired when any bot leave a guild.

bot [guild] (leave|left) [seen by %-string%]

on bot guild leave:
    broadcast "%event-bot% left %event-guild%"

event-guild
event-bot

On Shutdown Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a bot is stopped.

bot (shutdown|stop) [seen by %-string%]

No examples provided.

event-bot

On Guild Ready Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a guild is fully loaded.

guild (ready|load[ed]) [seen by %-string%]

No examples provided.

event-guild
event-bot

On Ready Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a bot is fully loaded. 'guild ready' should be called before this one.

(ready|bot load[ed]) [seen by %-string%]

No examples provided.

event-bot

On DiSky Error / Exception

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any DiSky error occur. Since DiSky exception are per-event only, this regroup every exception occurred in every events.

disky (error|exception)

No examples provided.

event-string

On Guild AFK Channel Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a afk channel of a guild changes can be used to get the old/new channel, the author and the guild.

[discord] guild afk channel (change|update) [seen by %-string%]

on guild afk channel change:

event-guild
event-bot
event-voicechannel

author

On Guild AFK Timeout Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a afk timeout of a guild changes can be used to get the old/new timeout value, the author and the guild.

[discord] guild afk timeout (change|update) [seen by %-string%]

on guild afk timeout change:

event-guild
event-bot

author

On Guild Ban Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user is banned from a guild. A member doesn't exist here because the member is not in the guild anymore! Can be used to get the banned user, the author and the guild.

[discord] guild [user] ban [seen by %-string%]

on guild ban:

event-user
event-guild
event-bot

author

On Guild Banner Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a banner of a guild changes can be used to get the old/new banner, the author and the guild.

[discord] guild banner (change|update) [seen by %-string%]

on guild banner change:

event-guild
event-bot
event-string

author

On Guild Boost Count Update

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a boost count of a guild changes - can be used to get the old/new count, and the guild.

[discord] guild boost count (change|update) [seen by %-string%]

on guild boost count change:

event-integer
event-guild
event-bot

author

On Guild Boost Tier Update

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a boost tier of a guild changes - can be used to get the old/new tier, and the guild.

[discord] guild boost tier (change|update) [seen by %-string%]

on guild boost tier change:

event-guild
event-bot
event-string

author

On Guild Icon Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the icon of a guild changes can be used to get the old/new icon, the author and the guild.

[discord] guild icon (change|update) [seen by %-string%]

on guild icon change:

event-guild
event-bot
event-string

author

On Invite Create Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a invite is created in a guild can be used to get the invite property, the author and the guild.

[discord] guild invite create [seen by %-string%]

on guild invite create:

event-guild
event-invite
event-bot

author

On Invite Delete Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a invite is deleted from a guild can be used to get the invite property, the author and the guild.

[discord] guild invite delete [seen by %-string%]

on guild invite delete:

event-guild
event-bot
event-channel

author

On Guild Join Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the bot joins in a guild.

[discord] bot join guild [seen by %-string%]

on bot join guild:

event-guild
event-bot

On Guild Log Entry Create Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a new log entry is created in a guild.

[discord] guild log [entry] create [seen by %-string%]

on guild log entry create:

event-guild
event-logentry
event-bot

author

On Guild Name Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the name of a guild is changed can be used to get the old/new name.

[discord] guild name (update|change) [seen by %-string%]

on guild name change:

event-guild
event-bot
event-string

author

On Guild Owner Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a owner of a guild changes can be used to get the old/new owner, the author and the guild.

[discord] guild owner (change|update) [seen by %-string%]

on guild owner change:

event-guild
event-member
event-bot

author

On Guild Splash Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a banner of a guild changes can be used to get the old/new banner, the author and the guild.

[discord] guild splash (change|update) [seen by %-string%]

on guild splash change:

event-guild
event-bot
event-string

author

On Guild Unban Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user is unbanned can be used to get the unbanned user, the author and the guild.

[discord] guild [user] unban [seen by %-string%]

on guild unban:

event-user
event-guild
event-bot

author

On Button Click

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any button sent by the button is clicked. Use 'event-button' to get the button id. Don't forget to either reply or defer the interaction. Modal can be shown in this interaction.

button click[ed] [seen by %-string%]

No examples provided.

event-button
event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

On Entity Dropdown Click

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when an user select one or more choice in an entity dropdown. Use 'event-dropdown' to get the dropdown id. Don't forget to either reply or defer the interaction. Use 'selected entities' to get the selected entities. Modal can be shown in this interaction.

entit(y|ies) drop[( |-)]down click[ed] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-dropdown
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

On Message Command

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when someone click on a message application command. Use 'event-string' to get the command name. Don't forget to either reply to the interaction. Defer doesn't work here. Modal can be shown in this interaction.

message command [receive[d]] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

On Modal Receive

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a modal has been sent to the bot from any user. Use 'event-string' to get the modal id. Don't forget to either reply or defer the interaction. Modal can NOT be shown in this interaction.

modal (click[ed]|receive[d]) [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-string
event-threadchannel

On Slash Command

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user execute a specific slash command. Use 'event-string' to get the command name. Don't forget to either reply or defer the interaction, You can only defer using the wait pattern e.g: 'defer the interaction and wait [silently]. Modal can be shown in this interaction. You can get value of arguments using 'argument "name" as string' for example.

slash command [receive[d]] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-string
event-threadchannel

On Slash Completion

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when Discord ask an argument completion. Use 'event-string' to get the command name. Use normal return effect to return the actual completions. Modal can NOT be shown in this interaction.

slash completion [receive[d]] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-string
event-threadchannel

On String Dropdown Click

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when an user select one or more choice in a string dropdown. Use 'event-dropdown' to get the dropdown id. Don't forget to either reply or defer the interaction. Use 'selected values' to get the selected string values. Modal can be shown in this interaction.

drop[( |-)]down click[ed] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-dropdown
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

On User Command

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when someone click on an user application command. Use 'event-string' to get the command name. Don't forget to either reply to the interaction. Defer doesn't work here. Modal can be shown in this interaction.

user command [receive[d]] [seen by %-string%]

No examples provided.

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-string
event-threadchannel

On Member Accept Screen Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member has agreed to membership screen requirements it can be useful for adding roles since the member is not available if they haven't accepted it yet.

[discord] [guild] member screen accept [seen by %-string%]

on member screen accept:

event-guild
event-member
event-bot
event-boolean

On Member Avatar Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member changes their avatar.

[discord] [guild] member avatar (change|update) [seen by %-string%]

on member avatar change:

event-guild
event-member
event-bot
event-string

On Member Boost Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member starts or stops boosting a guild can be used to get the old/new boosting time and the guild.

[discord] [guild] member boost (change|update) [seen by %-string%]

member boost change:

event-guild
event-bot

author

On Member Join Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member joins a guild.

[discord] member join[ed] [guild] [seen by %-string%]

on member join:

event-guild
event-member
event-bot

On Member Nickname Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member changes their nickname.

[discord] [guild] member nickname (change|update) [seen by %-string%]

on member nickname change:

event-guild
event-member
event-bot
event-string

On Member Leave Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member is removed from a guild either by leaving or being punished. Use the ban/kick event instead to check the exact reason

[discord] member (leave|left) [guild] [seen by %-string%]

on member leave:

event-guild
event-member
event-bot

On Role Add Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member adds roles to another member, it's a log action so event-author returns who made the action event-roles returns a list of added roles

[discord] [member] role add[ed] [seen by %-string%]

on role add:

event-guild
event-member
event-bot

On Role Remove Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member removes roles from another member, it's a log action so event-author returns who made the action event-roles returns a list of removed roles

[discord] [member] role remove[d] [seen by %-string%]

on role remove:

event-guild
event-member
event-bot

On Member Voice Join Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member joins a voice or a stage channel, also fires when a member moves to another channel

[discord] [member] voice [channel] join [seen by %-string%]

on voice channel join:

event-guild
event-member
event-bot
event-audiochannel
event-stagechannel
event-voicechannel

On Member Voice Leave Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member leaves a voice or a stage channel

[discord] [member] voice [channel] leave [seen by %-string%]

on voice channel leave:

event-guild
event-member
event-bot
event-audiochannel
event-stagechannel
event-voicechannel

On Message Delete

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any message is deleted. Use 'event-string' to get the old message content, only works if this message was cached by DiSky before hand. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

message delete[d] [seen by %-string%]

No examples provided.

event-guild
event-newschannel
event-number
event-guildchannel
event-bot
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

author

On Message Edit

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any message is edited / updated. Use 'event-string' to get the old message content, only works if this message was cached by DiSky before hand. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

message edit[ed] [seen by %-string%]

No examples provided.

event-guild
event-newschannel
event-guildchannel
event-bot
event-textchannel
event-privatechannel
event-message
event-string
event-threadchannel

On Message Receive

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when any bot receive an actual message. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

message receive[d] [seen by %-string%]

on message received:
    if message is from guild:
        reply with "I just received '%event-message%' from %mention tag of event-channel%!"
    else:
        reply with "I just received '%event-message%' from %mention tag of event-user%!"

event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-message
event-threadchannel

On Reaction Add

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a message, that can be seen by the bot, receive a reaction. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

(reaction|emote)[s] add[ed] [seen by %-string%]

No examples provided.

event-emote
event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-threadchannel

message

On Reaction Remove All

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when an user remove every reactions from a message. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

(reaction|emote)[s] (remove[d] all|clear|reset) [seen by %-string%]

No examples provided.

event-guild
event-newschannel
event-guildchannel
event-bot
event-textchannel
event-privatechannel
event-threadchannel

message
author

On Reaction Remove

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when an user remove a reaction from a specific message. This will be fired, by default, both guild & private messages, use the 'event is from guild' condition to avoid confusion.

(reaction|emote)[s] remove[d] [seen by %-string%]

No examples provided.

event-emote
event-user
event-guild
event-newschannel
event-guildchannel
event-member
event-bot
event-textchannel
event-privatechannel
event-threadchannel

message

On Role Color Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the color of a role changes.

[discord] [guild] role color (update|change) [seen by %-string%]

on role color change:

event-role
event-guild
event-color

On Role Create

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a role is created in a guild

[discord] [guild] role create[d] [seen by %-string%]

on role create:

event-role
event-guild
event-bot

author
author

On Role Delete

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a role is deleted from a guild.

[discord] [guild] role delete [seen by %-string%]

on role delete:

event-role
event-guild
event-bot

author

On Role Hoist Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the hoist state of a role changes.

[discord] [guild] role hoist[ed] (update|change) [seen by %-string%]

on role hoist change:

event-role
event-guild
event-bot
event-boolean

author

On Role Icon Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the icon of a role changes.

[discord] [guild] role icon (update|change) [seen by %-string%]

on role icon change:

event-role
event-guild
event-bot
event-string

author

On Role Name Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the name of a role changes.

[discord] [guild] role name (update|change) [seen by %-string%]

on role name change:

event-role
event-guild
event-bot
event-string

author

On Role Permission Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the permissions of a role changes.

[discord] [guild] role permission[s] (update|change) [seen by %-string%]

on role permissions change:

event-role
event-guild
event-bot

author

On Role Position Change

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when the position of a role changes.

[discord] [guild] role position (update|change) [seen by %-string%]

on role position change:

event-integer
event-role
event-guild
event-bot

author

On Thread Join Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member joins a tread, either by joining itself or by a moderator can be used to get the thread, the guild and the member.

[discord] thread join [seen by %-string%]

on thread join:

event-guild
event-member
event-bot
event-threadchannel

On Thread Leave Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a member leaves a thread, either by leaving itself or by a moderator can be used to get the thread, the guild and the member.

[discord] thread leave [seen by %-string%]

on thread leave:

event-guild
event-member
event-bot
event-threadchannel

On User Activity Order Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user in a guild changes its activity. Ex: by playing something different can be used to get the old/new activities.

[discord] user activity [order] (change|update) [seen by %-string%]

on user activity change:

event-user
event-guild
event-member
event-bot

On User Avatar Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user changes its avatar.

[discord] user avatar (change|update) [seen by %-string%]

on user avatar change:

event-user
event-bot
event-string

On User Discriminator Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user changes its discriminator.

[discord] user discriminator (change|update) [seen by %-string%]

on user discriminator change:

event-user
event-bot
event-string

On User Name Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user changes its name (not nickname).

[discord] user name (change|update) [seen by %-string%]

on user name change:

event-user
event-bot
event-string

On User Online Status Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user changes its online status.

[discord] user online status (change|update) [seen by %-string%]

on user online status change:

event-user
event-guild
event-member
event-bot
event-onlinestatus

On User Typing Event

|Since|v4.0.0|class:version| |Cancellable|No|class:version|

Fired when a user starts typing in a channel.

[discord] user typ[e|ing] [seen by %-string%]

on user typing:

event-user
event-guild
event-member
event-bot

On Track Event

|Since|v2.0.0|class:version| |Cancellable|No|class:version|

Fired when a track receive a specific event. Use the literal to define the event's type such as: - START - END - STUCK - PAUSE - RESUME - SEEK

track [event] %trackeventtype%

on track play:
on track end:
on track exception:

event-guild
event-audiotrack
event-bot
event-trackeventtype