Server Management

Information

Information

The commands in this section are designed to help you manage your server. They allow you to easily assign or unassign roles from your members, set up temporary voice channels, use a ticketing system, host giveaways and events or even purge channels.

Note: All of the role-related commands require you to have the Administrator permission, alternatively you can also use them if you have one of the admin roles if the command is enabled in the admin commands.

General Role Commands

Giving a Role

You can also give a role to one or more members with a simple command. This is done by typing the following: ¹

-role give @Role @User1 @User2 @User3 ...

Example:

-role give @Member @Friendliness#1337 @Example#1234

Would give the @Member role to the users: @Friendliness#1337 and @Example#1234.

Taking a Role

Additionally, you can also take away a role from multiple users. ¹

-role take @Rolename @User1 @User2 @User3 ...

Information About a Role

This command gives you information, such as the Role ID and the amount of users, about all roles. When used with a specific role it will display who has the role. ¹

-roleinfo or -roleinfo @Rolename

Role To Role

This command gives everyone with the first role specified, the other roles you specified. ¹

-roletorole @RoleToCheck @RolesToGive...

Example:

-roletorole @Guy @Friend @Buddy

This command would give everyone with the @Guy role, the @Friend and @Buddy roles.

Role From Role

This command takes a role or several roles from everyone with the first role specified. ¹

-rolefromrole @RoleToCheck @RolesToRemove...

Example:

-rolefromrole @Guy @Friend @Buddy

This command would remove the @Friend and @Buddy roles from everyone with the @Guy role. I'm not your buddy, friend!

Mass Assigning Roles

This command allows you to assign a role to everyone who doesn't have the role yet. ¹

Note: This command has a cooldown of 5 minutes, to prevent hitting rate-limits. It may also be fairly slow but you'll get a confirmation message once it's done.

-massassign @Member would assign the @Member role to all of your server's users.

Mass Removing Roles

This command allows you to unassign a role from everyone who has a role. ¹

Note: This command has a cooldown of 5 minutes, to prevent hitting rate-limits. It may also be fairly slow but you'll get a confirmation message once it's done.

-massremove @Member would remove the @Member role from all of your server's users.

Reaction Roles

These are all commands related to the Reaction Roles feature.

Roles Command

The following command will show you all of the available reaction roles in your server.

-roles

Adding Reaction Roles

This command adds a reaction to a message, which your users can click to assign a role to themselves. If they remove their reaction from the message, they will remove the role from themselves again.

Make sure you use an emote the bot is able to see, it can add reactions in the channel where the message is and make sure the bot is listed above any roles it has to assign to users. ²

-react add [Message ID] [@Rolename] [Emote]

Example:

-react add 123456789 @Member :100:

The example above would add a reaction role to the message with the ID 123456789, if a user reacts with 💯, they'll assign the @Member role to themselves. If they remove their reaction, the @Member role will be taken away again.

Removing Reaction Roles

If you've previously set up a reaction role and you'd like to remove it again, you can use the following command. Your users will no longer be able to react to the message to assign or unassign a role to themselves. ²

-react remove [Message ID] [@Role] [Emote]

Example:

-react remove 123456789 @Member :100:

Join Roles

These are roles that will be assigned to your members as soon as they join your server.

Adding Join Roles

Adds a role, or several roles, to the list of roles that should be assigned when a user joins your server. ¹

-joinrole on @Role

Example:

-joinrole on @Member @New

The above command would assign the roles @Member and @New to anyone (not bots) who joins the server.

Removing Join Roles

Removes a role, or several roles, from the list of roles that should be assigned when a user joins your server. ¹

-joinrole off @Role

Example:

-joinrole off @Member

Trigger Roles

These are roles that automatically unassign another role(s). Picture the following scenario:

You set up the @Unsubscribe role to trigger the removal of the @Subscribed role.

A user with the role @Subscribed wants to unsubscribe, once they receive the @Unsubscribe role, the @Subscribed role will automatically be removed. ¹

Adding a Trigger Role

-triggerrole add @TriggerRole @RoleToRemove ...

