Documentazione

Octera funziona con comandi slash (/command) e comandi testuali che usano il prefisso del tuo server (predefinito .). Quasi tutto è configurabile anche dalla dashboard web.

Suggerimento: scrivi .help <command> (es. .help ban, .help eco) per sapere cosa fa un comando con esempi reali — oppure .help <category> per un'intera sezione. Anche <command> help continua a funzionare.

Server Premium: la pagina Premium della dashboard (barra laterale → Impostazioni) mostra a colpo d'occhio l'abbonamento del server — il piano, la data di rinnovo e chi paga — con i pulsanti per l'upgrade e la gestione nello stesso punto.

Prefisso & aiuto

/help [query]
Menu dei comandi per categoria — oppure indica un comando per vederne l'uso + gli esempi, o una categoria per elencarla.
Esempio: .help timeout
/prefix [set]
Mostra o cambia il prefisso dei comandi testuali (Gestisci server).
Esempio: /prefix set: ?
/enable & /disable <targets>
Attiva o disattiva moduli e/o comandi — anche più di uno alla volta.
Esempio: /disable economy music warn

Moderazione

/warn @user [reason]
Ammonisci un membro; aggiunge punti di escalation e registra un caso.
/timeout @user <duration> [reason]
Silenzia temporaneamente un membro.
Esempio: /timeout @user 10m spamming
/kick · /ban · /unban
Moderazione standard, tutta registrata come casi.
/case [id|@user]
Consulta un caso specifico o la cronologia completa di un membro.
/modlog
Imposta il canale dei log di moderazione.
/unbanall run
Sbanna in massa tutti tranne una blacklist protetta.
/unbanall blacklist add|remove|list
Gestisci quella lista protetta — gli utenti che lo sban di massa non toccherà mai.
/purge <all | number | time span> [@user]
Cancella messaggi in blocco. all svuota il canale (e lo blocca durante la pulizia se è grande), un numero cancella quella quantità di messaggi recenti, oppure un intervallo di tempo (es. 7d, 2mo) cancella quella finestra. Aggiungi un utente per cancellare solo i suoi messaggi. Nota: Discord non permette ai bot di cancellare in blocco messaggi più vecchi di 14 giorni.
Esempio: .purge 50 · .purge 2mo · .purge all

Sicurezza

/security
Anti-nuke, ruolo di quarantena e informazioni sulla protezione.
/quarantine @user · /release @user
Togli i ruoli a un membro e isolalo, oppure restituiscili.
/security panic on|off
Blocco d'emergenza — blocca i canali e/o metti in quarantena i nuovi ingressi.
/security let-in @user · let-in-remove @user · let-in-list
Fa passare qualcuno direttamente oltre i filtri d'ingresso, l'espulsione per raid di ingressi e la verifica, come un amico con un account appena creato. La stessa lista si trova nella pagina Ingressi server, e quando i controlli d'ingresso rimuovono qualcuno, la sua voce nei tuoi log ha un pulsante che lo fa entrare.
Esempio: /security let-in @friend
/lockdown all|channel|end
Blocca tutti i canali (o uno solo) così i membri non possono scrivere — /lockdown end lo revoca e ripristina tutto.
Esempio: /lockdown all

Tracciamento heat, filtri raid & join-gate, verifica e captcha si configurano dalla dashboard.

Livelli

/rank [@user]
Mostra livello & XP con una card di rank.
/leaderboard
I migliori membri per XP.
/xp · /level
Admin: aggiungi/rimuovi/imposta gli XP o il livello di un membro.
/leveling
Imposta il canale dei passaggi di livello e importa i livelli da altri bot.

Economia

