Manuale dei comandi: moduli, contatori e comandi vocali

Aggiornato il 3 ottobre 2026

Questo manuale copre due schede: Comandi, nel gruppo Chat del menù, dove costruisci quello che il bot fa in chat, e Comandi vocali, fra le schede della voce Il bot, dove lo comandi a voce mentre streammi.

Un modulo è un'automazione: QUANDO succede qualcosa, SE valgono certe condizioni, ALLORA il bot fa una o più cose. Un comando in chat è un modulo che scatta quando qualcuno scrive !nome. Un modulo è fatto di dati, mai di codice: può fare solo le azioni elencate qui sotto.

Comandi

Qui crei i comandi della chat, le automazioni, i contatori, e scegli come si comportano i comandi che il bot porta già con sé.

La scheda ha tre parti, che scegli dalla barra in alto: «Comandi e contatori», «Chi arriva in chat» e «CONTATORify». Il pannello si ricorda l'ultima che hai aperto.

È nel piano Essenziale, gratis: le poche cose che chiedono un altro piano lo dicono al loro posto. Il tetto è di 100 moduli per canale: oltre, il pannello risponde «hai raggiunto il massimo di 100 moduli». Proprietario e moderatori del pannello la usano allo stesso modo, con tre eccezioni che restano al proprietario: la chiave dei Connettori avanzati, i premi a punti canale dei contatori e i punti importati da un altro bot.

Comando rapido

Il modo più corto per fare un comando. Scrivi il nome dopo il ! e cosa deve rispondere, poi premi «Aggiungi comando».

Il nome tiene lettere minuscole, cifre e trattino basso, fino a 24 caratteri. Sotto la «Risposta» ci sono le variabili più usate: un clic le mette dove sta il cursore. La legenda «Cosa significano i $ (legenda)» le spiega tutte.

Il comando nasce come modulo col nome «Comando !nome», aperto a tutti e senza attese. Lo trovi in «I tuoi moduli»: da lì lo cambi con «Modifica».

Se manca il nome il pannello dice «Scrivi il nome del comando (senza !).», se manca la risposta «Scrivi cosa deve rispondere il bot.». Il pannello non controlla se il nome esiste già: due moduli con lo stesso comando rispondono tutti e due.

Nel riquadro «Comandi pronti (1 clic)» ci sono due comandi già configurati, riservati a moderatori e streamer. «Crea comando !categoria» crea !categoria (anche !gioco): in chat si scrive !categoria Fortnite e il bot cerca la categoria più somigliante. «Crea comando !titolo» crea !titolo, che si usa come !titolo In diretta!. Se il comando c'è già, accanto leggi «!categoria esiste già ✓» e non ne nasce un secondo. Cambiano titolo e categoria sulla piattaforma da cui si scrive: Twitch o Kick. Su Twitch serve il permesso Gestione canale, su Kick «Aggiorna i permessi di Kick» nella riga di Kick di «Le tue piattaforme».

Lo stesso lo fai dentro una risposta qualsiasi con $categoria($args) e $titolo($args): il pezzo sparisce dal messaggio, il cambio avviene, e la conferma la scrivi tu attorno.

Comodità in chat

Tre interruttori, che valgono dopo «Salva».

I comandi creati dalla chat sono solo testo: accettano solo {user} (il nome di chi scrive), fino a 400 caratteri, con un nome fino a 25 caratteri. Non compaiono in «I tuoi moduli»: li elenchi in chat con !comando lista, che può scrivere chiunque. Crearli, cambiarli e toglierli resta sempre ai moderatori e a te. Per variabili, condizioni ed effetti serve un modulo.

!bot e !ia rispondono sempre, qualunque cosa dicano questi interruttori: chiunque in chat può sapere che alcune risposte sono scritte da un'intelligenza artificiale. Se ti costruisci un tuo !bot, risponde il tuo.

Moduli

«Nuovo modulo (avanzato)» apre l'editor vuoto. Sotto ci sono i modelli: ognuno apre l'editor già compilato, e niente è salvato finché non premi «Salva». Se la regia è collegata, i modelli di regia prendono le tue scene che contengono Pausa, Gioco o Raid nel nome, e la fonte del microfono; se non la trovano, scrivono quei nomi e tu li adatti ai tuoi.

Le sei ricette a monete sono le stesse che trovi in «I tuoi giochi» nella scheda Giochi & classifiche. Il manuale dei giochi spiega le monete.

Porta qui quello che hai già

Serve a chi arriva da Nightbot, StreamElements, Fossabot o un altro bot. Porta qui i comandi, i timer e i punti del tuo pubblico. Incolla l'export del tuo bot (JSON), un CSV o quello che copi da un foglio di calcolo, oppure un elenco con una riga per cosa: !social I miei social sono… per un comando, ogni 15 minuti: Seguimi su Instagram per un timer, marco 1200 per i punti di una persona. Con «Apri un file» scegli un file .json, .csv o .txt fino a 1,5 MB.

«Guarda cosa succede» non scrive niente: ti mostra cosa entrerebbe. In cima leggi «Ho letto…» con quanti comandi, timer, contatori e saldi ha trovato; se i posti dei moduli non bastano, anche quanti ne restano. Sotto c'è una parte per ognuno. Se cambi il testo, l'anteprima sparisce e la rifai: si importa solo quello che hai visto.

Se il pannello risponde che non riconosce il formato, incolla l'export così com'è, oppure riscrivi le righe nella forma dell'elenco qui sopra.

