Documentação

O Octera funciona com comandos de barra (/command) e comandos de texto usando o prefixo do seu servidor (padrão .). Quase tudo também pode ser configurado pelo painel na web.

Servidores Premium: a página Premium do painel (barra lateral → Settings) mostra a assinatura do servidor de relance — o plano, a data de renovação e quem paga — com os botões de melhorar e de gerenciar no mesmo lugar.

Prefixo & ajuda

Moderação

Segurança

Medição de calor, filtros de raid & de entrada, verificação e captcha são configurados no painel.

Níveis

Economia

Cargos & membros

Automação

Automações (painel → Utilities → Automations) são regras do tipo “quando isso acontecer, faça aquilo”: escolha um gatilho (uma mensagem é publicada, uma reação é adicionada, um membro entra, um cargo é adicionado ou removido), adicione condições opcionais (canal, cargo, palavras-chave, idade da conta) e execute até 10 ações em ordem — enviar uma mensagem, um embed ou uma DM, adicionar ou remover um cargo, reagir, apagar a mensagem ou abrir um tópico. Comece por modelos prontos como Welcomer, Keyword auto-reply e Auto-thread — até 50 por servidor, de graça.

Auto Send (painel → Utilities → Auto Send) publica uma mensagem recorrente em um intervalo ou diariamente em um horário UTC definido — escolha os dias da semana em que ela roda, adicione uma janela de envio opcional, ative o controle de repetição (que pula um envio enquanto a última mensagem do bot ainda for a mais recente) ou envie como embed.

Aniversários

Ligue os anúncios no painel (Utilidades → Aniversários): escolha o canal, personalize a mensagem e, se quiser, distribua um cargo de aniversário no dia.

Conquistas

Configure pelo painel (Achievements): ligue o recurso para ganhar um conjunto inicial pronto e depois crie os seus — metas únicas ou em faixas, de Bronze → Diamante, para mensagens, reações, tempo em voz, tópicos, impulsos, participações em sorteios, compras na loja e aniversários, cada uma com recompensas de cargo e anúncios de desbloqueio opcionais.

Convites

Ajuste no painel (Convites): ignore contas recém-criadas como falsas e distribua cargos de recompensa automaticamente nas metas de convites.

Sorteios

O editor Giveaways do painel vai além — agende ou repita sorteios, defina requisitos de participação e participações bônus, entregue cargos aos vencedores, personalize o embed e salve predefinições.

Tickets

Crie painéis de ticket no painel do site (módulo Tickets). Os membros abrem um ticket pelo botão do painel; a equipe assume e fecha. No fechamento, uma transcrição é salva e publicada, com um link View Online Transcript para ler no navegador.

Utilidades

Canais de voz temporários (painel → Utilities → Voice) funcionam por entrar-para-criar: escolha um ou mais canais de voz centrais, e quem entrar em um deles ganha o próprio canal ao lado — apagado automaticamente quando esvazia.

Só para o operador: /nuke channels, /nuke category e /restart são comandos de manutenção travados no código para o operador do bot — a equipe do servidor não consegue executá-los.

Notificações

Receba avisos quando um criador publica. No painel (Socials) adicione feeds do YouTube, Twitch, Kick, TikTok, Reddit (novos posts de um subreddit), Podcast (novos episódios pelo feed RSS de um programa) ou qualquer URL de Custom RSS — o Octera publica novos vídeos, posts, episódios e transmissões ao vivo no canal que você escolher, com uma mensagem personalizada.

Música

Toque música em um canal de voz com uma fila limpa — sem precisar convidar outro bot. (Premium.)

Busque uma música pelo nome ou cole um link — SoundCloud, Bandcamp, um podcast, uma rádio da internet ou uma URL de áudio direta. O Octera lê a maioria dos sites de áudio e diz de onde cada faixa veio.

O YouTube não está disponível. O YouTube bloqueia pedidos de reprodução vindos de provedores de hospedagem, que é onde todo bot de Discord roda — então links do YouTube são recusados em vez de tocados. Buscar pelo nome continua funcionando e toca das fontes acima. Links do Spotify e do Apple Music não podem ser tocados por nenhum bot, porque o áudio deles é criptografado; envie o nome da música.

Tradução

Membros que não falam o mesmo idioma podem conversar no mesmo canal. Ninguém precisa fazer nada diferente: quem quiser ler uma mensagem reage a ela com a bandeira do seu idioma, e o Octera publica a mensagem naquele idioma logo abaixo.

Reações com bandeiras. Reaja a qualquer mensagem com uma bandeira que o Octera reconheça e ele responde com a tradução. Várias pessoas reagindo com a mesma bandeira ainda geram só uma resposta, e reagir com qualquer outra coisa não faz nada.

Canais inteiros. No painel você pode escolher um canal e os idiomas falados nele, até cinco. O Octera descobre sozinho para que lado cada mensagem precisa ir, então um falante de espanhol e um de inglês podem simplesmente conversar. Uma mensagem que já está em um dos idiomas listados nunca é repetida no próprio idioma. Isso serve para um canal permanentemente dividido entre idiomas; para algo ocasional, as reações com bandeiras saem muito mais em conta.

Tradução ao vivo. Para quem entra em uma conversa em um idioma que não fala. A pessoa roda /translate live uma vez e tudo o que ela escreve também é publicado no outro idioma, até rodar /translate off ou ficar quieta. O dono do servidor pode desligar isso no painel.