Example:

-triggerrole add @Unsubscribe @Subscribed @Enlisted

This will make the @Unsubscribe role automatically remove the @Subscribed and the @Enlisted roles.

Removing a Trigger Role

-triggerrole remove @TriggerRole @RoleToRemove

Example:

-triggerrole remove @Unsubscribe @Subscribed

This will stop the @Unsubscribe role from removing the @Subscribed role.

Listing All Trigger Roles

The following command can be used to list the current Trigger Roles and the Roles they remove.

-triggerrole list

Sticky Roles

These are roles that will be reassigned to a member if they leave and rejoin the server. For example, you could make the @Muted role a Sticky Role. If someone tries to get rid of the role by leaving your server and rejoining, the bot will automatically re-assign the role to them.

Enabling Sticky Roles

This will enable the Sticky Roles feature for one or more roles. ¹

-stickyroles enable @Rolename ...

Example:

-stickyroles enable @Muted @Silenced

This command would set up the @Muted and the @Silenced roles as Sticky Roles.

Disabling Sticky Roles

This will disable the Sticky Roles feature again.

-stickyroles disable

Clearing All Saved Sticky Roles

This will clear all users of their current sticky roles.

-stickyroles clear

Affiliations

The affiliates feature is designed to showcase partnered and supported servers. It allows you to connect your server to someone else's server and to highlight your cooperation with them.

This means you can make it easy for the members of your server to find out information about your partners, like what their server is all about or how to join their server.

Note: In all of these commands, you can type aff instead of affiliate too.

Enabling Affiliations

This command will enable the Affiliates feature for your server.

-affiliate enable

Note: After enabling the feature, you'll still have to create an Embed for your server, with the -affiliate embed command.

Disabling Affiliations

This command will disable the Affiliates feature for your server again.

-affiliate disable

Creating your Embed

This command allows you to create the basic embed for your server, in here you'll be able to show the name, a description, contact information and the invite URL to your server.

To further edit your embed (with more options!) you can use -affiliate edit, after creating your basic embed.

Example:

-affiliate embed "Title here" "A description" "Contact information" "https://Invite-URL.com"

Posting your Embed

After creating your embed you can preview or post your own embed by using the following command.

-affiliate self

Editing your Embed

Using this command will start a dialogue with the bot to select which of the fields you'd like to edit.

You can also use this to reset a value, by editing it and typing RESET as the value.

Note: Resetting a field won't work for the following fields: Server Name, Server Description, Contact Information, Invite URL.

Example:

-affiliate edit

You can find an example of how this works exactly in the video below.

Linking with other Servers

This initiates a link with another server or several servers. To use this command you'll need another server's ID.

-affiliate link followed by a server's ID or several server IDs.

Example:

-affiliate link 123456 789123

The command above would link your server, with the servers that have the IDs 123456 & 789123.

Finding out the Link Status

The following command allows you to find out which servers you've successfully linked with, which servers you've linked with but haven't linked with your server yet and which servers want to link with your server.

-affiliate links

Link Status Codes:

✅ - means you've both linked with each other.
🕑 - means you're waiting for a server to link with you.
⏺ - means that server asked you to link with them.

Posting a Server's Embed

To post the embed of a server you've linked with, you can use the following command.

-affiliate post followed by a server's ID or several server IDs.

Example:

-affiliate post 123456 789123

The command above would post the embeds for the servers with IDs 123456 & 789123.

Note: To post a server's embed, both servers will need to be linked to each other. That means both servers have to have used the -affiliate link commands. To see the current status of your server links, you can type -affiliate links.

Posting all Embeds

This command will post all embeds of servers you're linked with.

Note: If you've manually removed some embeds, or some are missing, and you want to re-post them, you'll have to type -affiliate unpost all and then use this command again to post all of the embeds.

-affiliate post all

Unposting a Server's Embed

You can unpost a specific server's embed by using this command.

-affiliate unpost followed by a server ID or several server IDs.

Example:

-affiliate unpost 123456 789123

This would unpost the embeds of the servers with the IDs 123456 & 789123.

