How to use Vixio (Discord bots with Skript)

[_iZ_]

 

      

    M I N E H U T  C O M M U N I T Y  F A Q

HOW TO MAKE A VIXIO DISCORD BOT

    REQUIREMENTS: Skript, Vixio

    DIFFICULTY: Medium

     

Introduction to Vixio

Vixio is one of the many Skript addons that are available on Minehut. It allows you to make a fully functional and customizable Discord bot using Skript’s syntax along with Vixio’s syntax in a normal Skript (.sk) file. Because the bot is made this way, the functionality is only limited to what Skript allows you to do. In this tutorial, you will learn how to set up a Vixio bot and some common functionalities that come along with it.     

 

Application Setup

The first thing you’re gonna need to do when setting up a Vixio bot is to make the application. An application is the discord terminology for a bot, and setting it up is as easy as clicking a few buttons. 

First, go to https://discord.com/developers. If this is your first time visiting this page, you may be prompted to log-in using your discord account. Simply log-in and you should be brought to the applications page. 

Next, you need to create your application. Click the “New Application” button at the top-right of the page to do so. Once you’ve done that, you will be prompted to create a name for your application. This can be anything, and it can be changed at any time once it’s been created.

After your application has been created, you can input your bot’s general information. This includes the name, description (optional) and a profile picture. Again, this information can all be changed in the future by visiting this same page. (Note: Be sure to save your changes before leaving this page)

Once you’ve entered the general information for your bot, go to the “Bot” tab and click the “Add Bot” button. In the “Privileged Gateway Intents” section, be sure to enable “Server Members Intent”. If you do not do this, your bot will not work. Be sure to also disable the “Public Bot” option. Doing this will make sure that the bot will not be able to be invited to other servers unless invited by you. (Note: The bot will function the same way in any server it is in, so for security reasons, you are going to want to leave this disabled)

After you’ve done this, go to the “OAuth2” tab. Scroll down until you see the section called “Scopes”. From there, select “bot” and select the permissions you wish to grant your bot. Since you are making this bot for personal use and are coding it from scratch, I recommend choosing the “Administrator” permission so that you can make it do anything without having to worry about giving it additional permissions. (Note: Giving your bot this permission will allow it to do anything on any Discord servers it is in)

Once you’ve done all of this, copy the URL that has been generated and paste it into a new tab. You will be prompted to add it to a server. Select the server you wish to add the bot to and click “Authorize”. You will most likely be asked to complete a captcha for security reasons. After doing this, you should be brought to another page advising you to close that tab. (Note: Keep the developer portal open, you will need it later)

Your bot should now be in your server. Although it is there, it will have no functionality because it hasn’t been configured to do anything. You will also notice that your bot is offline. This is because bots need to be told when to log-in and log-out. In any case when using Vixio, the bot will need to be logged-in using Skript and will automatically be logged-out whenever your Minecraft server stops.

 

Script Setup

Once your bot is on the server, you can start creating your script. Go back to the “Bot” tab and copy your bot token. You will need this to log-in to your bot within your script. 

Once you’ve copied your bot token, you have two options. The first option and the one I recommend is to create an option for your bot token. The second option is to paste it manually whenever you need to use it. If you are choosing the options route, I would also recommend creating an option for the name of your bot. 

options:

   token: (Your token)

   bot: Iz's Secretary

 

Once you’ve done all of this, you can add an event to log-in to your bot by using the following effect:

(login|connect) to %string% (using|with) [the] name %string%

The first %string% is the expression used for your bot token. The second is the name of your bot. (Note: Doing this twice without logging out of the bot will cause the bot to execute its actions twice. I recommend using the “on skript load” event to prevent this from happening)

Example:

on skript load:

   login to "{@token}" with the name "{@bot}"

 

Another useful effect that Vixio offers is logging out of the bot. This can be done with the following effect.

(logout [of]|shutdown) %bot/string%

The %bot/string% expression is the name of your bot.

Example:

on skript unload:

   logout of "{@bot}"

 

Here is an example of a full script to log in and log out of your bot:

options:

   token: (Your token)

   bot: Iz's Secretary


on skript load:

   login to "{@token}" with the name "{@bot}"


on skript unload:

   logout of "{@bot}"

 

Once you’ve completed the setup, your bot should now come online when your server starts!

 

Additional Information

A full list of Vixio syntax can be found here: https://olyno.github.io/VixioSite/

If you need help with Skript, a useful forum post can be found here: https://forums.minehut.com/topic/31934-how-to-use-skript/?tab=comments#comment-98786

If you need more help with Vixio, head over to the Skript discussion on the forums, or join our Discord! You can also feel free to personally message me if you have any questions related to this topic.

 

    Compiled by the Minehut Staff Team

Edited March 2, 2021 by _iz_

[Untreated]

Absolutely incredible CFAQ, _iz_. You did a great job going in-depth and explaining how to make a discord bot using Vixio. I am extremely impressed, and I hope to see more CFAQs like this from you in the future. 

[_omga]

A very nice and detailed CFAQ. Good job!

[Xcard]

Awesome i can finally make a discord bot work by myself