> For the complete documentation index, see [llms.txt](https://cosmo.atomatrix.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cosmo.atomatrix.gg/account-link-verification/installation.md).

# Installation

{% hint style="danger" %}
The Account Link Verification resource is currently unpublished on BuiltByBit and will be migrated into the Main Cosmo Resource soon. These docs are still here as a reference until that happens
{% endhint %}

## Prerequisites

* A server that you can deploy the standalone Discord Bot on.
* A Minecraft Server using a Pterodactyl panel. (Required as this bot uses the Pterodactyl API to access linked accounts).
* A Cosmo License and the API Addon.

## Minecraft Link Discord Bot set up:

1. Go to [Discord's Developer Portal](https://discord.com/developers/applications).
2. Create a new application. Set the username and, optionally, the profile picture.
3. On the left menu, click Bot.
4. Click "Create a Bo&#x74;**"** and set its username and, optionally, the profile picture (if the bot has not been created automatically already).
5. Untick "Public Bot" so other people can't just invite your bot onto their server.
6. Enable all the intents. You may have to scroll down to find these.
7. Click Copy Token. Keep this safe, ready to paste into the Minecraft config file.
8. Go to OAuth, then URL generator. For scope, select "bot" and "application.commands". For permission, tick Administrator.
9. Go to the generated link and follow the instructions to add the bot to the server of your choice.

## Minecraft server set up:

1. Add the **EssentialsX**, **EssentialsX Discord** & **EssentialsX Discord Link** plugins to your server and restart. Download Links: <https://essentialsx.net/downloads.html>
2. Edit the `/plugins/EssentialsDiscordLink/config.yml` file and put in your bot token that you copied.
3. Restart your server again.

## Cosmo Linking Discord Bot set up:

1. Go to [Discord's Developer Portal](https://discord.com/developers/applications).
2. Create a new application. Set the username and, optionally, the profile picture.
3. On the left menu, click Bot.
4. Click "Create a Bo&#x74;**"** and set its username and, optionally, the profile picture (if the bot has not been created automatically already).
5. Untick "Public Bot" so other people can't just invite your bot onto their server.
6. Enable the "Message Content" & "Server Member&#x73;**"** intent. You may have to scroll down to find these.
7. Click Copy Token. Keep this safe, ready to paste into the `settings.yml` file.
8. Go to OAuth, then URL generator. For scope, select "bot" and "application.commands". For permission, tick either Administrator or all the permissions the bot needs (view channel, send messages, embed links, use external emojis...).
9. Go to the generated link and follow the instructions to add the bot to the server of your choice.

## Deploying the bot:

* Copy the bot files into your hosting. You CAN use Pterodactyl to host this bot.
* Edit the `settings.yml` file with your information, make sure to get your license key from the Support Server and fill in your Discord Bot token.
* Install the dependencies with the command: `python3.11 -3 -m pip install -U -r requirements.txt` (The Python version may change depending on your version).
* Start the bot with: `python3.11 main.pyc` (The Python version may change depending on your version).
* Go to `commands.yml` in your main Cosmo Bot and disable the `/link` command, then restart the main Cosmo Bot. Users will need to use the link command from this bot.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cosmo.atomatrix.gg/account-link-verification/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
