SHADOWS STUDIOS
Shadows Studios Bot · Documentazione

Tutto quello che fa il bot, spiegato.

Dall'invito all'ultimo modulo: come si configura, quali permessi gli servono, cosa fa ogni funzione e tutti i comandi con le loro opzioni.
01

Primi passi

Cinque minuti dall'invito a un bot funzionante.

  1. 1Aggiungi il bot al tuo server con il bottone “Aggiungi a Discord”. Su quel server ti serve il permesso Gestisci server.
  2. 2Apri la dashboard su bot.shadowsstudios.com e accedi con Discord: vedi tutti i server che gestisci.
  3. 3Scegli la lingua che il bot usa con i tuoi membri: la prima volta che apri un server la dashboard te la chiede, poi la cambi da Impostazioni → Lingua. Le lingue sono dieci e il cambio è immediato.
  4. 4Accendi i moduli che ti servono, uno alla volta. Tutto il resto resta spento e non dà fastidio.
  5. 5Lancia /admin diagnostica: controlla i permessi del bot su ogni canale configurato e ti dice esattamente cosa manca.

Trascina il ruolo del bot sopra i ruoli che deve dare o moderare (Impostazioni server → Ruoli). Discord non lascia mai a un bot gestire ruoli più alti del suo.

02

Dashboard e /admin impostazioni

