Events

Create custom events for when a user joins, a channel is created, etc.

Create custom events when a channel is created, a new user joins the server, a user is banned, and leaves or is kicked and many more. This module works like the Custom Command builder, but a command is not needed to execute the actions.

Understanding the Basics

The Custom Events module has a maximum of 3 events for free users, and unlimited for premium users. If you are having issues not being able to add a new event, or an event is not working, ensure you have less than 3 custom events created.

Please note that some options provided in the Custom Events Builder cannot be used, for obvious reasons. Below is the list:

  • All Options

  • Plain Text Reply, Embed Reply, Random Reply

  • Send a Message with attached Buttons (Reply to the command)

  • Send a Message with a Select Menu (Reply to the command)

  • Options Condition, Role Condition, User Condition, Currency Condition

All specific and special variables can be found in the variable tab, the variable list changes per event type.

Getting Started

  1. Located in the Custom Events module, you will see the "New Custom Event" section, click the "Custom Event Builder" yellow block to create a new event.

2. Select a custom event from the options currently provided:

Member Events
  • When a new user joins the server

  • When a user is banned from the server

  • When a user leaves or is kicked from the server

  • When a role is added to a user

  • When a role is removed from a user

  • When a guild member is updated

  • When a user changes their nickname

  • When a user changes their status

Channel Events
  • When a channel is created

  • When a channel is deleted

  • When a channel is updated

Thread Events
  • When a thread is created

  • When a thread is deleted

  • When a thread is updated

Message Events
  • When a new message is sent

  • When a message is updated or edited

  • When a message is deleted

Role Events
  • When a role is created

  • When a role is deleted

  • When a role is edited

Voice Events
  • When a member joins a voice channel

  • When a member switches voice channels

  • When a member leaves a voice channel

Reaction Events
  • When a reaction is added to a message

  • When a reaction is removed from a message

Boost Events
  • When a member boosts the server for the first time

  • When a member unboosts the server

Bot Events
  • When the bot joins a server

  • When the bots starts or is restarted

  • When a custom variable value changes

  • When the bot is updated through the dashboard

These options will activate when a condition is met. For instance, if a user joins your server, you can then have the bot greet them, like the announcement module, and DM them.

3. Under the yellow main block, click on it and set an "Event Nickname." This will be shown in the dashboard if you are ever looking to edit a certain event. You can name it to whatever you'd want.

Using Blocks

Action Blocks

Using action blocks are self-explanatory. Each block has its own function, and by linking them together, you can create a chain of events. If you aren't already aware on how to connect blocks, simply click and hold one dot to another to create a connection, like shown in the gif below:

On mobile, this would work in a similar fashion. Simply tap the top dot of the block you want to connect, then tap the bottom dot of the corresponding block. This may take a few attempts to get used to. You can get the list of what action blocks do here. If you are familiar with the Command Builder module, this works about the same way.

Condition Blocks

You can only use four conditions in this module, which are the Chance Condition, Channel Condition, Item Condition, and Custom Variable Condition.

Chance Condition

This allows the bot to run multiple outputs but randomly chooses them based on how likely the percentage is. (0-100, 100 being most likely)

Channel Condition

This allows the bot to run different output based on what channel the event was used.

Item Condition

The item condition will allow you to run different outputs based on the users economy inventory, view in depth.

Custom Variable Condition

This allows you to run actions based on the value of a custom variable in the Data Storage Module. Using the "Run Equation on Variable," you can set the condition to do different things depending on the value.

You can get the full list and how to use conditions here.

Variables

All specific and special variables can be found in the variable tab, the variable list changes per event type.

Last updated

Change request #491: Adding Suggestions Page