---
description: Install Swordy Bot in your Discord Server
---

# ⚔️  Set Up

Ready to add Swordy Bot to your server?

{% embed url="https://www.youtube.com/embed/JeM8oJE94zg" %}

{% hint style="info" %}
**Having trouble testing your bot?**  See the "Testing - Important!" section below.
{% endhint %}

### 1. Add the Bot

Get started by clicking the "Add Bot" button on [https://swordybot.com](https://swordybot.com)&#x20;

Then choose the server you want Swordy Bot to manage:

![](https://1942333368-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhW_lWbXbgod8GbAgnk%2F-MjLzQHTZ1Z5gjIJa-49%2F-MjM08CDH1LMzOs6ZLxQ%2Fimage.png?alt=media\&token=e7cc7983-d362-4935-82b6-9f558260bfa7)

Next you need to make sure the Bot has a **higher role than any roles it will manage.** The easiest way to achieve this is to drag the "swordy-bot-v2" role as high as possible in Roles settings.&#x20;

![](https://1942333368-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhW_lWbXbgod8GbAgnk%2F-MjVxpBtfVL2f1dWBO8o%2F-MjVyPlkl5ttClf2K_o5%2Fimage.png?alt=media\&token=96a21781-c39a-4d87-b922-a4c54434ddff)

### 2. Call the bot

In the _**same server where you added the bot,**_ type `!unlock` to start the login processs.&#x20;

![](https://1942333368-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhW_lWbXbgod8GbAgnk%2F-MjLxYoN67sQJAdjtwdk%2F-MjLy4lOwI2smrg8PIk0%2Finvoke.gif?alt=media\&token=53e97661-08f2-4d26-ac4f-e6afb1682135)

### 3. Add a token

_**If you have Discord permissions to manage roles**_, then you'll see an "Edit Guild" button. Click it to start adding tokens.

![](https://1942333368-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhW_lWbXbgod8GbAgnk%2F-MjLzQHTZ1Z5gjIJa-49%2F-MjLzafoX2M7IL5geSTp%2Fimage.png?alt=media\&token=5f28fae3-b417-40d4-9e2f-7e23f68a35f9)

Choose the role you want, and submit the token details.&#x20;

{% hint style="info" %}
**Using Unlock Protocol**? Learn how to create a new Lock here: [https://docs.unlock-protocol.com/creators/deploying-lock](https://docs.unlock-protocol.com/creators/deploying-lock) &#x20;
{% endhint %}

![](https://1942333368-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhW_lWbXbgod8GbAgnk%2F-MjLxYoN67sQJAdjtwdk%2F-MjLzKLg9Hn7EBKqsoSA%2Fimage.png?alt=media\&token=364bb83d-ef6a-4673-b8b6-a24611077a53)

🎉 Voila! You've successfully configured Swordy Bot to manage a role.

### Testing - Important!

To test your bot from the community member's perspective, **you may need to use a different Discord account**.

This is due to a safety feature from Discord to prevent rogue bots from taking over servers. TL;DR bots can't edit roles for server owners (that's probably you).

Create a new Discord account or ask a friend to help you test things out!&#x20;