Unposting all Embeds

You can remove all embeds that have currently been posted by using the following command.

-affiliate post all

Ticketing

The bot also has a Ticketing feature built in. This allows you to pick a role for the people who are going to be handling all of the tickets.

When someone uses the -ticket command to send in a ticket, a channel will be created and that role will be mentioned. A copy of the messages in the ticket's channel will be sent to a #tickets-log channel too.

To resolve the ticket, someone with the role to handle tickets can click the ✅ emote on the ticket. To remove the ticket, they can click on the ❌ emote on the ticket.

Note: People with the Administrator permission in your server will always be able to see and handle your tickets.

Enabling Ticketing

This command will enable the Ticketing feature and creates a #tickets-log channel. The role(s) you use as argument as the role(s) that can handle the tickets.

-ticketenable @RoleName ...

Example:

-ticketenable @Administrator @Moderator

This would enable the people with the @Administrator and @Moderator roles to handle your tickets.

Disabling Ticketing

-ticketdisable

Sending in a Ticket

This is what your users can use to send in tickets. It will create a private channel and mention the roles you set up to be able to handle your tickets.

Anything sent in this channel will also be forwarded to a #tickets-log channel. ¹

-ticket, optionally followed by a message.

Purging

These commands allow you to delete a certain amount of messages in a channel or a certain amount of message from a specific user in a channel.

Note: The maximum amount of messages you can purge at once is 100.

Purge

This removes a certain amount of messages in a channel.

-purge followed by an amount.

Purge From User

This command removes a certain amount of messages in a channel, from a specific user. ³

-purgefrom @Username [Amount]

Example:

-purgefrom @Friendliness#1337 42

Events

The Events feature allows you to enable a role, for example the @EventPlanner role, to create and post events. Creating an event will make a temporary role with the name of the event.

Members of your server can enlist to get mentioned 30 minutes before the event starts and at the start of the event. They can do so by reacting to a posted event with the emote.

Note: All events will use the UTC timezone.

Enabling The Events Feature

This command will allow the specified role(s) to create, host, delete and update the events hosted in your server.

-eventsenable @Role ...

Example:

-eventsenable @Moderator @EventPlanner

This would allow people with the @Moderator or @EventPlanner role to manage your events.

Note: After enabling the events feature, you'll have to pick a channel for your event reminders to be sent to. Information about how to do so is listed in the following section.

Setting up an Events Reminder Channel

This is the channel the reminders for your events, 30 minutes before the event and at the start of the event, will be sent to.

-eventschannel #channelname

Disabling The Events Feature

-eventsdisable

Creating an Event

After enabling the events feature and selecting a channel for reminders to be sent to, the roles you specified will be able to create an event using the following command.

This will start a dialogue with the bot, asking you for details of the event.

-event

Editing an Event

A created event can always be edited afterwards, this can be done by using the following command. Editing the name of an event will also modify the temporary role that was created when the event was created. ⁴

-editevent followed by the event ID.

Canceling an Event

It's also possible to cancel an event, this will also remove the temporary role that was created when the event was created. ⁴

-cancelevent followed by the event ID.

Posting a Singular Event

You can post a single event by using this command, if you'd like to post all of your current events, you can use the -events command instead. ⁴

-postevent followed by the event ID.

Posting All Events

All events can be posted, chronologically, by using this command. Users can then react to the posted messages with the emote.

Doing so means they'll be notified 30 minutes before the event starts and right at the start of the event they signed up for.

-events

Note: Only the last posted events will allow users to sign up for the reminders.

Posting All Events - Compact (No Signups!)

This works the same way as the -events feature, the differences are: - This is a more compact way of displaying the events - Users won't be able to sign up with the emote.

-postallevents

Additional Events Role

This allows you to pick a role that should always be mentioned at the start of your event, alongside the temporary role that was created for your event.

For example the @Events role, for people with an interest in all events.

-eventsrole set @Rolename

Example:

-eventsrole set @Events

Giveaways

