> ## Documentation Index > Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt > Use this file to discover all available pages before exploring further. # Prefixo > O texto antes de cada comando (! e petto por padrão): um servidor pode ter vários prefixos, como ver e mudar, pular argumentos opcionais com --flags, e quais comandos também funcionam com /. ## Visão geral Todo comando começa com um prefixo do servidor: `!` e a palavra `petto` por padrão (`!help` e `petto help` funcionam). A palavra `petto` sempre funciona, quaisquer que sejam os prefixos que você escolher (mesmo que o servidor use só `!n`), e não pode ser removida. Os argumentos vão em ordem e separados por espaço; coloque entre "aspas" qualquer coisa que tenha espaços. Um servidor pode ter **vários prefixos**, até 10. O primeiro é o prefixo principal: a ajuda, os cartões e os exemplos mostram ele. Um servidor que escolheu um prefixo próprio mantém exatamente esse. Se você esquecer um prefixo personalizado, mencione o Petto: `@Petto prefix` sempre funciona e mostra o prefixo atual. ![kira digita !prefix e nada acontece, depois @Petto prefix mostra que o prefixo do servidor é ?](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-mention.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=d9043412c1f9d45c02197da8ef624b97) No Discord: com um prefixo esquecido, !prefix não recebe resposta, mas uma menção ao Petto sim. ## Vários prefixos * **Um símbolo** (`!`, `,`, `?`, `p!`) se escreve colado ao comando: `,help`. Um espaço depois (`, oi`) não é um comando. * **Uma palavra** (termina em letra ou número, como `petto`) não diferencia maiúsculas e precisa de um espaço: `petto help` ou `Petto help`. Só inicia um comando quando a palavra seguinte é um comando real, um alias ou um comando personalizado, então `petto é demais` é só conversa. * **O prefixo mais longo vai primeiro**, então com `!` e `!!` na lista, `!!help` é lido com `!!`. * **Só o prefixo principal responde "Não conheço o comando"**, e só a uma palavra escrita como comando (`!oi`). Os outros prefixos, os de palavra e o seu prefixo próprio ficam em silêncio quando a palavra não é um comando. * **A vírgula não vem por padrão.** Outros bots usam `,`, então o Petto não responde a ela a menos que você a adicione: `!prefix add ,`. * **Seu prefixo próprio** ([`!myprefix`](https://wiki.petto.sbs/pt-br/setup/user-prefix)) e os **comandos personalizados** que começam com o prefixo funcionam com todos os prefixos da lista. * Cada prefixo tem de 1 a 12 caracteres, sem espaços, sem `@` nem crases, e não pode se repetir. ## Pular um argumento opcional Comandos com vários campos opcionais seguidos (como `!ticket category edit` ou `!welcome setup`) deixam você ir direto ao campo que quiser com `--nomedocampo valor`, em vez de digitar todos os campos antes dele. ```javascript Syntax theme={null} !command subcommand --optionname value ``` ```javascript Example theme={null} !ticket category edit support --naming ticket-{number} !welcome setup #boas-vindas --message "Boas-vindas, {user}!" ``` ![liam usa !welcome setup com o canal de boas-vindas e --message, e o Petto salva o canal e a mensagem](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-flags.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=12af3d3ff720e2df42a3675b3d7e641a) No Discord: --message preenche a mensagem do !welcome setup sem digitar os campos de antes. Misture à vontade: valores em ordem e `--flags` podem aparecer no mesmo comando. Isso só importa para campos opcionais; os obrigatórios sempre precisam de um valor simples, na ordem. Um nome com sublinhado também pode ser escrito com hífen: `--window-seconds 10` é o mesmo que `--window_seconds 10`. > [!WARNING] > > `name:value` (como `limit:3`) é como o Discord escreve as opções de um comando slash. Com o prefixo isso não é lido como um nome, então escreva `--limit 3`. ## Comandos ```javascript Syntax theme={null} !prefix !prefix add !prefix remove !prefix reset !prefix !help [full | query] ``` ```javascript Example theme={null} !prefix !prefix add , !prefix remove petto !prefix reset !prefix ? !help "ticket category add" ``` Use `!prefix` sem argumento para ver a lista. `!prefix add ` adiciona um (até 10), `!prefix remove ` remove um (o último não pode ser removido) e `!prefix reset` volta para `!` e `petto`. `!prefix ` (ou `!prefix set `) deixa esse prefixo como o único, como sempre (`petto` e a menção do Petto continuam funcionando). Precisa de Gerenciar servidor. `!help` abre o navegador de todos os comandos, com botões para o painel, a documentação, a página de Comandos do site e o servidor de suporte, e `!help ticket category add` procura um diretamente, incluindo um subcomando específico. `!prefix` também funciona como `!pfx`, e `!help` como `!h`. ![liam vê o prefixo, que é !, e @Petto que sempre funciona, e depois muda para ?](https://mintcdn.com/wikipetto/4ijFW041sxK9Gi0r/images/discord/setup/pt-br/prefix.webp?fit=max\&auto=format\&n=4ijFW041sxK9Gi0r\&q=85\&s=d37572887eec0f2a6b506b572732a06d) No Discord: !prefix mostra o prefixo atual, e !prefix ? muda ele. > [accordion] !prefix petto! > > ![liam tenta o prefixo petto! e o Petto diz que ele deve ter de 1 a 5 caracteres sem espaços](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-invalid.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=9f67fbae942495667961b9f9363583a6) > > No Discord: um prefixo com mais de 5 caracteres é recusado. > [accordion] !help > > ![O menu de ajuda do Petto: quantos comandos existem, quantos também funcionam com /, o idioma do servidor e um menu de categorias](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-help.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=19de512b599aa08f9a078ff245cddec8) > > No Discord: !help, com as categorias em um menu e links para o painel, a documentação e o servidor de suporte. > [accordion] !help: uma categoria > > ![A categoria Configuração do !help: para que serve, quantos comandos tem, um botão para voltar ao menu e um menu com os comandos](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-help-category.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=1a3d7283e9d8a2d7f651b6f36289dba7) > > No Discord: depois de escolher Configuração no menu, a mesma mensagem mostra os comandos dela. > [accordion] !help "ticket category add" > > ![O cartão de ajuda de ticket category add com aliases, parâmetros, quem pode usar, a sintaxe com prefixo e com barra e um exemplo](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-help-lookup.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=e22a29422b19edc9404a46801bab7732) > > No Discord: um subcomando procurado diretamente, com aliases, opções e as duas formas. > [accordion] !help tiket > > ![shi procura tiket e o Petto sugere !help ticket, !help time e !help timer](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-help-not-found.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=6d4b5d57c8530a56638b81ad58eae7d7) > > No Discord: um comando digitado errado recebe os nomes mais parecidos. No dashboard, o cartão **Prefixos de comandos** da página Geral mostra a lista e tem um botão **Gerenciar prefixos**. Ele abre uma janela: escreva um prefixo, aperte **+**, remova os que não quiser com o **x** e aperte **Salvar**. Ela diz o que está errado (longo demais, espaços, repetido, `@`, mais de 10) antes de salvar, e funciona no celular. ![A página Configurações do servidor com o prefixo de comandos, o idioma do servidor, o cargo de silêncio e o ranking público](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/dashboard/setup/pt-br/general-settings.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=e61bb2fd15b32957f37217e59daf9c35) Dashboard → Dashboard → Configurações: os Prefixos de comandos, ao lado do idioma do servidor e do cargo de silêncio. ## Comandos slash Todos os comandos funcionam com o prefixo. Os do dia a dia **também** estão no menu `/` do Discord, com as mesmas respostas e as mesmas verificações, para que os membros que nunca aprenderam um prefixo também possam usá-los. A forma com prefixo continua funcionando para todos eles. | Tipo | Comandos | | - | - | | Do dia a dia, dos dois jeitos | `/help`, `/ping`, `/botinfo`, `/server`, `/user`, `/rank`, `/top`, `/remind`, `/afk`, `/suggest`, `/poll`, `/warn`, `/kick`, `/ban`, `/channel`, `/giveaway`, `/ticket`, `/embed`, `/report` | | Grupos de comandos | `/mod`, `/staff`, `/game`, `/me`, `/search`, `/config`, `/protect`, `/greet`, `/auto`, `/message`, `/community`, `/contrib`, `/special`, `/bot`, `/ai` (**BETA**, veja [Ask](https://wiki.petto.sbs/pt-br/miscellaneous/ask.md)): cada um reúne comandos relacionados como subcomandos (`/mod ban`, `/game 8ball`, `/search weather`, `/ai ask`). `/avatar`, `/userinfo`, `/serverinfo`, `/unban`, `/purge` e `/timeout` agora ficam dentro deles como `/user avatar`, `/user info`, `/server info`, `/mod unban`, `/mod purge` e `/mod tempmute`; as formas com prefixo não mudaram | | Comandos com subcomandos próprios | `/level`, `/automod`, `/form`, `/forum`, `/role`, `/logs`, `/permission`, `/antinuke`, `/antiscam`, `/invites`, `/autoresponder`, `/image`, `/feed`, `/identity`, `/starboard`, `/clownboard`, `/monkeyboard`, `/stats`, `/customcommand`, `/rollouts`, `/quickreply`, `/voicemaster`, `/giveawaypreset`, `/giveawaytemplate`, `/boosterrole` (23 subcomandos, separado do `/me`: veja [Cargos de boosters](https://wiki.petto.sbs/pt-br/community/boosterrole.md)) | | Links de mensagens | `/messagelinks` (liga e desliga os embeds de links de mensagens) | | Cargos de identidade | `/vanity`, `/guildtag` (veja [Vanity e Server Tags](https://wiki.petto.sbs/pt-br/guides/vanity-tag-bot.md)) | | Só slash | `/setup`, cuja configuração rápida abre um formulário do Discord, e os menus **Report Message** e **Report User** (clique com o botão direito em uma mensagem ou em um membro e depois em **Apps**) | | [Roleplay](https://wiki.petto.sbs/pt-br/roleplay/roleplay.md) | Os 79 comandos de interação, todos como subcomandos de um só comando: `/act love hug`, `/act fight slap`. Cada um mantém também a sua própria palavra com o prefixo (`!hug`, `!slap`) | São 67 comandos no total: 64 comandos slash e 3 menus de contexto. Os cartões `!config` e algumas ferramentas da equipe continuam só com prefixo. > [!TIP] > > `/help` responde no canal e mostra as duas formas de um comando: a slash ao lado da sintaxe com prefixo. Os menus dele descrevem cada opção e os botões dele abrem o dashboard, esta documentação e o servidor de suporte. ![sam.k usa /help ban user e recebe um cartão com a sintaxe com prefixo, a sintaxe com barra e um exemplo](https://mintcdn.com/wikipetto/TvSVTyhvEkvwD6wa/images/discord/setup/pt-br/prefix-help-slash.webp?fit=max\&auto=format\&n=TvSVTyhvEkvwD6wa\&q=85\&s=7db8ef9e35d625a6b542a2a283722000) No Discord: /help mostra a forma com barra ao lado da sintaxe com prefixo. ### Quem vê cada comando slash O Discord esconde um comando slash dos membros que não têm a permissão de que ele precisa, então o menu `/` só mostra o que cada pessoa pode usar: | Comando | Precisa de | | - | - | | `/ban`, `/unban` | Banir membros | | `/kick` | Expulsar membros | | `/warn`, `/timeout` | Moderar membros | | `/purge` | Gerenciar mensagens | | `/channel` (lock, unlock, slowmode...) | Gerenciar canais | | `/embed`, `/giveaway`, `/setup`, `/vanity`, `/guildtag` | Gerenciar servidor | | Todo o resto | Não fica escondido de ninguém | Um servidor pode mudar quem vê um comando slash em **Configurações do servidor → Integrações → Petto**. É assim que um cargo escolhido para um comando em [`!moderation`](https://wiki.petto.sbs/pt-br/moderation/moderation#acesso-à-moderação-por-cargo) também pode usá-lo pelo menu `/`: permita o comando para esse cargo ali, e as verificações do próprio Petto continuam valendo. Os comandos slash do dia a dia não aparecem em DMs. Veja [Permissões de comandos](https://wiki.petto.sbs/pt-br/setup/permissions.md#comandos-slash) para saber como o Petto verifica um comando. > [!NOTE] > > Comandos slash novos ou alterados podem demorar um pouco para aparecer. Recarregar o Discord (Ctrl+R) costuma ajudar. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.