> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# How to Host Discord Bots
> Learn to create and host Discord bots on Square Cloud. Complete tutorial with configuration, deployment, and practical examples in Node.js and Python.
export const RecommendedPlan = ({lang, plan, tier, cpu, appType}) => {
const url = `https://squarecloud.app/${lang}/pay?plan=${plan.toLowerCase()}&tier=${tier}`;
if (lang == 'en') {
return
Wondering how much RAM and CPU your plan needs to host {appType}?
Don't worry, we're here to help.
Our {plan} plan offers {tier}GB of RAM and {cpu}vCPU, which should be sufficient for most {appType}.
However, if you are working on a larger project and seeking extra stability, we recommend considering our Pro plan. With additional resources, you can maintain stability even during demand spikes.
To purchase, simply click here.
;
} else {
return
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar {appType}?
Não se preocupe, estamos aqui para ajudar.
Nosso plano {plan} oferece {tier}GB de RAM e {cpu}vCPU, o que deve ser suficiente para a maioria dos {appType}.
No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro.
Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda.
Para comprar, basta clicar aqui.
;
}
};
export const appType_0 = "a Discord bot"
## Introduction
To develop and host {appType_0} on Square Cloud, it's essential to follow a structured sequence of configurations and prerequisites. This technical guide will cover the entire process, from initial setup to production deployment.
### Prerequisites
* **Square Cloud Account**: Register through the [signup page](https://squarecloud.app/en/signup) using your email.
* **Active Paid Plan**: Ensures dedicated resources and optimized performance for your application. Check our [available plans](https://squarecloud.app/en/pricing) and choose the most suitable for your needs.
## Creating project
To create a Discord bot is fundamental to have an account on it for creating and managing bots on the platform. If you don't have one, visit the [official Discord website](https://discord.com/) to create your account.
### Bot application on Discord
Access the [Developer Portal](https://discord.com/developers/applications) and click "New Application". Define a name for your bot and click "Create" to create the application.
After creating the application, navigate to the "Bot" tab and click "Reset Token" to generate the authentication token. Copy the generated token for later use in code implementation.
With the token configured, activate the necessary intents. Stay in the "Bot" tab, scroll down and locate "Privileged Gateway Intents". Activate the intents as shown in the image:
**Critical Security**: Keep your bot token in absolute secrecy. This token grants total control over the bot and should be treated as confidential information.
### Developing project
Now that we have the bot token, we can start coding. You can use your favorite language to do it.
**Node.js Environment Setup**
1. Verify that Node.js is installed on your system. If not, download it from the [official Node.js website](https://nodejs.org/).
2. Initialize a new Node.js project:
```bash Terminal theme={null}
npm init -y
```
3. Install the Discord.js library:
```bash Terminal theme={null}
npm install discord.js
```
4. Create a JavaScript file (e.g., `index.js`) and add the following code to create a basic Discord bot:
```javascript index.js theme={null}
const { Client, GatewayIntentBits } = require("discord.js");
const client = new Client({
intents: [
GatewayIntentBits.Guilds,
GatewayIntentBits.GuildMessages,
GatewayIntentBits.MessageContent,
],
});
client.on("ready", () => {
console.log(`${client.user.tag}!`);
});
client.on("messageCreate", (message) => {
if (message.content === "!hello") {
message.reply("Hello!");
}
});
client.login("your token here");
```
**Python Environment Setup**
1. Verify that Python is installed on your system. If not, download it from the [official Python website](https://www.python.org/).
2. Install the discord.py library using pip:
```bash Terminal theme={null}
pip install discord.py
```
3. Create a Python file (e.g., `main.py`) and add the following code to create a basic Discord bot:
```python main.py theme={null}
import discord
from discord.ext import commands
intents = discord.Intents.default()
intents.message_content = True
client = commands.Bot(command_prefix='!', intents=intents)
@client.event
async def on_ready():
print(f'{client.user}')
@client.command()
async def hello(ctx):
await ctx.reply('Hello!')
client.run('your token here')
```
4. Create a `requirements.txt` file to list all external libraries needed for your project:
```txt requirements.txt theme={null}
discord.py
```
## Deploying
After preparing your project files, you can now upload them to Square Cloud and host your project.
To do so, create a ZIP file containing all your project files.
### Via dashboard
Access the [upload page](https://squarecloud.app/en/dashboard/new) and upload your project zip file.
After uploading your zip, you will need to configure the name, main file or runtime environment and other settings for your project.\
If you are uploading a web project, make sure to select "Web Publication" and set a subdomain to your project.
Finally, click on the "Deploy" button to host your project on Square Cloud.\
After deployment, you can monitor your project's status and logs from the dashboard.
### Via CLI
To use this method, you need to create a config file named `squarecloud.app` in the root directory of your project. This file will contain the necessary configuration for your project.
The squarecloud.app file is a configuration file that will be used to configure your application; it will be used to define your environment.
First, you need to have the CLI installed in your environment. If you don't have it yet, run the following command in your terminal:
```
npm install -g @squarecloud/cli
```
If you already have it, we recommend updating it. To do this, run the following command in your terminal:
```bash theme={null}
squarecloud update
```
```bash theme={null}
curl -fsSL https://cli.squarecloud.app/install | bash
```
Now, to authenticate and use other CLI commands, you will find your authorization key [here](https://squarecloud.app/en/account/security) by clicking on "Request API Key". After obtaining your authorization key, run the following command:
```bash theme={null}
squarecloud auth login
```
Finally, to deploy your application to Square Cloud using the CLI, you need to run the following command:
```bash theme={null}
squarecloud upload
```
Or if you created the zip manually, you can use:
```bash theme={null}
squarecloud upload --file
```
## Testing the Bot
If you followed all the steps correctly, the next step is to invite your bot for testing. To do this, follow these steps:
1. Access the [Developer Portal](https://discord.com/developers/applications).
2. Select your bot.
3. Navigate to the "OAuth2" tab.
4. Go to "OAuth2 URL Generator".
5. Check the "bot" option.
6. Choose the permissions your bot will have when invited using this invite.
7. Below the permissions, an invite link for your bot will be generated. It should look like this:
```txt theme={null}
https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot
```
Remember that the `client_id` in the URL should be replaced with your bot's actual ID. The `permissions` value may also need to be adjusted based on the permissions you want your bot to have.
Now, to test if everything is working, execute the following command on your server: `!hello`.
## Additional Resources
For more information on creating bots with discord.py and discord.js, visit the [official discord.py documentation](https://discordpy.readthedocs.io/en/latest/) and the [official discord.js guide](https://discordjs.guide/). There, you'll find detailed guides, tutorials, and API documentation to help you make the most of these libraries.
## Contact us
If you continue facing **technical difficulties**, our **specialized support team** is available to assist you. [**Contact us**](https://squarecloud.app/en/support) and we'll be happy to help you resolve any issue.