Il bot si configura in due modi, e le impostazioni sono le stesse.

  • Dashboard (bot.shadowsstudios.com): la più completa. Anteprime dal vivo, caricamento immagini, rank card, automazioni e comandi personalizzati ci sono solo qui.
  • /admin impostazioni su Discord: un pannello privato con gli stessi moduli, divisi per categoria. Comodo quando sei dal telefono.
  • Nella dashboard vedono il server chi ha Amministratore o Gestisci server e i ruoli che aggiungi come Bot master in Impostazioni. I permessi vengono controllati dal vivo su Discord a ogni richiesta.
  • I pannelli che stanno in un canale (verifica, ruoli a scelta, ticket) si pubblicano da Discord; la dashboard ne modifica le impostazioni.
  • Game Hub: Roleplay, FiveM, Diablo IV e i giochi che arriveranno stanno in un unico menu espandibile, così il menu laterale resta pulito.
  • Il mio account: Premium e pagamenti (con Gestisci o disdici per l'abbonamento), le tue richieste di assistenza, i tuoi dati e la verifica in due passaggi con Google Authenticator, che protegge il login e le operazioni importanti.
  • Guide e ricerca: ogni modulo ha una breve guida, anche su Discord con /info guida, e la barra di ricerca in alto trova qualsiasi impostazione, anche con un errore di battitura.
03

Come sono organizzati i comandi

Discord concede 100 comandi per server. Il bot raggruppa tutti i suoi in 9 categorie, il resto è tuo.

  • /mod moderazione · /rp roleplay · /ticket supporto · /community tutto per i membri · /crypto criptovalute · /admin gestione del server · /custom comandi personalizzati · /info informazioni · /richieste richieste e assenze.
  • Nomi e descrizioni dei comandi seguono la lingua del server, scelta nella dashboard: in italiano tutti vedono /mod avvisa, in tedesco /mod verwarnen. Cambiando lingua i comandi vengono registrati di nuovo.
  • Discord applica i permessi alla categoria; il bot poi controlla quelli del singolo comando ogni volta che viene usato.
  • Per scegliere chi vede una categoria: Impostazioni server → Integrazioni → Shadows Studios Bot.
04

Permessi

L'invito chiede Amministratore, così ogni modulo funziona subito. Se preferisci concedere meno, il bot ha bisogno di una base e ogni modulo aggiunge solo quello che gli serve.

  • Sempre: Visualizza canali, Invia messaggi (anche nei thread), Incorpora link, Allega file, Leggi la cronologia, Aggiungi reazioni, Usa i comandi.
  • Moderazione, Automod, Sicurezza: Gestisci messaggi, Espelli, Banna, Metti in timeout, Visualizza registro controllo.
  • Ticket: Gestisci canali, Crea thread privati, Gestisci thread.
  • Ruoli (autorole, verifica, ruoli a scelta, livelli, reparti, Tebex): Gestisci ruoli.
  • Canali vocali temporanei e AFK: Connetti, Parla, Sposta membri, Gestisci canali.
  • Inviti: Gestisci server, Crea invito. Log del server: Visualizza registro controllo.

La maggior parte dei problemi non è un bug ma un permesso che manca su un canale preciso. /admin diagnostica lo trova per te, con il nome esatto del permesso.

05

Ticket

Canali di supporto privati con modulo di apertura, presa in carico e trascrizioni.

  1. 1Imposta la categoria predefinita con /ticket configura impostazioni e crea almeno un tipo di ticket: ogni tipo ha categoria, ruoli staff, canale log, domande e messaggi propri.
  2. 2Pubblica il pannello con il bottone di apertura: /ticket configura pannello.
  3. 3Un membro clicca, compila il modulo e ottiene un canale privato ticket-0001 che vedono solo lui e lo staff.
  4. 4Dentro il ticket: prendi in carico, chiudi, chiudi con motivo, aggiungi o togli persone.
  5. 5Alla chiusura il bot salva la trascrizione completa, una pagina web in stile Discord inviata nel canale log e, se vuoi, in privato. Il canale diventa closed-…: lo staff può riaprirlo finché non viene eliminato, dopo le ore che scegli.
  • Fino a 5 domande nel modulo di apertura (testo breve, testo lungo o tendina), per ogni tipo di ticket.
  • Più tipi di ticket e più pannelli (Premium): ogni tipo ha categoria, staff, chi può chiuderlo, colore e modulo propri; fino a 25 dalla dashboard.
  • Chiusura automatica per inattività, limite di ticket aperti per membro, blacklist, valutazione da 1 a 5 stelle.
  • Ticket solo per acquirenti: il modulo chiede l'ID della transazione Tebex e lo verifica prima di aprire.
06

Moderazione e Automod

I comandi classici con il controllo della gerarchia dei ruoli, più i filtri automatici.

  • /mod ban (anche a tempo, es. 3g), /mod espelli, /mod timeout, /mod avvisa, /mod pulisci, /mod modalita-lenta, /mod blocca.
  • Gli avvertimenti possono scadere dopo un numero di giorni: smettono di contare ma restano nello storico (/mod registro).
  • Automod: parole vietate, spam/flood, inviti Discord, menzioni di massa, maiuscole. Tutto spento di default, soglie regolabili. Parole vietate, inviti e menzioni li blocca l'AutoMod di Discord prima che qualcuno li veda, e il motivo lo vede solo l'autore; per il resto il bot elimina il messaggio e avvisa l'autore in privato.
  • /admin parole-vietate importa una lista pubblica di parole vietate (10 lingue) senza toccare quelle aggiunte a mano.
  • Lo staff con Gestisci messaggi è escluso, a meno che tu non attivi “Applica anche allo staff” per fare delle prove.
07

Anti-raid, anti-nuke e blocco

Tre protezioni indipendenti, tutte spente finché non le accendi.

  • Anti-raid: espelle (o solo registra) gli account più giovani di una soglia e riconosce le ondate di ingressi, con blocco automatico facoltativo.
  • Anti-nuke: scegli quali azioni sorvegliare (eliminazione o creazione di canali e ruoli, modifiche ai permessi, ban, espulsioni, webhook, emoji, bot aggiunti, impostazioni del server), ognuna con il suo limite, e cosa succede a chi lo supera: solo avviso, ruoli tolti, ruoli tolti e timeout, espulsione o ban. Ruoli e utenti fidati non vengono mai controllati.
  • Blocco del server: /mod blocco-server attiva impedisce a tutti di scrivere nei canali testuali; /mod blocco-server disattiva rimette esattamente com'era.

L'anti-nuke ferma altri danni, non annulla quelli già fatti. Quando il server è sistemato fai un backup della struttura con /admin backup crea.

08

Benvenuto, verifica e ruoli

Cosa vede un nuovo membro, e come ottiene l'accesso.

  • Benvenuto: embed in un canale e/o in privato, con {user}, {server}, {membercount}, messaggio di addio facoltativo e card grafica con l'avatar, personalizzabile con colori, immagine di sfondo, titolo e riga sotto il nome (anteprima dal vivo).
  • Verifica: un bottone che dà il ruolo verificato (e toglie un eventuale “non verificato”). Pannello: /admin verifica pannello.
  • Autorole: ruoli assegnati in automatico all'ingresso.
  • Ruoli a scelta: fino a 20 pannelli con tendina, bottoni o reazioni, uno o più ruoli alla volta.
09

Livelli, economia e community

Tutto quello che tiene vivo un server.

  • Livelli: XP da messaggi e vocale, ruoli premio, rank card grafica con il tuo sfondo (/community livello utente).
  • Economia: monete, ricompensa giornaliera, lavoro, negozio di ruoli e minigiochi (/community monete, /community negozio).
  • Giveaway con requisiti (ruolo, livello, età dell'account, inviti), partecipazioni bonus, partenza programmata e nuova estrazione.
  • Sondaggi nativi di Discord (da 2 a 10 opzioni, fino a 32 giorni), suggerimenti votati dai membri, compleanni, promemoria, AFK.
  • Canali vocali temporanei, contatori, starboard, messaggi fissi e il gioco del conteggio.
10

Game Hub · Roleplay

Pensato per server FiveM, RedM e Minecraft. Ogni pezzo ha il suo interruttore.

  • Reparti e servizio: gradi con ruoli, assunzioni/promozioni/licenziamenti, organigramma che si aggiorna da solo, ore di servizio e report settimanale.
  • Personaggi: schede con approvazione facoltativa, personaggio attivo mostrato in registri e documenti.
  • Registri: multe, arresti, annotazioni e fatture con una valuta di gioco; /rp registro fedina per la fedina di un cittadino.
  • Eventi con iscrizioni, posti limitati e lista d'attesa; chat anonima (anonima per i membri, mai per lo staff).
  • Stato del server di gioco: giocatori online, annunci dei riavvii e contatore vocale, con /rp server.
11

Game Hub · FiveM

Collega il tuo server FiveM (o RedM) al bot ed esegui i suoi comandi da Discord. Fa parte del Premium.

  • Collegamento: da dashboard → Game Hub → FiveM generi una chiave e scarichi la risorsa shadows-bridge, già pronta per il tuo bot. Funziona con ESX, QBCore, Qbox e server standalone, e non serve aprire porte.
  • Comandi del server: il bridge legge da solo i comandi registrati (console, framework, txAdmin e script custom) con i loro parametri. Li accendi uno per uno e scegli quali ruoli possono usarli.
  • Da Discord: /rp fivem esegui suggerisce i comandi attivi; senza argomenti apre un modulo con un campo per parametro (per setjob: ID, lavoro, grado). /rp fivem stato dice se il server è collegato.
  • Log: ogni comando finisce nel canale scelto con chi l’ha usato, parametri, server, data ed esito.

I comandi partono con i permessi della console del server: attiva solo quelli che servono. In server.cfg va aggiunta la riga add_ace resource.shadows-bridge command allow, che il pannello ti fa copiare insieme alla chiave.

12

Game Hub · Diablo IV

Eventi del gioco, avvisi nel server e consultazione via comando. Fa parte del Premium.

  • Eventi in tempo reale: per Boss del mondo, Marea Infernale e Legione lo stato attuale, quanto manca alla fine o all'inizio, il prossimo spawn, il respawn, la zona e il nome del boss quando è noto, con /community diablo eventi.
  • Avvisi: per ogni evento scegli canale, ruolo da menzionare e quanto prima avvisare (dashboard → Game Hub → Diablo IV). Ogni membro attiva o disattiva per sé il ruolo con /community diablo segui.
  • Build: le build più usate in cima alla Fossa della stagione in corso, filtrabili per classe, con livello, tempo e link alla run, più il collegamento a Mobalytics (/community diablo build).

Orari degli eventi, stagione in corso e build si aggiornano da soli da Helltides.com; tra un aggiornamento e l'altro il bot calcola da solo inizio, fine e respawn.

13

Streamer, giochi gratis e aggiornamenti

Annunci automatici nel canale che scegli.

  • Streamer e social: Twitch, Kick, YouTube, Bluesky, Mastodon, Tumblr e feed RSS/podcast. Fino a 15 fonti per server.
  • Giochi gratis: Epic, Steam, GOG e altre fonti, ognuno annunciato una volta sola. /community giochi-gratis mostra le offerte del momento.
  • Aggiornamenti giochi: un ruolo e un canale per gioco, i membri scelgono cosa seguire; pubblicazione automatica da RSS, notizie Steam o release GitHub.
  • Messaggi ricorrenti e programmati: embed costruiti con anteprima dal vivo e pubblicati quando vuoi.
14

Criptovalute

Prezzi e avvisi senza uscire da Discord, gratis su ogni server.

  • /crypto prezzo, /crypto grafico (da 24 ore a un anno), /crypto classifica (i maggiori rialzi e ribassi del giorno tra le prime 100) e /crypto converti tra monete e valute.
  • Avvisi di prezzo in privato (/crypto avviso): sopra o sotto un prezzo, o una variazione percentuale in 24 ore. Ogni avviso scatta una volta, poi va in pausa finché non lo riattivi.
  • Lista delle monete seguite (/crypto lista) e preferenze: la tua valuta, avvisi accesi o spenti e un riepilogo giornaliero in privato all'ora che scegli. Sono tuoi e valgono su ogni server.
  • Gli amministratori scelgono la valuta predefinita del server e pubblicano un pannello dei prezzi con fino a 10 monete, aggiornato ogni 5 minuti.

I prezzi arrivano dai dati di mercato pubblici di Binance. Sono solo informativi e non sono consigli finanziari.

15

Tebex

Verifica degli acquisti con ruolo automatico per pacchetto.

  1. 1Su Tebex apri Servers (Game Server Integration) e copia la Secret Key del server.
  2. 2Incollala in /admin impostazioni → Tebex (o nella dashboard). Ogni server Discord ha la sua chiave.
  3. 3Abbina ogni ID pacchetto al ruolo Discord che deve dare.
  4. 4Chi compra lancia /ticket verifica-acquisto con l'ID della transazione: se il pagamento è completato, riceve il ruolo.

Ogni transazione si può riscattare una sola volta. I pagamenti rimborsati e contestati vengono rifiutati.

16

Automazioni e comandi personalizzati

Regole e comandi tuoi, creati dalla dashboard.

  • Automazioni: “se succede X, fai Y”. Inneschi: parola chiave, reazione, orario, soglia del membro (livello, inviti, giorni nel server).
  • Ogni automazione esegue da 1 a 5 azioni: invia un messaggio, aggiungi o togli un ruolo, elimina il messaggio, avvisa, timeout o espulsione.
  • Comandi personalizzati: si usano con /custom esegui e il loro nome, quindi non occupano i posti dei comandi del server; ruoli autorizzati, canale di risposta e da 1 a 5 azioni. Fino a 20 per server.
17

Backup del server

Una fotografia di ruoli, categorie, canali e permessi.

  • /admin backup crea salva la struttura; per ogni server restano gli ultimi 10 backup.
  • /admin backup ripristina ricrea solo quello che manca (confrontando i nomi) e non duplica mai niente.
  • I messaggi non sono inclusi: Discord non offre un modo affidabile per salvarli.
  • /admin svuota elimina tutti i canali, le categorie e i ruoli. Può lanciarlo solo il proprietario del server, dopo più conferme.
18

Free e Premium

Tutto l'essenziale è gratuito, per sempre. Il Premium è per server, mensile o annuale.

  • Free: benvenuto, verifica, autorole, moderazione, log del server, ticket con 1 tipo e trascrizioni, fino a 10 embed attivi, ruoli a scelta, canali vocali, contatori, AFK, livelli, economia, compleanni, promemoria, giochi gratis, statistiche, criptovalute.
  • Premium: identità del bot per server, sicurezza, automod, più tipi di ticket, embed illimitati, richieste e moduli, aggiornamenti giochi, starboard, messaggi fissi, conteggio, tutto il Game Hub (roleplay, FiveM e Diablo IV), inviti, sondaggi, suggerimenti, giveaway, automazioni, comandi personalizzati, streamer e social, Tebex e template.
  • Attivazione: dopo il pagamento il Premium va al server scelto, oppure ricevi una chiave in privato da riscattare in dashboard o con /admin premium riscatta.
  • Puoi spostare il Premium su un altro server che gestisci dalla pagina Premium (una volta ogni 7 giorni).
  • Alla scadenza il proprietario riceve un messaggio privato 7 giorni prima. Poi i moduli Premium si fermano, ma non si cancella niente; un server con un abbonamento a rinnovo automatico ha 3 giorni di tolleranza mentre arriva il pagamento.
  • Per disdire un abbonamento: Il mio account → Premium e pagamenti → Gestisci o disdici. Il Premium resta fino alla fine del periodo già pagato; i pagamenti PayPal sono singoli e non si rinnovano.
19

I tuoi dati

Cosa conserva il bot, e come lo vedi.

  • Impostazioni, livelli, monete, ticket e storico stanno nel database del bot, con backup automatici.
  • Nella pagina Il mio account della dashboard ogni utente vede cosa conserva il bot su di lui, server per server, e lo scarica in JSON.
  • Dalla stessa pagina puoi cancellare da solo compleanno, promemoria, stato AFK, schede personaggio e avvisi di prezzo, lista e preferenze delle criptovalute. Avvisi, sanzioni e registri RP restano allo staff.
  • I pagamenti passano da Stripe (carta, Apple Pay, Google Pay) o PayPal: i dati della carta non arrivano mai a noi.
  • Il bot non conserva dati di fatturazione: indirizzo, partita IVA, ricevute e fatture li gestisce Stripe (e PayPal per i suoi pagamenti). Il bot ricorda solo chi ha pagato, quale piano e per quale server.
  • La verifica in due passaggi salva una chiave cifrata e i codici di recupero solo come impronta: non si possono rileggere.
  • I proprietari dei server ricevono un messaggio privato quando il bot viene aggiornato; il pulsante sotto il messaggio li disattiva.
20

Tutti i comandi

Generato dal codice del bot, quindi corrisponde sempre al bot. I nomi sono nella lingua di questa pagina; su Discord seguono la lingua del tuo server. Sotto ognuno c'è il nome inglese.

/modModerazione: ban, espulsioni, timeout, avvisi, pulizia messaggi, blocco canali

/mod ban

Banna un membro, per sempre o a tempo

Sintassi
/mod ban <utente> [motivo] [giorni_messaggi] [durata]
Opzioni
utenteobbligatorio
Utente da bannare
motivofacoltativo
Motivo del ban
giorni_messaggifacoltativo
Giorni di messaggi da eliminare (0-7)
duratafacoltativo
Ban temporaneo, es. 12h, 3g, 1g12h (vuoto = definitivo)
1 / 14

Ancora bloccato?

Scrivici dalla pagina contatti scegliendo “Supporto del bot”: leggiamo ogni messaggio.