/balance · /bank
Portafoglio, banca e interessi.
/deposit · /withdraw · /pay
Sposta o invia monete.
/work · /crime · /rob · /daily
Guadagna monete. La fortuna (da oggetti & ciondoli) migliora le probabilità di /crime, /rob, raccolta e lootbox.
/farm
Cura la tua fattoria da un pannello interattivo — pianta le colture, raccoglile, vendi la merce e compra nuovi appezzamenti.
/fish · /hunt · /dig · /search
Minigiochi di raccolta, ognuno con il proprio cooldown — trova monete e merci da vendere.
/pet
Adotta un compagno, tienilo nutrito e raccogli monete da lui ogni ora.
/trade @user
Proponi uno scambio — monete e/o merce — che l'altro membro accetta o rifiuta.
/coinflip · /slots · /blackjack · /roulette · /highlow · /rps · /guess · /dice
Scommetti le tue monete — otto giochi da casinò.
/economy-info guide|games
Una guida rapida a come funziona tutta l'economia, con ogni gioco del casinò e la sua vincita. (.games funziona ancora come scorciatoia.)
/shop · /buy · /sell · /use · /open
Sfoglia il negozio (pulsanti d'acquisto), compra/vendi oggetti, usa consumabili, apri lootbox.
Esempio: .buy lucky coin 3
/inventory · /collect · /multipliers · /rich
Oggetti, ruoli con rendita, buff & debuff attivi e la classifica dei più ricchi.
/eco
Admin: dai/togli monete o oggetti del negozio, concedi boost a tempo, applica gli interessi.
/lootbox
Gestore: lootbox a sorpresa che i membri fanno a gara ad aprire — lanciane una adesso, attiva o disattiva i drop automatici, imposta ogni quanto arrivano e quanto pagano (monete o XP).

Ruoli & membri

/role <add|remove> <roles> (user or everyone) [duration]
Aggiungi o rimuovi uno o più ruoli a un membro o a tutti. Una durata lo rende un ruolo a tempo — rimosso automaticamente alla scadenza.
Esempio: /role add roles:@VIP @Booster user:@someone duration:7d
/serverinfo
Statistiche del server — proprietario, data di creazione, membri, ruoli, canali, boost.
/info [@user]
Età dell'account di un membro, data d'ingresso, ruoli e colore.
/av [@user]
Mostra l'avatar di un utente a dimensione piena.
/roles
Elenca ogni ruolo con il suo ID.
/dump [role]
Esporta in un file i membri di un ruolo (oppure dell'intero server).
/oldest · /youngest
Il membro con l'account Discord più vecchio / più recente.
/clonecategory · /stylechannels · /cleanroles · /counters
Clona una categoria con i permessi, aggiungi prefissi emoji ai canali, rimuovi le decorazioni dai nomi dei ruoli, crea canali con statistiche live.

Automazione

/tag
Comandi con prefisso personalizzati scritti in TagScript — vedi la guida qui sotto.
/reactionrole sync|list|convert
Pubblica o aggiorna i tuoi menu ruoli, oppure convertili tutti tra pulsanti / menu a tendina / emoji di reazione.
/embed post|list|copy|color|edit|source
Tutti gli strumenti per gli embed in un solo comando — pubblica o elenca gli embed salvati, copia gli embed pubblicati tra canali o categorie, ricolora ogni embed pubblicato dal bot, modificane uno da JSON grezzo, oppure preleva gli embed + il contenuto di un messaggio in formato JSON.
/log list
Elenca i percorsi di logging degli eventi — il logging vero e proprio si configura dalla dashboard.
/stealemoji <emoji> [name]
Aggiungi a questo server un'emoji personalizzata presa da un altro. La pagina Emoji della dashboard gestisce tutto il tuo set — carica, rinomina, rimuovi, preleva e controlla gli slot utilizzati.

Automations (dashboard → Utilities → Automations) sono regole del tipo «quando succede questo, fai quello»: scegli un trigger (viene pubblicato un messaggio, viene aggiunta una reazione, entra un membro, viene aggiunto o rimosso un ruolo), aggiungi condizioni opzionali (canale, ruolo, parole chiave, età dell'account) e poi esegui fino a 10 azioni in ordine — invia un messaggio, un embed o un DM, aggiungi o rimuovi un ruolo, reagisci, elimina il messaggio o apri un thread. Parti da modelli già pronti come Welcomer, Keyword auto-reply e Auto-thread — fino a 50 per server, gratis.

Auto Send (dashboard → Utilities → Auto Send) pubblica un messaggio ricorrente a intervalli regolari oppure ogni giorno a un orario UTC prestabilito — scegli i giorni della settimana in cui parte, aggiungi una finestra di invio opzionale, attiva il controllo del flood (salta un invio se l'ultimo messaggio del bot è ancora il più recente) o invialo come embed.

Compleanni

/birthday set <date> [year]
Salva il tuo compleanno — MM-DD o YYYY-MM-DD. Aggiungi l'anno se vuoi che si festeggi anche la tua età.
Esempio: /birthday set 10-12 · /birthday set 1993-12-16
/birthday view [@user] · /birthday next
Vedi il compleanno di un membro, o i prossimi 10 in arrivo nel server.
/birthday remove
Rimuovi il compleanno che hai salvato.
/birthday set-user @user <date>
Admin: imposta il compleanno di un membro (Gestisci server).

Attiva gli annunci dalla dashboard (Utilities → Birthdays): scegli il canale, personalizza il messaggio e, se vuoi, assegna un ruolo compleanno per la giornata.

Obiettivi

/achievements [@user]
I tuoi progressi negli obiettivi (o quelli di un membro) — ogni livello sbloccato e il traguardo successivo, con un link alla pagina pubblica degli obiettivi del server.

Configurali dalla dashboard (Obiettivi): attiva la funzione per ottenere un set iniziale già pronto, poi aggiungi i tuoi — obiettivi singoli o a livelli da Bronzo → Diamante su messaggi, reazioni, tempo in vocale, thread, boost, partecipazioni ai giveaway, acquisti nel negozio e compleanni, ognuno con ricompense in ruoli facoltative e annunci di sblocco.

Inviti

/invites me · /invites user @member
Quanti inviti hai tu (o un membro) — con ingressi, uscite e falsi in dettaglio.
Esempio: /invites user member: @friend
/invites leaderboard
La classifica di chi porta più inviti nel server.
/invites who-invited [@member]
Scopri chi ha invitato un membro. Ogni ingresso viene attribuito automaticamente — funziona qualsiasi link di invito normale, non serve un link tracciato speciale.

Regolalo dalla dashboard (Invites): ignora come falsi gli account appena creati e assegna in automatico ruoli premio ai traguardi di inviti.

Giveaway

/giveaway start <duration> <prize> [winners]
Avvia un giveaway con un pulsante 🎉 Partecipa, timer live ed estrazione automatica dei vincitori — oppure usa /giveaway create per una procedura guidata passo passo.
Esempio: /giveaway start duration: 1d prize: Nitro winners: 2
/giveaway end|reroll|cancel|delete|list
Chiudine uno in anticipo, estrai nuovi vincitori, annullalo o eliminalo, oppure elenca i giveaway recenti.

L'editor Giveaway della dashboard va oltre — programma o ripeti i giveaway, imposta requisiti di partecipazione e partecipazioni bonus, assegna ruoli ai vincitori, personalizza l'embed e salva i preset.

Ticket

Crea pannelli ticket dalla dashboard (modulo Tickets). I membri aprono un ticket dal pulsante del pannello; lo staff lo prende in carico e lo chiude. Alla chiusura viene salvata e pubblicata una trascrizione, con un link View Online Transcript per leggerla nel browser.

/close [reason]
Chiudi il ticket corrente e salva la sua trascrizione.
/ticket add|remove|blacklist|unblacklist
Staff: aggiungi o rimuovi qualcuno dal ticket corrente, oppure impedisci a chi abusa del sistema di aprire nuovi ticket.

Utilità

/ping
Latenza del bot.
/poll create|end
Pubblica un sondaggio nativo di Discord che i membri votano direttamente nel messaggio, oppure chiudilo in anticipo. Anche la pagina Sondaggi della dashboard crea sondaggi — con fino a 10 risposte, durata personalizzata e selezione multipla.
/voice rename|limit|lock|unlock|claim
Gestisci il tuo canale vocale temporaneo — rinominalo, imposta un limite di utenti, bloccalo o sbloccalo, oppure reclamalo se il proprietario se n'è andato.
Esempio: /voice rename name: Gaming · /voice lock

Canali vocali temporanei (dashboard → Utilities → Voice): funzionano a entra-e-crea, scegli uno o più canali vocali hub e i membri che ne entrano ottengono un canale tutto loro lì accanto — eliminato automaticamente quando si svuota.

Solo per l'operatore: /nuke channels, /nuke category e /restart sono comandi di manutenzione riservati nel codice al solo operatore del bot — lo staff del server non può eseguirli.

Notifiche

Ricevi un avviso quando un creator pubblica. Dalla dashboard (Socials) aggiungi feed per YouTube, Twitch, Kick, TikTok, Reddit (i nuovi post di un subreddit), Podcast (nuovi episodi dal feed RSS di un programma) o qualsiasi URL Custom RSS — Octera pubblica nuovi caricamenti, post, episodi e dirette nel canale che scegli, con un messaggio personalizzato.

Musica

Riproduci musica in un canale vocale con una coda pulita — senza invitare un altro bot. (Premium.)

Cerca un brano per nome, oppure incolla un link — SoundCloud, Bandcamp, un podcast, una radio online o un URL audio diretto. Octera legge la maggior parte dei siti audio e ti dice da dove arriva un brano.

YouTube non è disponibile. YouTube blocca le richieste di riproduzione che arrivano dai provider di hosting, cioè da dove gira ogni bot di Discord — quindi i link di YouTube vengono rifiutati invece che riprodotti. La ricerca per nome funziona comunque e riproduce dalle fonti qui sopra. I link di Spotify e Apple Music non possono essere riprodotti da nessun bot, perché il loro audio è cifrato; manda invece il nome del brano.

/play <song or link>
Riproduci un brano o aggiungilo alla coda. Accetta una ricerca o un link da qualsiasi sito che Octera è davvero in grado di riprodurre.
/skip · /stop
Salta il brano attuale, oppure ferma tutto ed esci dal canale vocale.
/music join|controls|queue|nowplaying|loop|pause|resume
Tutto il resto in un solo comando — porta il bot in vocale, apri il pannello di controllo a pulsanti, guarda la coda e il brano in riproduzione, ripeti la traccia o la coda, metti in pausa o riprendi. (Le vecchie abitudini con il prefisso come .queue e .pause funzionano ancora.)

Traduzione

Membri che non parlano la stessa lingua possono conversare nello stesso canale. Nessuno deve cambiare abitudini: chi vuole leggere un messaggio reagisce con la bandiera della propria lingua e Octera lo ripubblica sotto in quella lingua.

/translate text <text> <to> [from]
Traduci una cosa al volo. Inizia a scrivere una lingua e ti proporrà quelle che conosce.
Esempio: /translate text text: where is the meeting to: Spanish
/translate live <from> <to>
Continua a tradurre tutto quello che dici in questo canale, finché non lo interrompi o resti in silenzio per tre ore.
Esempio: /translate live from: Chinese to: English
/translate off
Smetti di tradurre ciò che dici in questo canale.

Reazioni con le bandiere. Reagisci a un messaggio qualsiasi con una bandiera che Octera riconosce e ti risponderà con la traduzione. Anche se più persone reagiscono con la stessa bandiera, la risposta resta una sola, e reagire con qualcos'altro non fa nulla.

Interi canali. Dalla dashboard puoi scegliere un canale e le lingue che vi si parlano, fino a cinque. Octera capisce da sola in che direzione deve andare ogni messaggio, così un ispanofono e un anglofono possono semplicemente parlare. Un messaggio già scritto in una delle lingue elencate non viene mai ripetuto nella sua stessa lingua. È la scelta giusta per un canale stabilmente diviso tra più lingue; per un uso occasionale le reazioni con le bandiere costano molto meno.

Traduzione live. Pensata per chi entra in una conversazione in una lingua che non parla. Esegue /translate live una volta e tutto ciò che scrive viene pubblicato anche nell'altra lingua, finché non esegue /translate off o smette di scrivere. Il proprietario del server può disattivarla dalla dashboard.

La traduzione si appoggia a un servizio di traduzione esterno, quindi il proprietario del server la configura una volta sola nella pagina Translation della dashboard. Finché non è collegato un servizio, la pagina lo dice chiaramente e non viene tradotto nulla. Le traduzioni ripetute dello stesso messaggio arrivano dalla cache e non costano nulla, e puoi impostare un limite mensile di caratteri per l'intero server.

Backup

Cattura un'istantanea della struttura del tuo server — ruoli, canali, permessi e impostazioni — dalla dashboard. Un ripristino ricrea tutto ciò che manca senza cancellare ciò che c'è già. I backup non includono mai i messaggi né la cronologia della chat.

Guida: variabili dei messaggi

Ovunque Octera scriva un messaggio puoi inserire una variabile — un breve segnaposto {name} che si compila da solo quando il messaggio viene inviato. Funzionano nei messaggi di benvenuto e di addio, negli embed, nelle risposte automatiche, nei tag, nell'invio automatico, nei pannelli dei ruoli reazione, nei pannelli dei ticket e altro ancora — con gli stessi nomi ovunque.

Welcome {user.mention} to **{server}** — you're member #{server.members}!

Scrivile con il punto o con le parentesi; è la stessa cosa: {user.name} = {user(name)}.

Il membro

VariabileViene sostituito con
{user}Il suo nome
{user.mention}Un @ping vero
{user.name}Il suo nome utente
{user.nick}Il suo nickname in questo server (il nome utente se non ne ha uno)
{user.id}Il suo ID Discord
{avatar}La sua immagine del profilo — inseriscila in uno slot immagine o miniatura
{user.color}Il colore del suo nome, es. #a93bf0
{user.top_role}Il nome del suo ruolo più alto
{user.joinstamp}Quando è entrato, come numero di timestamp
{user.timestamp}Quando è stato creato il suo account, come numero di timestamp

{target} funziona allo stesso modo per la prima persona @menzionata in un comando (in mancanza, per chi lo ha eseguito) — comodo nei tag: {target.mention}, {target.avatar}.

Il server & il canale

VariabileViene sostituito con
{server}Nome del server
{server.members}Numero di membri
{server.ordinal}Numero di membri come posizione — «42º»
{server.icon}L'icona del server — utilizzabile in uno slot immagine o miniatura
{server.id}ID del server
{server.description}La descrizione del server
{channel}Nome del canale
{channel.mention}Un link #canale cliccabile

Immagini dalle variabili

Gli slot immagine, miniatura, icona autore e icona del piè di pagina accettano una variabile al posto di un link — così un embed di benvenuto può mostrare l'avatar del nuovo membro:

Metti {avatar} nello slot thumbnail di un embed di benvenuto e ogni nuovo arrivato vedrà la propria immagine nell'angolo. {server.icon} funziona allo stesso modo.

Ognuno di quegli slot accetta anche un normale link https://, oppure un Upload… direttamente dal tuo computer — Octera conserva l'immagine e usa un link permanente, così continua a funzionare per sempre.

Da sapere

Gestire il tuo server: le stranezze di Discord che vale la pena conoscere

Alcune cose in Discord si comportano in modi che sembrano guasti ma non lo sono — prima o poi ci cascano quasi tutti i proprietari di server. Nessuna di queste dipende da Octera; le soluzioni sono tutte nelle impostazioni di Discord.

Un nome utente mostra il colore sbagliato

Discord colora un nome usando il ruolo più alto che ha un colore. Un ruolo impostato su Predefinito (nessun colore) viene volutamente saltato, quindi un ruolo senza colore che tieni in cima — di solito per comparire separato nella lista dei membri — dovrebbe lasciare il colore a un ruolo più in basso.

A volte non basta. Discord conserva i vecchi dati di colore di un ruolo anche quando il ruolo risulta senza colore, così il nome resta bloccato sul colore sbagliato.

Forza Discord a rileggere il ruolo:

  1. Apri Impostazioni server → Ruoli, seleziona il ruolo interessato e vai su Aspetto.
  2. Impostalo su Tinta unita, scegli un colore visibile qualsiasi e salva.
  3. Riapri lo stesso ruolo, riportalo su Predefinito (nessun colore) e salva di nuovo.
  4. Premi Ctrl + R per ricaricare Discord.

Ora il ruolo risulta davvero privo di colore: resta in cima e continua a mostrare i membri separatamente, mentre il colore del nome passa al primo ruolo colorato sotto di esso.

La corona da proprietario è sparita accanto al tuo nome

La corona sparisce quando uno dei tuoi ruoli ha entrambe queste opzioni attive insieme:

Per tenere il tuo ruolo in evidenza e riavere la corona:

  1. Apri Impostazioni server → Ruoli e seleziona il tuo ruolo personale mostrato separatamente.
  2. Disattiva Amministratore per quel ruolo — lascia attivo Mostra i membri del ruolo separatamente.
  3. Premi Ctrl + R per ricaricare Discord.
Non perdi nulla: il proprietario di un server ha già ogni permesso, quindi un ruolo personale non ha mai bisogno di Amministratore. Per il tuo staff, crea un ruolo Admin separato con Amministratore attivo e Mostra i membri del ruolo separatamente disattivato.

Guida: creare comandi tag

I tag sono comandi con prefisso che scrivi tu, basati su TagScript — un piccolo linguaggio di template con variabili, logica, matematica, casualità e blocchi di controllo (cancella il messaggio che lo ha attivato, invia la risposta in DM, reagisci, limita per ruolo, allega un embed e altro ancora). Anche ogni variabile di messaggio funziona qui.

Crea un tag

Usa /tag (oppure dashboard → Utilities → Tags). Dagli un nome e un contenuto. I membri lo eseguono con il tuo prefisso, es. .rules.

/tag name: hello content: Hey {user(mention)}, welcome to {server(name)}! 👋

Eseguendo .hello → Ehi @You, benvenuto su Octera! 👋

Variabili

Ogni variabile di messaggio funziona in un tag — {user.mention}, {server}, {avatar} e tutte le altre. I tag ne aggiungono alcune proprie:

VariabileTi dà
{args}Tutto ciò che scrivi dopo il comando. {args(1)} = prima parola, {args(2)} = seconda…
{target(mention)}La prima @menzione nel messaggio (altrimenti chi lo ha eseguito) — stessi attributi di {user}
{uses}Quante volte il tag è stato eseguito
{unix}Timestamp unix attuale

Logica, matematica & casualità

BloccoCosa fa
{if(a==b):yes|no}Condizionale. Operatori: == != > < >= <=
{any(a==b|c==d):yes|no}any/or e all/and su più condizioni
{math:2*(3+4)}Aritmetica (+ - * / % ^)
{random:a~b~c}Scegline uno a caso (separa con ~ o ,)
{range:1-100}Numero intero casuale in un intervallo
{=(name):value}Imposta una variabile; rileggila poi con {name}
{lower} {upper} {replace(a,b):text} {length:text}Strumenti per il testo

Blocchi di controllo (effetti collaterali)

BloccoEffetto
{delete}Cancella il messaggio che ha attivato il tag
{dm}Invia invece la risposta nei DM di chi esegue il comando
{react:✅,🎉}Reagisci alla risposta · {reactu:✅} reagisce al messaggio che lo ha attivato
{redirect:#channel}Invia la risposta in un altro canale
{require(@Role)} / {blacklist(@Role)}Consenti solo / non consentire mai a questi ruoli o canali di usare il tag
{embed(title):Hi}{embed(description):...}Crea un embed completo (titolo, descrizione, colore, immagine, miniatura, footer, campo)
{silent}Esegui gli effetti collaterali del tag senza inviare testo

Esempi pratici

Cassetta dei suggerimenti — cancella il comando e pubblica un embed pulito in un canale:

{delete}{redirect:#suggestions}{embed(title):💡 Suggestion from {user(name)}}{embed(description):{args}}{embed(color):#a855f7}

Testa o croce con le reazioni:

{user(mention)} flips… **{random:Heads~Tails}**! {react:🪙}

Annuncio riservato allo staff — limitato per ruolo, non manda DM a nessuno, pubblica in un canale:

{require(@Staff):You can't use this.}{redirect:#announcements}📢 {args}

Benvenuto personalizzato con una menzione come destinatario:

{=(msg):Welcome {target(mention)} — you're member #{server(member_count)}!}{if({args}==):Mention someone to welcome them.|{msg}}
Tutto ciò che puoi fare con un tag puoi costruirlo anche visivamente con Message Templates e Autoresponders nella dashboard.