Getting started with Reto

A quick-start guide into configuring Reto with the /setup command.

Welcome to Reto! Before you can begin using the bot, you (or a Server Moderator) will need to set up the server first so the bot knows just how to behave. Whenever you're ready to start using Reto, write the /setup command to get started.

You can return to this command at any time if you wish to make any changes in the future!

When you run Setup, you'll see two options: Advanced setup and Quick setup.

If you're coming from Reto Legacy, Quick setup is the same actions the bot would perform in its original ?setup command.

If you're a newcomer to Reto, we recommend you select the Quick setup command. It'll take care of almost everything for you! If you want to tinker more, the rest of the guide will help you go through the rest of the Advanced setup guide.

Introduction to Reactables

Reactables the name Reto has for any reaction emojis that the bot will perform functionality with when triggered. The rest of this guide will help you configure the default Reactables for you.

You can learn more about Reactables on its dedicated page.

You'll be able to see what each does before adding it to your server. If the functionality does not interest you (for example, you wish not to include a Minus reaction so people can only up-vote each other), you can press the Skip button on any step of the setup process.

Karma

Plus and Minus Reactables

The Plus and Minus reactables are the core functionality of Reto. It overlays a Karma system in your community: when someone reacts with any of these, the person who wrote the message, as well as the message itself, will receive +1 or -1 to their Karma totals. They can check this in /profile and /leaderboards, and see the best-voted posts in /discover, along other uses.

The first step on your setup will be configuring what default emoji you'll want for this reactable. Reactables can have many emoji that trigger them, but this'll be the one that will be considered the "official" one. Select one with the drop-down menu to advance to the next step.

Alongside the top emojis from your server, the drop-down includes the most often used emoji in the community for any given built-in Reactable. You can select any of these if you choose.

If you're indecisive, we recommend you go with the Reto default set, as they're clear to understand for new users and people who already have the Reto bot in another server.

Pinning

Pin Channels

With Reto, you can pin your favourite messages to a special channel for all to see. Think of this like sticking your drawing in the fridge. These days, you may be familiar with this functionality from bots like Starboard.

If you wish to add pinning to your server, you can select a Pinnable Channel. You can let Reto create one for you (named #best-of by default, but it can be renamed afterwards) or you can assign one that already exists in your server.

Pin Threshold

If you've created a Pinnable Channel and want the masses to be able to pin messages for you, you can now set a Pin Threshold. This will send the message to the channel automatically when it reaches a certain amount of Karma you define. This functionality is optional, so you may skip it if you only want certain moderators to be able to pin messages. If you choose to Set a Threshold, a pop-up will appear that'll allow you to choose how much Karma is required to send messages to the channel. For smaller servers, we recommend you use anywhere between 3 to 5 Karma.

You can also create custom Pin Thresholds after setup is complete.

Pin Reactable

This reactable, when interacted with, will automatically send whatever message it's interacted with to the channel you assigned no matter the karma amount. You may skip this if you only want Karma to determine what messages get pinned or not.

This is meant for moderators. In the next step, you'll be able to choose if you want to role lock the reactable you just created. Selecting Create a new role (@Curator) will automatically assign you the newly-created Curator role. After you're done with the setup, remember to assign this role to all other moderators that wish to have this permission. Selecting other roles that already exist in your server will not assign you them automatically, and you'll have to apply them manually if you currently don't have them.

Karma customization

Karma name

Users have two counters: a Global Karma that increments in all servers they're on, and your server's specific Karma count.

You can personalize your server by giving your Karma system a different name, if you wish. Press the Rename button, or Skip to default to [Your server name] Karma.

Similarly to the Pin Threshold setting, you'll be greeted with another pop-up you can use to rename the Karma system to your liking.

Karma Emoji

As a short-hand, an emoji is used to signify Karma in places like your profile and pinned messages. You can select any from the list, including the Reto default.

The list will only display custom emoji you have in your server. If you want to use a generic Discord emoji, you can change it using the /karma emoji set command after setup is complete.

Server setup

Public servers

While not currently implemented, in the future, SFW messages above a Karma threshold may be shown with the /discover global command for people to find. If you're a publically accessible and well moderated server, select Set server as Public. Otherwise, Set server as Private.

⚠️ /discover global is currently unimplemented. This is a pre-emptive measure for a future update.

Reto Newsletter

If you want to know what's new with the Reto bot as new updates come out (rarely!), you can Subscribe to the Newsletter. This will send major bot updates to your Pinnable Channel as they become available.

If you do not want this, you can select Get minimal news. This will only and exclusively notify you when breaking updates are introduced (major versions that need you to make changes on your server to continue operating, End of Service updates, etc.)

After-setup

With this, you've completed the Advanced Setup for your Reto bot. A guide for your server members to get started is automatically sent to the Pinnable Channel, if you've created one. Otherwise, you or anyone else can consult the changes you've made with the /guide command.

The Setup process is merely an introductory guide to Reto. If you're not satisfied, you can still customize your bot further.