Comandos personalizados | Documentação do Noxyr

O que é um comando personalizado

Um comando personalizado é um novo nome para um comando que o Noxyr já tem. $store pode executar $shop, $done pode executar $ticket close, e $gnitro pode executar $giveaway create com o prêmio já preenchido como Discord Nitro. Os membros digitam o novo nome como mensagem com o prefixo do seu servidor, e o bot executa o comando real.

Ele nunca adiciona comportamentos novos. O comando real roda com as próprias permissões, chave de módulo e tempos de espera, então um nome personalizado não pode dar a ninguém um acesso que não tinha. O nome original continua funcionando junto com o novo.

Crie um

Abra o painel, escolha seu servidor e vá em Controle e depois em Comandos personalizados.
Clique em Novo comando personalizado, ou abra Modelos e clique em um para adicioná-lo pronto.
Digite o novo nome na caixa Gatilho, por exemplo store.
Escolha o comando que ele executa na caixa Comando, e a ação, se esse comando tiver várias (ticket tem close, claim, rename e mais).
Opcional: predefina uma opção ligando um Valor a ela, por exemplo prize definido como Discord Nitro.
As mudanças são salvas sozinhas cerca de um segundo depois que você para de editar. O status ao lado do botão Salvar informa quando elas são salvas.

Comandos personalizados são comandos com prefixo: funcionam como mensagens, como $store, e não no menu /. O Discord só permite que um bot registre os próprios comandos de barra, não um por servidor.

Gráfico e Lista simples

A página tem duas visões da mesma lista. Gráfico mostra cada comando personalizado como um Gatilho ligado a um Comando, com Valores ligados às suas opções: arraste um ponto até outro ponto para conectá-los, clique em um fio para cortá-lo e arraste uma caixa pelo título para movê-la. Organizar alinha tudo de novo.

Lista simples mostra a mesma coisa como linhas simples, com um nome, um seletor de comando e valores predefinidos. Use a que preferir; trocar de visão não muda nada.

O painel à esquerda lista cada comando personalizado como nome antigo, seta, nome novo. Cada um tem uma chave de ligar e desligar, para que você possa pausar um nome sem excluí-lo, e um botão de excluir.

Modelos

Os modelos adicionam um comando personalizado pronto com um clique. Um modelo cujo nome você já usa fica acinzentado.

Música: $p (tocar), $np (tocando), $s (pular), $q (fila), $dc (sair), $vol (volume), $repeat (repetir a fila), $bass (filtro bass boost), $247 (tocar 24/7)
Tickets: $done (fechar ticket), $claim (assumir ticket), $faqs (lista de FAQs do ticket)
Loja: $store (loja), $vouch (enviar avaliação)
Comunidade: $gnitro (giveaway create, prize Discord Nitro), $apply (application apply), $lb (ranking)
Moderação: $purge (limpar)

Valores predefinidos e opções digitadas

Um valor predefinido é preenchido toda vez que o comando personalizado é executado. Tudo o que um membro digitar depois do nome é acrescentado, então $gnitro 1h 1 continua funcionando com o prêmio já definido. Se o membro digitar a mesma opção pelo nome (prize:"Gift card"), o valor dele vence o predefinido.

Valores: Até 200 caracteres, sem aspas duplas nem quebras de linha.
Opções fixas: Uma opção com lista fixa, como o modo de repetição ou um filtro, aceita apenas um valor dessa lista.
Números: Opções de número inteiro e de número só aceitam números; opções de sim/não aceitam yes, no, on, off, true e false.
Arquivos: Opções de arquivo não podem ser predefinidas.

Regras para nomes

Caracteres: Letras, números, - e _, até 32 caracteres. Espaços viram traços enquanto você digita, e os nomes ficam em minúsculas.
Nomes reais: Um comando personalizado não pode usar o nome de um comando real do Noxyr. Nomes reais sempre vencem.
Único: Cada nome só pode ser usado uma vez por servidor.
Limite: Até 100 comandos personalizados por servidor.

A página lista qualquer coisa que impeça um salvamento, acima do editor. Clique em um problema para ir até a caixa que precisa de correção.

Mudando o prefixo

A caixa Prefixo na parte de baixo do painel à esquerda muda o prefixo do servidor inteiro: comandos personalizados e todos os comandos normais. Digite até 5 caracteres sem espaços, por exemplo !, ?, . ou n!, e clique em Salvar. Deixe vazio para o padrão $. Todos os nomes na página são atualizados para o novo prefixo imediatamente.

A mesma configuração está na página Setup e no Discord com /prefix set.

Bot personalizado

Se o servidor usa um bot personalizado do Noxyr, ele responde aos mesmos comandos personalizados com o mesmo prefixo. Nada precisa ser configurado duas vezes.