Bot di utilità per il server discord AFL. Gli obiettivi principali di sviluppo attualmente sono:
- gestione dei ruoli sul server, in particolare l'assegnamento di due ruoli speciali che indichino una certa continuità nell'attività del server
- filtro dei contenuti
- comandi custom
Scritto in python (3.8+) sfruttando le librerie discord.py e dotenv.
Il bot va creato (seguendo questa guida fino al punto 4, incluso) e aggiunto al proprio server usando il seguente link
https://discord.com/api/oauth2/authorize?client_id=BOTCLIENTID&permissions=41646633118934&scope=bot%20applications.commands
sostituendo BOTCLIENTID con l'user id del bot, ricavabile dal portale sviluppatori di Discord.
Per avviare il bot:
- clonare il repo
- installare le dipendenze
pip install -r requirements.txt- creare il file config.json seguendo le indicazioni del template
- creare il file .env contenente il token di accesso del bot (è importante non condividerlo)
- il contenuto del .env deve essere
DISCORD_TOKEN=your_token - a questo punto si può avviare bot.py
Ci sono dei comandi che permettono di caricare post in tendenza da dei subreddit stabiliti dai moderatori, usando la libreria Async PRAW. Per utilizzare questa funzionalità è necessario ottenere le chiavi per API di reddit. Le istruzioni per farlo sono riportate nel quickstart sull'autenticazione.
Una volta ottenute le chiavi occorre aggiungere due entrate al file .env contenente il token del bot:
REDDIT_APP_ID=id_app_redditREDDIT_APP_SECRET=app_secret
Sarà possibile usare i comandi dopo aver riavviato il bot.
Per contribuire a questo progetto occorre essere membri del server ed aver ottenuto il ruolo "dev". Per maggiori informazioni contattare gli admin su discord o direttamente qua:
Rispettare lo stile di programmazione riportato sotto.