Da rivedere. Dentro «Comandi» e «Timer» ci può essere un secondo elenco: sono quelli che qui non si comporterebbero del tutto come prima: una chiamata a un sito esterno (qui è l'azione «Chiama un webhook»), un timer che partiva solo in certi giorni, un comando che rispondeva in privato (qui risponderebbe in chat), uno che partiva anche con delle parole chiave senza !, uno per i «regular» (qui entra per VIP e moderatori). Accanto c'è il perché. Entrano solo se spunti «Importa lo stesso quelli da rivedere: li sistemo io dopo», così come sono: un comando da rivedere scrive in chat il pezzo che non si è tradotto, finché non lo sistemi tu.

«Scartati». Si apre con un clic e dice cosa non entra, col motivo: un nome che non si può usare, un nome ripetuto nel file, una risposta vuota, un bot, un numero che non è un saldo, un intervallo che non si legge o più lungo di un giorno.

Le variabili si traducono da sole: $(user) diventa $user, $(touser) diventa $touser, $(query) diventa $args, $(1) diventa $arg1, $(channel), $(game), $(title), $(uptime) e $(viewers) diventano $canale, $gioco, $titolo, $uptime e $spettatori, $(count) diventa il contatore col nome del comando, e il modulo gli fa +1 prima di rispondere, come faceva là; ${count morti} fa lo stesso col contatore «morti», ${count morti 0} lo azzera e ${getcount morti} lo scrive e basta.

Timer da un altro bot

L'intervallo si legge in minuti, in forme come 15m, 1h o 2 ore, e nell'orario che usa Nightbot (*/15 * * * *). Un orario che non si ripete a distanze uguali, o che valeva solo in certi giorni, entra da rivedere col motivo accanto. Il minimo di messaggi in chat resta lo stesso numero che avevi, fino a 1.000.

Un timer di Nightbot parla anche a canale spento, come faceva là. Uno di StreamElements che aveva un ritmo per la diretta e uno per fuori diventa due timer, «(in diretta)» e «(fuori diretta)». Se alternava più messaggi, qui ne esce uno per volta, scelto a caso. Un timer senza nome prende le prime parole del suo messaggio, così importare due volte lo stesso elenco non lo raddoppia.

Un timer che scriveva !discord faceva partire il comando. Qui un timer scrive e basta, quindi prende la risposta di !discord, se il comando c'è. Se non c'è, entra da rivedere.

Punti da un altro bot

I punti diventano monete del canale e si sommano a quelle che ognuno ha già qui. In «Ogni quanti punti di prima, una moneta» scegli il cambio, di base 1: con 10, mille punti diventano cento monete. Cambiarlo rifà l'anteprima.

Puoi importare di nuovo quando vuoi: conta l'ultima importazione, e nessuno riceve due volte gli stessi punti. Chi non c'è resta com'è. Le ore guardate non si portano. Lo stesso cambio vale per i comandi che costavano punti: qui costano monete, arrotondate in su.

I punti li importa solo il proprietario del canale, come le monete date a mano. Un moderatore vede l'anteprima, e importando porta comandi e timer.

Premi «Importa». Il pannello dice cosa ha fatto: comandi e timer nuovi e aggiornati, e a quante persone sono arrivate monete. Ogni comando diventa un modulo che si chiama «!nome», con l'azione «Scrivi in chat»; ogni timer un modulo «A tempo (timer)». Comandi e timer si dividono i 100 posti dei moduli: se finiscono, leggi quanti «non sono entrati: hai finito i posti.».

Mai più accesso di prima. Un comando entra con lo stesso livello che aveva, o con uno più stretto, mai più largo: uno solo per i mod resta per i mod, uno solo del proprietario diventa «Per chi: solo tu». Dove qui non c'è lo stesso gradino (i «regular», i super moderatori) entra col primo più stretto, da rivedere. Si leggono i primi 500 comandi, 100 timer e 50.000 saldi, e ogni risposta fino a 400 caratteri.

Se rifai l'import sopra comandi che hai già, cambia quello che viene dall'altro bot (risposta, livello, attese, alias) e restano le scelte fatte qui: il ramo del no, Telegram, la probabilità, le piattaforme.

Da StreamElements, senza scaricare niente

«Prendi da StreamElements» legge quello che StreamElements mostra a tutti sulla pagina dei tuoi comandi: i comandi (tranne i nascosti), i loro contatori e, se il canale è tuo, i punti del tuo pubblico, fino alle 50.000 persone con più punti. Non serve nessun accesso: niente password, niente chiavi. Il canale è quello con cui sei entrato qui, e deve essere legato allo stesso account Twitch su StreamElements; un canale con lo stesso nome ma di un altro account non si legge. Poi l'anteprima e «Importa», come sempre: se nel frattempo su StreamElements è cambiato un comando, il pannello te lo dice e ti mostra quello nuovo prima di scrivere.

Timer e comandi nascosti StreamElements non li mostra a tutti: per quelli si apre «Anche i timer e i comandi nascosti» e si incolla la tua chiave di StreamElements (il «JWT Token», in StreamElements dal tuo profilo, «Channels», «Show secrets»). La chiave vive solo nella pagina, e solo per un attimo: va da questo browser a StreamElements e basta, a noi non arriva mai, non finisce in cookie, cache o cronologia, e appena letta si cancella, anche se qualcosa va storto. Se ricarichi la pagina non c'è più: per un altro import va incollata di nuovo. È la chiave di tutto il tuo account StreamElements: per non correre nessun rischio, dopo l'import rigenerala su StreamElements, e quella vecchia smette di funzionare. Timer e comandi arrivano nel riquadro di testo, senza la chiave, e da lì «Guarda cosa succede».

Da Nightbot, Fossabot o Moobot, senza scaricare niente

«Prendi da Nightbot», «Prendi da Fossabot» e «Prendi da Moobot» leggono i comandi che il tuo bot mostra a tutti per il tuo canale. Non serve nessun accesso: niente password, niente chiavi. Il canale è quello con cui sei entrato qui, e su quel bot deve essere legato allo stesso account Twitch: un canale con lo stesso nome ma di un altro account non si legge. Poi l'anteprima e «Importa», come per StreamElements: se nel frattempo là è cambiato un comando, il pannello te lo dice e ti mostra quello nuovo prima di scrivere.

Da Nightbot arrivano i comandi con chi può usarli, l'attesa e il conto. Un comando che là partiva con un altro segno, come «~ciao», qui si scrive col punto esclamativo, ed è da rivedere. Da Fossabot arrivano anche gli alias e se il comando vale in diretta o fuori. I suoi comandi di serie, come !uptime, restano là: qui ci sono quelli di SocialBot.

Su Fossabot un comando può valere per insiemi di persone (gli abbonati e i moderatori, ma non i VIP), qui i gradini vanno in fila: abbonati, VIP, moderatori. Il comando entra col gradino più largo che non fa entrare nessuno che là restava fuori. Se così resta fuori qualcuno che prima lo usava, o era per un ruolo fatto da te su Fossabot, è da rivedere e accanto c'è chi.

Moobot mostra solo nome e risposta, non chi poteva usare un comando. Per non dare mai più accesso di prima, i suoi comandi sono tutti da rivedere: li porti spuntando «Importa lo stesso quelli da rivedere», ed entrano solo per te finché non scegli in «Per chi». I suoi alias diventano alias del comando a cui puntano, e <username> diventa il nome di chi scrive il comando.

I timer non si vedono da fuori, con nessuno dei tre: scrivili nel riquadro qui sopra, una riga per timer, come ogni 15 minuti: Seguimi su Instagram.

I tuoi moduli

L'elenco di quello che hai costruito. Ogni riga ha l'interruttore (acceso o spento, subito), il nome e un riassunto che si legge così: «QUANDO scrivono !ciao · SE solo i mod → invia un messaggio».

«Prova» esegue il modulo una volta, adesso, saltando tutte le condizioni, come se l'avessi scritto tu. In prova $args vale «esempio prova» e le variabili degli eventi hanno valori finti (RaiderDiProva, 42 spettatori, 100 bit). «Modifica» apre l'editor. «Elimina» chiede conferma e non si torna indietro.

Se l'elenco è vuoto leggi «Nessun modulo ancora: parti da un modello qui sopra».

L'editor: nome e QUANDO

Si apre sotto l'elenco. In cima c'è il riassunto del modulo, che cambia mentre scrivi. Il «Nome del modulo» è obbligatorio: senza, il pannello dice «Dai un nome al modulo.». Ne restano i primi 80 caratteri.

In «Cosa fa scattare il modulo» scegli uno dei sette inneschi.

Comando. «Attiva anche senza !» fa scattare il comando anche quando qualcuno scrive solo la parola, da sola nel messaggio (disc e non !disc). Dentro una frase non scatta.

Parola. «Come confrontarle» ha tre scelte: «Compare dentro il messaggio», «È esattamente il messaggio», «Il messaggio inizia così». Basta che una frase combaci. «Ignora la punteggiatura» è acceso di base, così «come stai?» combacia con «come stai». «Rispetta maiuscole/minuscole» è spento di base.

Telegram. Con «Abilita anche su Telegram» il modulo risponde anche nel gruppo, dove il comando scatta pure dentro una frase e senza !. Nel gruppo il bot esegue solo le azioni «Scrivi in chat», e risponde il primo modulo che combacia. Un modulo vocale con Telegram acceso manda i suoi messaggi anche nel gruppo. Serve il «Bot interattivo nel gruppo», che accendi nella scheda Telegram del gruppo Community, nel piano Base.

Voce. Scrivi le frasi come le dici, una per riga: il pannello le salva in minuscolo. Basta che la frase compaia dentro quello che dici: «ok clippa adesso» fa scattare «clippa». Scattano solo col pacchetto «Comandi Vocali» e con la pagina di ascolto aperta: tutto nella sezione Comandi vocali più sotto.

Arriva in chat. «Quando scatta» ha tre scelte: «La prima volta in ogni diretta» (di base), «La prima volta ogni giorno», «Solo se mancava da un po'», con «Da quanti giorni almeno» da 1 a 365 (di base 21). Scatta al primo messaggio, una volta sola: due messaggi di fila non sono due arrivi, e nemmeno un riavvio del bot. «Anche se entra senza scrivere» vale solo su Twitch e solo per le persone scritte per nome: il bot se ne accorge entro 5 minuti. Tutto il resto sta in «Chi arriva in chat», più sotto.

Timer. Minuti da 1 a 1.440 (di base 15), messaggi da 0 a 1.000 (0 vuol dire a tempo e basta). Di norma un timer parla solo mentre sei in diretta: per farlo parlare a canale spento spunta «Falla parlare anche a canale spento» oppure la condizione «Solo se sono offline». I messaggi contati sono quelli delle persone, non del bot. Un timer appena creato parla la prima volta dopo un intervallo intero. Se più timer scadono insieme, parlano uno alla volta a 7 secondi di distanza. Su un canale Kick parlano nella chat di Kick, e «in diretta» è la diretta su Kick. Su YouTube i timer non parlano: la quota per scrivere nella chat di YouTube è una sola per tutto il servizio, e lì il bot risponde a chi scrive.

Gli eventi

Se costruisci un modulo sul primo messaggio, il saluto automatico del bot alle facce nuove tace e resta il tuo. Il gesto richiede il tracking della webcam, che si accende in Scena & overlay, Effetti & suoni: lo spiega il manuale degli effetti.

Per chi: solo alcune persone, o tutte tranne alcune

Sta fra QUANDO e SE, e vale per ogni innesco: un comando può rispondere in un modo a una persona e in un altro a tutti gli altri. Si apre da solo se il modulo ha già qualcuno, o se l'innesco è «Quando arriva in chat».

In «Vale» scegli «Solo per queste persone e questi gruppi» oppure «Per tutti tranne queste persone e questi gruppi». In «Persone» scrivi il nome come appare in chat e premi Invio o «Aggiungi»: i suggerimenti sono chi ha scritto nel tuo canale negli ultimi 14 giorni. Con più piattaforme collegate, accanto scegli quale. Un nome con spazi o simboli non entra e il pannello lo dice; la × lo toglie. In «Gruppi» spunti «Moderatori», «VIP», «Abbonati».

La prima volta che una persona scelta scrive, il bot la riconosce per il suo account e se lo segna: se poi cambia nome, resta lei. Fino a 50 persone per modulo.

Una regola per nome batte quella del suo gruppo, e quella del gruppo batte quella per tutti. Su un timer o all'inizio della diretta non c'è nessuno davanti: con «Solo per…» il modulo tace, con «Per tutti tranne…» parte.

SE: le condizioni

Stanno in «Se (facoltativo)», che si apre con un clic. È già aperto se il modulo ha un livello diverso da «Tutti», un «Cooldown (s)», una probabilità sotto 100 o una delle due condizioni sulla diretta. Sono tutte facoltative e si sommano: devono passare tutte, o il modulo non parte.

Nelle etichette la moneta ha il nome che le hai dato in Giochi & classifiche. Con le fasce fai una scala: un modulo per 1-99 bit, uno per 100-999, uno da 1.000 in su. Un massimo più basso del minimo viene ignorato. Chi resta fuori dalla fascia non paga e non consuma il cooldown.

Sugli eventi, sui timer, sulla voce, su Telegram e sui moduli manuali «Chi può attivarlo» non ferma niente. Lo stesso vale per «Costa (monete)» e «Serve almeno»: paga solo chi fa scattare il modulo scrivendo in chat un comando o una parola, col suo nome utente. Sugli eventi (anche il primo messaggio), sui timer, sulla voce, su Telegram e sui moduli manuali il modulo parte e non paga nessuno, nemmeno tu.

In che ordine vengono controllate

L'ordine decide quando si paga.

Si paga dopo le attese e prima del dado. Chi gioca paga anche quando perde, e non paga se il comando era in attesa o se non poteva usarlo. Chi non ha abbastanza monete non consuma il cooldown. Dopo il pagamento hai $costo (quanto è uscito) e $saldo (quanto è rimasto) da usare nei testi.

ALLORA: le diciotto azioni

Si eseguono in fila, dall'alto, e il bot ne fa al massimo otto per modulo: quelle dopo l'ottava non partono. Con ↑ e ↓ cambi l'ordine, con × ne togli una, con «+ Aggiungi azione» ne aggiungi. Se un'azione fallisce, le altre vanno avanti lo stesso. Senza nemmeno un'azione il pannello dice «Aggiungi almeno un'azione.».

Messaggi del bot. Con «Annuncia il cambio in chat» acceso, categoria e titolo scrivono «🎮 Categoria aggiornata: …» e «📝 Titolo aggiornato: …», e se la categoria non si trova «🤔 Non ho trovato la categoria "…".». Se manca il permesso per categoria, titolo, annuncio, shoutout o timeout, il bot lo dice in chat con un 🔒 e le altre azioni vanno avanti: se il comando l'ha scritto uno dello staff (tu o un moderatore) gli dice anche di riautorizzare dalla dashboard, agli altri solo che adesso non può. Su Kick il rimedio detto allo staff è ricollegare Kick. Timer, voce e API non arrivano da una chat: cambiano titolo e categoria su tutte le piattaforme del canale, cioè su Twitch e Kick insieme se il canale è su Twitch e hai collegato Kick. Se riesce ovunque il bot scrive una riga sola; se una piattaforma dice di no, scrive dove è riuscito, per esempio «📝 Titolo aggiornato: … (su Twitch)», e il rimedio dell'altra; se la categoria ha un nome diverso su ciascuna, li dice tutti e due. Su YouTube titolo e categoria non si cambiano ancora: allo staff il bot dice «⏸️ Su YouTube il titolo non si cambia ancora da qui: si cambia su Twitch e su Kick.». Un moderatore o un VIP non si mette in pausa, e il bot lo dice: «🛡️ Non posso mettere in pausa …: moderatori e VIP non si possono.». La clip, se non riesce (canale spento o permesso mancante), non scrive niente. Lo shoutout scrive il «Messaggio extra» solo se è riuscito.

Cambia categoria. Fra le categorie di ciascuna piattaforma, Twitch o Kick, sceglie quella che contiene le parole che hai scritto: «diablo 4» non diventa «Diablo». Capisce i numeri romani o scritti in lettere e le sigle più usate, come «gta 5» o «cs2». Se nessuna somiglia abbastanza, non cambia niente.

Contatore. «Incrementa (+1)» aggiunge uno, qualunque sia il passo del contatore; «Azzera» riporta a zero; «Imposta a…» mette il numero di «Valore (se "imposta")». Il nome è quello del comando del contatore, senza !: morti muove lo stesso numero di !morti, di $count(morti) e di CONTATORify. Se quel contatore non c'è ancora, nasce nella carta Contatori. L'azione cambia il numero senza scriverlo in chat: per dirlo aggiungi «Scrivi in chat» con $count(morti).

Dai o togli punti. «A chi» ha quattro scelte: «Chi ha scritto», «Chi è taggato dopo il comando», «Uno a caso fra chi è in chat» (pescato fra chi ha scritto di recente, di preferenza non l'autore) e «Un nome fisso», che chiede il «Nome utente». In un modulo che parte da un evento, «Chi ha scritto» è chi segue, si abbona, riscatta o fa raid; in un timer, all'inizio o alla fine della diretta e da Telegram non c'è nessuno, e il passo salta. «Quanti» accetta un numero o una variabile: $random(10,50), $arg1. Dopo, $mossa dice quante monete si sono mosse davvero e $bersaglio su chi: a chi ha 5 monete non se ne tolgono 80. Le azioni che seguono vedono la stessa cifra, così un furto dà al ladro esattamente quello che ha tolto.

Chiama un webhook. Il bot manda in POST un JSON con canale, chi ha scritto, gli argomenti, l'evento e le variabili del momento. Se rispondi con {"reply": "testo"} e hai spuntato «Usa la risposta come messaggio in chat», il bot scrive quel testo, con le variabili già espanse. Accetta solo indirizzi http e https, non raggiunge indirizzi di una rete privata, non segue i reindirizzamenti, aspetta 5 secondi e legge fino a 10 KB di risposta.

Regia. È lo stesso passo dei tasti di CONSOLify: così una scena cambia con !brb, a voce o a un raid. Se la regia è collegata da questa pagina, i nomi di scene, fonti e transizioni te li propone mentre scrivi. Una scena può venire dal comando: $arg1 dopo !scena. Lo esegue il pannello aperto sul computer della regia, non il server: se non c'è, il passo salta e il resto va avanti. Il collegamento lo spiega il manuale di CONSOLify.

Modalità della chat a tempo. «Per quanto» vuoto vale 2 minuti; accetta 5m, 90s, 1h o $arg1, fino a 40 caratteri. Un numero senza unità vale minuti, e la durata sta fra 10 secondi e un'ora. Una durata che non si capisce vale 2 minuti. Con «Lo dico in chat» acceso il bot scrive «🎉 Chat in modalità solo emote per 2 minuti!» e quando finisce «✓ Fine della modalità solo emote: chat di nuovo libera.». Se la stessa modalità l'ha già accesa il bot, si allunga fino alla fine più lontana. Alla fine la chat torna com'era da sola, anche se il bot si riavvia in mezzo. Se un moderatore aveva già acceso quella modalità, il bot la lascia stare. Chat lenta e soli follower non ci sono: le usa lo scudo contro gli attacchi.

Metti una canzone in coda. Le richieste musicali sono nel piano Essenziale. Spotify lo colleghi in In diretta → Musica. Il bot scrive «🎵 In coda: …», oppure «🎵 Non ho trovato "…" su Spotify.», «🎵 Nessun dispositivo Spotify attivo.», «🎵 Il brano non è stato aggiunto.». Se Spotify non è collegato, a chi è dello staff dice «🎵 Spotify non è collegato: fallo dal pannello.», agli altri «🎵 La musica qui non è attiva.». Il manuale della diretta spiega come si collega.

Il ramo Altrimenti

È quello che succede quando la probabilità non passa: il ramo del gioco perso. Compare solo con «Probabilità (%)» sotto 100. Se provi a salvare azioni in «Altrimenti» con la probabilità a 100, il pannello risponde che il blocco scatta solo quando la probabilità non passa.

Le azioni sono le stesse diciotto. Il costo è già stato pagato, così la giocata persa può raccontarlo con $costo e $saldo. Lascialo vuoto se non serve: in quel caso chi perde non legge niente.

Salva, Prova, Annulla

«Salva» salva e chiude l'editor. «Prova» prima salva, poi esegue il modulo saltando le condizioni: «Salvato e provato: guarda chat/overlay». «Annulla» chiude senza salvare.

Se qualcosa non va il pannello dice cosa: un webhook senza http o https, un cambio di categoria o di titolo senza testo, una canzone senza brano, un annuncio vuoto, un'azione punti senza quantità o con un nome utente non valido, una regia senza scena, fonte o transizione, un'attesa di più di 30 secondi, un testo sull'overlay che resta a schermo meno di mezzo secondo o più di 30.

Le variabili

Si scrivono nei testi e diventano quello che valgono. Nell'editor c'è un bottone per ognuna: un clic la mette nel campo dove stai scrivendo. Una variabile che non esiste sparisce dal testo senza lasciare il suo nome. Sono sostituzioni di testo e basta: nessun codice viene eseguito, né tuo né di chi scrive in chat.

Chi scrive e cosa dice

La diretta adesso

Chi arriva in chat

Le persone

Le monete

Data e ora

Le funzioni

Quelle a caso. Danno un valore nuovo ogni volta che compaiono: due $dado nella stessa frase danno due numeri diversi.

Tre esempi

QUANDO   comando  !abbraccia
ALLORA   Scrivi in chat
         $user abbraccia $touser per $random(3,30) secondi.

QUANDO   evento  Raid
ALLORA   Scrivi in chat
         Benvenuti! $raider è arrivato con $viewers persone.
ALLORA   Shoutout (banner)  a chi ha raidato

QUANDO   comando  !scommetti
SE       Costa $arg1 · Probabilità 45
ALLORA   Dai o togli punti  Dai $arg1 a chi ha scritto
ALLORA   Dai o togli punti  Dai $arg1 a chi ha scritto
ALLORA   Scrivi in chat
         $user vince! Ora ha $punti $monete.
ALTRIMENTI  Scrivi in chat
         $user perde la puntata. Restano $saldo $monete.

Nel terzo la puntata esce prima del dado: per raddoppiarla, chi vince se la vede restituire due volte.

Connettori avanzati

Servono per far dire o fare qualcosa al bot da un tuo servizio: un'estensione, un tasto fisico, uno script, un bot che hai già. La chiave la vede e la crea solo il proprietario: un moderatore vede «nessuna chiave», e se prova a crearla il pannello risponde «solo il proprietario del canale può farlo».

«Genera chiave» crea la chiave e te la mostra una volta sola: copiala subito con «Copia». Il bot ne conserva solo un'impronta, e dopo leggi «c'è, ma non si può rivedere». Se la perdi, «Rigenera» ne fa una nuova e quella di prima smette subito di funzionare. Il pannello chiede conferma.

In «URL a cui inviare le richieste» c'è l'indirizzo del tuo canale, https://socialbot.live/api/ext/ seguito dal tuo nome. «Esempio d'uso» mostra una chiamata pronta.

Si manda una POST in JSON con la chiave nell'intestazione Authorization: Bearer LA_TUA_CHIAVE, oppure nell'indirizzo come ?key=. Nel corpo, azione dice cosa fare.

Al massimo 30 richieste al minuto: oltre, la risposta è 429. Una chiave sbagliata riceve 404, senza spiegazioni. Un'azione fuori dal tuo piano riceve 403, una sconosciuta «azione non riconosciuta».

Chi arriva in chat

È la seconda parte della scheda. Quando arriva in chat una persona che scegli, il bot fa quello che vuoi: un saluto tutto suo, un effetto sull'overlay, un gioco, uno dei tuoi comandi. Ogni accoglienza è un modulo con l'innesco «Quando arriva in chat una persona»: sa fare tutto quello che sa fare un modulo, anche più cose in fila, con le stesse condizioni.

Sotto «Parti da un modello» ci sono «Saluto caloroso», «Effetto e saluto», «Un gioco per chi arriva», «Uno dei miei comandi», «Chi torna dopo un'assenza», «I miei VIP» e «Parti da zero». Si aprono nell'editor qui sotto: in «Per chi» aggiungi la persona, poi Salva. Se salvi senza nessuno in «Per chi», il pannello ti chiede se vale per tutti quelli che arrivano.

In «Le tue accoglienze» ognuna dice per chi vale, quando scatta, cosa fa e quante accoglienze ha fatto. «Prova come se arrivasse…» la fa partire come se fosse arrivata la prima persona scelta: manda davvero in chat e sull'overlay, ma non conta come arrivo.

Nella carta «Quando arrivano in tanti» scegli la «Pausa fra due accoglienze (secondi)»: da 0 a 60, di base 5. Poi «Salva».

Contatori

Un contatore è un numero con un nome: le morti, i tentativi, le volte che l'hai detto. Sale, scende, torna a zero e può comparire a schermo nell'overlay che hai già in OBS, senza aggiungere niente. È lo stesso numero dappertutto: il comando in chat, l'azione «Contatore» dei moduli, $count(nome), i tasti di CONSOLify e CONTATORify.

Lo crei in fondo alla carta, in «Nuovo contatore», e premi «Crea contatore». Se manca il comando, il pannello dice «Scrivi un comando (es. morti).». Lo puoi creare anche dall'Overlay Studio, fra le cose da aggiungere («Un contatore»): è lo stesso contatore, e lo ritrovi qui.

Ogni contatore ha una riga col valore e i tasti: «Accendi a schermo» o «Spegni a schermo», + e − del passo, «Reset», «Crea premio» o «Scollega premio», e il cestino per eliminarlo. Eliminare chiede conferma: il numero si perde e il comando smette di rispondere.

«Crea premio» (solo il proprietario) crea sulla piattaforma del canale, Twitch o Kick, un premio a punti canale col nome dell'etichetta. Chiede quanti punti costa: di base 100, da 1 a 1.000.000. Chi lo riscatta fa salire il contatore di un passo. Serve il permesso dei punti canale: senza, il pannello dice dove si concede: su Twitch nella scheda «Stato» con «Aggiorna i permessi», su Kick con «Aggiorna i permessi di Kick». Se elimini il contatore il premio resta su Twitch, e lo togli da lì.

«Comandi e permessi». Sette verbi, e per ognuno scegli con quali parole si chiama e chi può usarlo: «Tutti», «Solo sub», «VIP e sopra», «Mod e streamer». Le parole si separano con uno spazio, fino a sei per verbo. Lasciare vuota la casella toglie quel comando. Poi premi «Salva comandi».

Il numero vale attaccato o staccato: !morti +3, !morti + 3, !morti+3 e !morti set10 funzionano tutti. Senza numero vale il passo. Un numero da solo, !morti 7, imposta, se «Imposta» ha almeno una parola. Attaccati al nome funzionano solo i simboli: !morti+ sì, !mortireset no.

Quando il numero cambia dalla chat, da un premio riscattato, da CONSOLify, da CONTATORify o da un gioco che lo dice da solo, il bot lo dice in chat («💀 Morti: 13»). Anche «Mostra a schermo» e «Nascondi» dalla chat ripetono il numero. I tasti del pannello, la parola automatica e l'azione «Contatore» dei moduli lo cambiano senza scrivere niente. In tutti i casi il widget a schermo si aggiorna.

A chi non può il bot risponde «!morti qui è riservato ai moderatori e allo streamer.», al massimo una volta al minuto per persona. Una lettura rifiutata resta muta.

Se hai un modulo acceso o un comando creato dalla chat con lo stesso nome, risponde quello e il contatore tace.

«Personalizza l'aspetto a schermo (overlay)». Vale dopo «Salva aspetto», e l'overlay si aggiorna subito.

Comandi pronti

Qui ci sono tutti i comandi che il bot porta già con sé, divisi per famiglia: giochi in chat, giochi con la webcam, sorteggi, ore guardate, serie di presenze, compleanni, VIP, sondaggi, richieste musicali, modalità della chat, e gli altri. Quasi tutti si spengono, si rinominano e si possono riservare: le eccezioni lo dicono sulla loro riga. Le scelte valgono dopo «Salva i comandi».

!bot (anche !ia, !ai e !socialbot) sta da solo nella famiglia «Trasparenza IA»: non si spegne, non si rinomina e non si riserva, perché chiunque in chat deve poter sapere che alcune risposte sono scritte da un'intelligenza artificiale. Risponde con una frase fissa, e non fa domande al bot.

Accanto al nome vedi «costa monete» se il comando usa le monete, e le attese («30s a testa», «2 min per tutti»). Le attese dei giochi si cambiano nelle regole dei giochi, in Giochi & classifiche.

Se un'intera famiglia è spenta, sopra leggi «famiglia spenta: questi comandi non rispondono». Si riaccende dal suo interruttore, nella scheda di quella funzione: per esempio i giochi in Giochi & classifiche, le ore guardate, i comandi base e la gestione dei comandi dalla chat in Comodità in chat.

A chi non può il bot risponde dicendo a chi è riservato, per esempio «!slot qui è riservato a chi è abbonato.».

Due comandi non possono chiamarsi allo stesso modo: il pannello non salva e ti dice quale nome è già di un altro comando. Un comando tuo con lo stesso nome vince sempre su quello pronto, alias compresi: non devi spegnere niente. Se il tuo modulo è spento, risponde di nuovo quello pronto.

I comandi dei giochi compaiono anche nella scheda Giochi & classifiche, in «Gioco per gioco», ognuno dentro il suo gioco insieme alle sue regole: è la stessa impostazione, vista da due posti. «Salva i comandi» qui e «Salva i giochi» là salvano solo le righe che hanno davanti, e lasciano le altre come le avevi salvate.

CONTATORify: le morti contate da sole

Sta nella seconda parte della scheda, «CONTATORify». La schermata di morte di un gioco è sempre la stessa immagine. La mostri una volta al pannello, e da lì il contatore sale da solo mentre giochi. Funziona con qualunque contatore: insegnagli la schermata di vittoria e hai !vittorie.

Serve la regia collegata in CONSOLify e questo pannello aperto sul computer da cui mandi in onda. L'immagine dello schermo non esce da lì: al server arriva solo «+1».

Il pannello può stare dietro al gioco: continua a guardare anche quando non lo vedi. Se lo apri in due schede guarda una sola, e se chiudi quella continua l'altra.

Quando premi il tasto, il pannello controlla se la schermata la conosce già. Se l'ha insegnata qualcun altro ti chiede «La conosco già: è la morte di «…»»: con «Prendi la sua» non devi insegnare niente, con «La insegno io» vai avanti. Poi chiede «Che schermata è?», di base «Morte», e premi «Impara».

Se manca qualcosa il pannello lo dice: «Scegli prima quale fonte devo guardare.», «Serve un contatore da far salire: creane uno nella scheda Comandi.», «Non riesco a guardare quella fonte: la regia è collegata?».

La riga sotto «Ogni quanto guardo (secondi)» ti dice cosa vede: «Spento.», «La regia non è collegata: senza, non posso guardare niente.», «Guardo…», «Sta già guardando un'altra scheda del pannello: se la chiudi, continuo io.», «Adesso vedo «…» (distanza N).», «Nessuna schermata riconosciuta adesso.», «Contata: …».

Conta quando la schermata compare, non finché resta: una morte che dura cinque secondi vale uno. Dopo una morte contata, per 4 secondi non ne conta altre. Conta solo mentre il programma di regia è in onda: le prove fuori diretta non sporcano il numero. Ogni morte fa salire il contatore del suo passo e il bot la dice in chat.

Puoi insegnare fino a 8 schermate, una per gioco: quella che combacia vince, così non devi dire tu a cosa stai giocando. Ogni schermata tiene fino a 12 impronte.

Nell'elenco delle schermate insegnate ogni riga ha i suoi tasti.

Le schermate che hanno già insegnato gli altri

Ogni schermata messa in comune la trovano tutti. Scrivi il gioco in «Che gioco stai giocando» e premi «Cerca» o Invio. Ogni risultato dice la lingua delle scritte, quante impronte ha e quante volte è stata presa. Scegli il contatore e premi «Prendila».

Una schermata presa è tua: quello che succede dopo nella libreria non la cambia, a meno che tu prenda una versione nuova. Se non trovi il tuo gioco leggi «Nessuno l'ha ancora insegnata.»: insegnala tu, e il prossimo la trova.

Certi giochi lo dicono da soli

Counter-Strike 2 e Dota 2 pubblicano da soli quante volte sei morto. Lì non c'è niente da riconoscere e il pannello non serve aperto: a parlare col bot è il gioco.

1. Scegli il contatoreIn «Quale contatore», accanto al gioco. «non contare» lo spegne per quel gioco.
2. Scarica il filePremi «Scarica il file» e mettilo nella cartella scritta sotto il nome del gioco, dentro la cartella del gioco: game/csgo/cfg per Counter-Strike 2, game/dota/cfg/gamestate_integration per Dota 2.
3. Riavvia il giocoDa lì in poi la riga sotto dice quando il gioco ha parlato l'ultima volta, oppure «Nessun gioco ha ancora parlato.».

Contano solo le tue morti: da spettatore o in un replay non sale niente. Fuori diretta il gioco parla ma il contatore non sale. La prima lettura dopo l'avvio non conta, perché le morti già fatte in quella partita non sono successe adesso. Ogni morte fa salire il contatore del suo passo e il bot la dice in chat.

Il file contiene una chiave che serve solo a far salire i contatori. Se il file è finito in giro, «Rifai la chiave» ne fa una nuova: i file che hai già messo smettono di funzionare e vanno riscaricati.

Il conto dal tuo computer

Per certi giochi il numero esatto delle morti c'è già, sul computer dove giochi. Nella carta «Il conto dal tuo computer» lo fai leggere al pannello. Serve Chrome o Edge su quel computer, con questo pannello aperto; i file restano lì, e al server arriva solo il numero.

I souls. DSDeaths (github.com/Quidrex/DSDeaths) è un programma gratuito che legge il numero dalla memoria del gioco e a ogni morte lo scrive in DSDeaths.txt, un numero e basta. Funziona con Dark Souls: Prepare to Die Edition, Dark Souls Remastered, Dark Souls II e Scholar of the First Sin, Dark Souls III, Sekiro, ed Elden Ring giocato offline con l'anticheat spento. Va bene anche un altro programma che scrive il conto in un file di testo, purché nel file ci sia un numero solo.

Minecraft Java. Il gioco scrive ogni messaggio della chat nel suo registro, logs/latest.log, e le frasi di morte sono le sue, nella lingua in cui giochi. Il pannello le legge dai file del tuo gioco e conta solo le tue: quando è un altro a morire, quando sei tu a uccidere, o quando qualcuno scrive la frase in chat, non sale niente. Chi sei lo dice il gioco quando parte.

1. Scegli il contatoreIn «Quale contatore faccio salire». «non contare» lo spegne.
2. Per i soulsAvvia DSDeaths insieme al gioco: crea DSDeaths.txt nella cartella da cui l'hai avviato. Premi «Scegli il file» e apri quel file.
3. Per MinecraftPremi «Scegli la cartella di Minecraft» e scegli .minecraft, la cartella del gioco. Con un launcher diverso da quello ufficiale scegli la cartella dell'istanza, quella con logs; se la riga dice che non trova le frasi, premi «Scegli la cartella dei file del gioco» e scegli quella del launcher con assets.

Da lì il pannello guarda ogni 2 secondi, anche da dietro al gioco. La riga sotto i tasti dice cosa legge: «Leggo «DSDeaths.txt»: 37.» oppure «Leggo Minecraft come «…»: N frasi di morte, lingua it_it.», e accanto «Fuori diretta leggo ma non conto.» o quante morti ha contato da quando guarda. Se qualcosa manca lo dice: un file senza un numero solo, una cartella senza logs/latest.log, i file del gioco che non trova, «Non so ancora chi sei: Minecraft lo scrive quando parte.».

Conta solo in diretta. Per un file conta quando il numero sale: se scende, o sale di più di 5 in un colpo, hai caricato un altro personaggio, e riparte da lì senza contare. Ogni morte fa salire il contatore del suo passo e il bot la dice in chat.

Quando riapri il pannello la prima lettura non conta, perché le morti fatte a pannello chiuso non sono successe adesso. Il pannello si ricorda la scelta: se il browser chiede di nuovo il permesso la riga lo dice e compare «Riprendi». «Smetti di leggere» la dimentica. Come per la schermata, legge una scheda sola.

Comandi vocali

Qui comandi il bot a voce mentre streammi, e lasci che il server riconosca da solo i momenti forti della diretta.

La trovi nella voce Il bot del menù, fra le schede in alto, dopo «Personalità», «Conoscenza» e «Memoria». Serve il pacchetto «Comandi Vocali» (0,99 € al mese, oppure dentro il pacchetto «Tutto»), che non è nell'Essenziale né nel Base. Senza, la scheda mostra «Non nel tuo piano», con «Guarda la demo» e il tasto per sbloccarlo; lo trovi anche nella scheda Abbonamento.

I comandi vocali veri e propri si costruiscono in Comandi, con l'innesco «Comando vocale (dal tuo PC)»: è lo stesso motore dei comandi di chat.

Momenti salienti (dal server)

Ci stiamo lavorando. È una parte secondaria che stiamo ancora rifinendo: funziona, ma può cambiare. Per ora ascolta solo le dirette su Twitch: su un canale di un'altra piattaforma la carta lo dice.

Qui è il server che ascolta l'audio della tua diretta Twitch e crea una clip da solo quando «esplode»: urla, risate, hype. Funziona anche se il tuo computer è occupato a giocare, e non c'entra col microfono.

Accanto all'interruttore leggi «in ascolto ora» quando il server ti sta ascoltando, «non in ascolto» quando no. Si aggiorna quando riapri il pannello.

L'ascolto parte solo mentre sei in diretta. Il server controlla ogni minuto chi è in diretta con l'ascolto acceso: può metterci un minuto a partire. Consuma risorse del server ed è limitato a pochi canali insieme: se i posti sono pieni, il tuo aspetta e parte appena se ne libera uno.

Nei primi secondi ascolta senza creare clip, per capire il volume normale della tua diretta. Fra due clip passano almeno 90 secondi. C'è un ritardo di 15-30 secondi dovuto a Twitch, ma la clip prende comunque il momento, perché guarda indietro. Le clip finiscono in In diretta → Clip, fra le «Ultime clip».

Comando vocale

I comandi vocali lavorano nel tuo browser. «Apri l'ascolto vocale» apre la pagina di ascolto in una scheda nuova: premi «Avvia ascolto» e tienila aperta mentre streammi. Quando dici una frase chiave, il bot fa quello che hai impostato nei moduli.

Il modello pronto «Comando vocale: clippa», nella carta Moduli di Comandi, crea una clip quando dici «clippa» o «salva la clip».

Cambia categoria a voce

Dici la parola chiave seguita dal gioco, «categoria Fortnite», e il bot cambia la categoria del canale su ogni sua piattaforma: Twitch o Kick, e tutte e due insieme se il canale è su Twitch e hai collegato Kick. Se ti sente male prova comunque a indovinare il gioco più somigliante fra le categorie di ciascuna. L'annuncio esce nella chat di ogni piattaforma dove il cambio è riuscito, e la carta dice in cima su quali piattaforme cambia. Su YouTube titolo e categoria non si cambiano ancora, e la carta lo dice; se colleghi Kick, li cambia su Kick. Conta ogni parola che dici: «diablo 4» non diventa «Diablo». Capisce i numeri romani o detti in lettere e le sigle più usate, come «gta 5» o «cs2». Se nessuna categoria somiglia abbastanza non cambia niente.

La parola chiave va detta prima del nome: «categoria Fortnite», non «metti Fortnite». Su Twitch serve il permesso Gestione canale: se manca, sotto compare un avviso con «Concedi il permesso», autorizzi e torni qui. Su Kick serve il permesso di Kick per titolo e categoria: se manca, l'avviso ha «Aggiorna i permessi di Kick», che ricollega Kick. Con tutte e due, ogni permesso ha il suo avviso, e se ne manca uno l'altra piattaforma cambia lo stesso.

Cambia titolo a voce

Dici la parola chiave seguita dal titolo, «titolo Si torna su Elden Ring, si punta al boss!», e il bot aggiorna il titolo della diretta su ogni piattaforma del canale (Twitch o Kick, e tutte e due se hai collegato Kick a un canale di Twitch), come lo dici. Il titolo si ferma a 140 caratteri.

Usa lo stesso permesso della categoria. Su Twitch, se manca, l'avviso ha il collegamento «Concedilo qui»; su Kick «Aggiorna i permessi di Kick».

Impara mentre parlo

La vede solo il proprietario. Con la pagina di ascolto aperta, il bot ti sente parlare in diretta e impara i tuoi modi di dire e il tuo tono. Impara solo dalla tua voce, mai da quella di un moderatore collegato al pannello.

L'interruttore si salva subito ed è spento di base. La trascrizione avviene nel browser: al bot arrivano le frasi che dici, di almeno 12 caratteri e fino a 200, senza i comandi. Il bot tiene le ultime 60.

La pagina di ascolto vocale

È la pagina che apri con «Apri l'ascolto vocale». Si usa dal computer da cui streammi, con lo stesso accesso del pannello, e si legge nella lingua che hai scelto nel pannello.

Il riconoscimento è in italiano, qualunque sia la lingua della pagina. Su Chrome ed Edge usa quello del browser, che non scarica niente. Dove il browser non ce l'ha (Dia, Arc, Brave) usa un motore locale: la prima volta scarica un modello di qualche decina di MB, poi funziona anche offline. Il cambio lo fa da solo e lo scrive nel registro.

La stessa frase non scatta due volte in 4 secondi.

Oltre ai tuoi moduli e ai due comandi di categoria e titolo, la pagina capisce il VIP: «vip a chiara», «vip a chiara per un mese» (anche «per 2 settimane», «per 3 giorni», «per sempre»; senza durata vale una settimana), e «togli vip a chiara». Il nome si cerca fra chi ha scritto in chat, e il bot risponde in chat: «👑 VIP a … per una settimana!», oppure «Non trovo nessuno che somigli a "…" in chat 🤔». Basta la parola «vip» seguita da un nome: attento a come la usi mentre parli.

Durante una penitenza a punti canale la pagina manda anche le frasi intere, per contare le parole vietate. Nel registro leggi «Penitenza in corso: conto quello che dici finché non finisce.». Le penitenze le spiega il manuale di sondaggi, giveaway e penitenze.

I messaggi del registro