This feature allows you to set up giveaways. After setting up a giveaway with the dialogue, a message will be posted in the channel you picked. A winner will then be drawn when the giveaway expires, from everyone who reacted with 🎉. If that emote can't be found, it'll default to the first reaction on the giveaway mesage.

By default only users with the Administrator permission will be able to host giveaways, you can also set a role for users to be able to create a giveaway. This can be found in this section.

Hosting a Giveaway

The following command will start a little dialogue with the bot. You'll be asked what the title of the giveaway should be, where it should be posted and when the giveaway should end.

Note: These use the UTC timezone.

-giveaway

Hosting a Giveaway - No Dialogue

This command allows you to set up a giveaway, without using the dialogue.

-fastgiveaway "Title Here" #Channel "Date Here" [Amount of Winners]

Example:

-fastgiveaway "Christmas Giveaway" #giveaway "2020-12-24 23:00" 2

The command above would create a giveaway with title: Christmas Giveaway, it'll be hosted in the #giveaway channel on the 24th of December, 2020, at 11PM and there'll be 2 winners.

Setting A Giveaway Role

This allows you to pick a role or several roles that are allowed to host giveaways in your server. For example if I want to allow people with the @GiveawayHost role to set up their own giveaways.

-giveawayrole set @Rolename ...

Example:

-giveawayrole set @GiveawayHost @Moderator

This would allow anyone with either the @GiveawayHost role or the @Moderator role to host giveaways.

Removing a Giveaway Role

This command will remove the currently set giveaway roles.

-giveawayrole unset

Rerolling a Winner

This command lets you reroll the winner of a giveaway.

-rerollwinner followed by the ID of the ID of the giveaway.

Getting a Random Winner

This command allows you to get a random winner from any message on which people have reacted.

-randomwinner followed by the ID of the message.

Cancel a Giveaway

-cancelgiveaway followed by the ID of the giveaway.

Temporary Voice Channels

This feature allows users to set up their own temporary voice channels.

Once this feature is enabled, a user can join the voice channel with the name: Join me to create a temporary voice channel!. The name of this channel can be changed without any issues, the channel can also be moved to another category.

By modifying who can see / connect to the Join my to create a temporary voice channel! channel, you can also limit who is able to create temporary voice channels.

Important: The category Temporary Channels should not be removed. If it is removed, the feature will no longer work. If the category is empty, it will not be visible to anyone without the Administrator permission.

These channels are hidden by default and allow the user who created them to make the channel visible, allow specific users or roles to see and join them and manage all other permissions of the channel.

Note: Anyone with the Administrator permission will still be able to see and manage hidden voice channels.

Enabling Temporary Voice Channels

-tempvoice enable

Disabling Temporary Voice Channels

-tempvoice disable

Temporary Voice Commands

The following commands are only available while you're in a temporary voice channel you created. You can use these in a channel or just send the bot a DM.

Hiding a Temporary Channel

This command hides your temporary channel, so it's hidden from everyone except for the people who you explicitly gave access and anyone with the Administrator permission.

Your temporary channel is hidden by default when it's created.

-hide

Note: If anyone joined your channel while it was visible they won't be kicked out, however if they leave they won't be able to re-join it.

Showing a Temporary Channel

This command opens up your temporary channel, everyone can join and see the channel.

-show

Granting Access to your Temporary Channel

This command adds a specific user or role to the temporary channel. ³

-vcadd followed by a role or username.

Example:

-vcadd @Staff

This would give everyone with the @Staff role permission to join the channel.

Removing Access from your Temporary Channel

Removes someone's access from the temporary channel. ³

-vcremove followed by a role or username.

Example:

-vcremove @Staff

This would remove access to your temporary channel from everyone with the @Staff permission.

Note: You can also use a Role ID or name of a Role instead of mentioning the role. It's also possible to use the ID of users instead of mentioning them. ↩
Note: You can also use a link to a message instead of a Message ID and the ID or name of a Role instead of mentioning the role. ↩
Note: You can also use a user's ID instead of mentioning them. ↩
Note: The event ID can be found when creating an event or after an event has been posted. ↩