Bot de Discord desenvolupat amb Python i discord.py.
Aquest document explica com instal·lar i executar el bot des de Windows utilitzant Visual Studio Code.
Abans de comen?ar necessites:
- Windows
- Python instal·lat
- Visual Studio Code
- El projecte RebirthBot
- El token del bot de Discord
No cal instal·lar SQLite, asyncio, re, random ni altres llibreries estàndard de Python.
Descarrega Python des de la pàgina oficial:
https://www.python.org/downloads/
Durant la instal·lació és MOLT IMPORTANT activar aquesta opció:
Add Python.exe to PATH
Després continua amb la instal·lació normal.
Per comprovar que Python funciona, obre una terminal i escriu:
py --versionSi apareix una versió de Python, està instal·lat correctament.
Descarrega Visual Studio Code:
https://code.visualstudio.com/
Instal·la'l amb les opcions predeterminades.
Quan estigui instal·lat, obre Visual Studio Code.
Descarrega o clona aquest repositori:
https://github.com/fustcoma/RebirthBot
A Visual Studio Code ves a:
File → Open Folder...
i selecciona la carpeta:
RebirthBot
és important obrir la carpeta principal del projecte, no una carpeta de dins.
Hauries de veure una estructura semblant a:
RebirthBot/
│
├── commands/
├── database/
├── events/
├── utils/
│
├── bot.py
├── config.json
├── requirements.txt
├── READ.me
└── .gitignore
No cal obrir PowerShell manualment fora de VS Code.
A Visual Studio Code ves a:
Terminal → New Terminal
També pots utilitzar:
Ctrl + Shift + `
La terminal apareixerà a la part inferior de VS Code.
Comprova que estàs dins de la carpeta del projecte.
Per exemple:
PS E:\Documents\DiscordBot>
Si no estàs dins de RebirthBot, pots entrar-hi amb:
cd RebirthBotés recomanable utilitzar un entorn virtual perquè les llibreries del bot no interfereixin amb les altres instal·lacions de Python.
A la terminal de VS Code executa:
py -m venv venvAixò crearà:
RebirthBot/
└── venv/
La carpeta venv no s'ha de pujar a GitHub.
El .gitignore del projecte ja està preparat perquè Git l'ignori.
A la terminal de VS Code executa:
.\venv\Scripts\activateSi s'ha activat correctament, al principi de la terminal apareixerà alguna cosa semblant a:
(venv) PS E:\Documents\DiscordBot>
El (venv) indica que l'entorn virtual està actiu.
Si et dona error, prova de posar aquesta comanda i probar a fer un altre cop el venv
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserAmb (venv) activat, executa:
py -m pip install -r requirements.txtAquesta comanda instal·larà automàticament totes les llibreries necessàries per al bot.
No cal instal·lar discord.py ni python-dotenv manualment.
Si vols actualitzar pip abans:
py -m pip install --upgrade pipi després:
py -m pip install -r requirements.txtEl bot utilitza una variable d'entorn anomenada:
DISCORD_TOKEN
El token NO s'ha de posar directament dins de bot.py.
Crea un fitxer anomenat:
.env
a la carpeta principal del projecte:
RebirthBot/
│
├── commands/
├── database/
├── events/
├── utils/
│
├── .env
├── bot.py
├── config.json
└── requirements.txt
Dins de .env posa:
DISCORD_TOKEN=EL_TEU_TOKEN_AQUISubstitueix EL_TEU_TOKEN_AQUI pel token real del bot.
No comparteixis mai aquest fitxer ni el pugis a GitHub.
El projecte ja té .env dins del .gitignore.
Has de crear el bot des del Discord Developer Portal:
https://discord.com/developers/applications
Crea una aplicació nova i afegeix-hi un bot.
A la configuració del bot activa els intents necessaris.
Com que RebirthBot utilitza:
intents.message_content = True
intents.members = Truehas d'activar els intents corresponents al Developer Portal.
Especialment:
MESSAGE CONTENT INTENT
SERVER MEMBERS INTENT
Una vegada:
- Python està instal·lat
- VS Code està instal·lat
- el projecte està obert
- l'entorn
venvestà activat - els requirements estan instal·lats
.envestà configurat
només cal executar:
py bot.pyAixò és tot.
No cal executar cap comanda complicada.
Per no haver d'escriure cada vegada:
.\venv\Scripts\activateVS Code pot seleccionar automàticament l'entorn virtual.
Prem:
Ctrl + Shift + P
Busca:
Python: Select Interpreter
i selecciona:
.\venv\Scripts\python.exe
Després tanca la terminal actual i obre:
Terminal → New Terminal
VS Code normalment activarà automàticament:
(venv)
A partir d'aquest moment, quan obris el projecte a VS Code i una terminal nova s'activi correctament, només hauràs de fer:
py bot.pyPer aturar el bot des de la terminal:
Ctrl + C
El bot es desconnectarà de Discord.
Obre el projecte RebirthBot amb VS Code.
Obre:
Terminal → New Terminal
Si apareix:
(venv)
simplement executa:
py bot.pySi no apareix (venv), activa'l amb:
.\venv\Scripts\activatei després:
py bot.pyPython probablement no està instal·lat correctament o no s'ha afegit al PATH.
Comprova:
py --versionSi no funciona, torna a instal·lar Python i activa:
Add Python.exe to PATH
No s'han instal·lat els requirements o no està activat el venv.
Executa:
.\venv\Scripts\activatei:
py -m pip install -r requirements.txtExecuta:
py -m pip install -r requirements.txtComprova que existeix:
.env
i que conté:
DISCORD_TOKEN=EL_TEU_TOKENNo posis cometes i no deixis espais al voltant de =.
Comprova que els intents necessaris estan activats al Discord Developer Portal i que el bot té els permisos necessaris al servidor.
Una vegada instal·lat i configurat tot, el funcionament habitual és simplement:
# Obrir el projecte amb VS Code
# Obrir:
Terminal → New Terminal
# Si apareix (venv):
py bot.pyI el bot comen?arà a funcionar.
No pugis mai a GitHub:
.env
venv/
El .gitignore del projecte ja està configurat per ignorar aquests fitxers i carpetes.
Especialment, mai comparteixis el token del bot.
Si el token es fa públic accidentalment, genera'n un de nou immediatament des del Discord Developer Portal.
Aquest projecte està publicat sota la llicència MIT.
Creat per fustcoma.