A tradução usa um serviço de tradução externo, então o dono do servidor configura isso uma vez na página Tradução do painel. Enquanto nenhum serviço estiver conectado, a página avisa com todas as letras e nada é traduzido. Traduções repetidas da mesma mensagem vêm do cache e não custam nada, e você pode definir um limite mensal de caracteres para o servidor inteiro.

Backups

Tire um retrato da estrutura do seu servidor — cargos, canais, permissões e configurações — pelo painel. Uma restauração recria o que estiver faltando sem apagar o que já existe. Os backups nunca incluem mensagens nem histórico de conversa.

Guia: variáveis de mensagem

Em qualquer lugar em que o Octera escreve uma mensagem você pode inserir uma variável — um marcador curto {name} que se preenche sozinho na hora do envio. Elas funcionam em mensagens de boas-vindas e de despedida, embeds, autorrespostas, tags, envio automático, painéis de cargos por reação, painéis de ticket e mais — com os mesmos nomes em todo lugar.

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

Escreva com ponto ou com parênteses; dá no mesmo: {user.name} = {user(name)}.

O membro

{target} funciona do mesmo jeito para a primeira pessoa @mencionada em um comando (caindo para quem executou, quando não houver) — útil em tags: {target.mention}, {target.avatar}.

O servidor & o canal

Imagens vindas de variáveis

Os campos de imagem, miniatura, ícone do autor e ícone do rodapé aceitam uma variável no lugar de um link — assim um embed de boas-vindas pode mostrar o próprio avatar do novo membro:

Cada um desses campos também aceita um link https:// normal, ou um Upload… direto do seu computador — o Octera guarda a imagem e usa um link permanente, então ela continua funcionando para sempre.

Bom saber

• Uma variável que não existe é resolvida pela correspondência mais próxima, em vez de dar erro — se algo aparecer estranho, confira a grafia nas tabelas acima.
• As variáveis são preenchidas no envio da mensagem, então uma prévia no painel mostra o texto {name} cru.
• Tags e comandos personalizados acrescentam lógica em cima disso — veja como criar comandos de tag.

Gerenciando seu servidor: manias do Discord que vale conhecer

Algumas coisas no Discord funcionam de um jeito que parece defeito, mas não é — quase todo dono de servidor cai nelas em algum momento. Nenhuma delas é causada pelo Octera; as soluções estão todas nas próprias configurações do Discord.

Um nome de usuário está com a cor errada

O Discord colore um nome usando o cargo mais alto que tem cor. Um cargo definido como Padrão (sem cor) deveria ser ignorado, então um cargo sem cor que você mantém no topo — normalmente para aparecer separado na lista de membros — deveria deixar a cor para um cargo mais abaixo.

Às vezes não resolve. O Discord guarda os dados da cor antiga de um cargo mesmo depois de o cargo aparecer como sem cor, então o nome fica preso na cor errada.

Force o Discord a reler o cargo:

1. Abra Configurações do Servidor → Cargos, escolha o cargo afetado e vá em Exibição.
2. Deixe em Sólido, escolha qualquer cor visível e salve.
3. Abra o mesmo cargo de novo, volte para Padrão (sem cor) e salve outra vez.
4. Pressione Ctrl + R para recarregar o Discord.

Agora o cargo é reconhecido como realmente sem cor: ele continua no topo e segue exibindo os membros separadamente, e o próximo cargo abaixo que tenha cor passa a dar a cor do nome.

A coroa de dono sumiu do lado do seu nome

A coroa some quando um dos seus cargos está com as duas opções ligadas ao mesmo tempo:

• permissão de Administrador, e
• Exibir os membros do cargo separadamente dos membros online.

Para manter o seu próprio cargo exibido separadamente e recuperar a coroa:

1. Abra Configurações do Servidor → Cargos e escolha o seu cargo pessoal exibido separadamente.
2. Desligue Administrador para esse cargo — deixe Exibir membros do cargo separadamente ligado.
3. Pressione Ctrl + R para recarregar o Discord.

Guia: como criar comandos de tag

Tags são comandos de prefixo personalizados que você mesmo escreve, movidos pelo TagScript — uma linguagem de modelo minúscula com variáveis, lógica, matemática, aleatoriedade e blocos de controle (apagar o gatilho, mandar a resposta na DM, reagir, restringir por cargo, anexar um embed e mais). Toda variável de mensagem também funciona aqui.

Criar uma tag

Use /tag (ou o painel → Utilidades → Tags). Dê um nome e um conteúdo. Os membros executam com o seu prefixo, ex.: .rules.

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

Ao rodar .hello → Ei @Você, boas-vindas ao Octera! 👋

Variáveis

Toda variável de mensagem funciona em uma tag — {user.mention}, {server}, {avatar} e as demais. As tags acrescentam algumas próprias:

Lógica, matemática & aleatoriedade

Blocos de controle (efeitos colaterais)

Exemplos práticos

Caixa de sugestões — apaga o comando e publica um embed limpo em um canal:

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

Cara ou coroa com reações:

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

Anúncio só para a equipe — restrito por cargo, não manda DM para ninguém, publica em um canal:

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

Boas-vindas personalizadas usando um alvo mencionado:

{=(msg):Welcome {target(mention)} — you're member #{server(member_count)}!}{if({args}==):Mention someone to welcome them.|{msg}}