Comandos de cargos e cargos em massa

​

Visão geral

!role add <usuário> <cargos> [motivo]
!role remove <usuário> <cargos> [motivo]
!role temp <usuário> <cargo> <duração>
!role temp-list
!role all <cargo> [remove] [preview] [without] [motivo]
!role humans <cargo> [remove] [preview] [motivo]
!role has <cargo_filtro> <cargo_alvo> [remove] [without] [preview] [motivo]
!role bots <cargo> [preview] [motivo]
!role bots-remove <cargo> [preview] [motivo]
!role job [status|pause|resume|cancel]
!role cancel

!role @Mia Membro
!role temp @Mia VIP 3d
!role all @Membro
!role humans @Novato preview
!role has @Veterano @Elder --joined_before 365d
!role all @Antigo remove --max_roles 1 limpando o servidor
!role job pause

​

Um cargo por vez

• add e remove aceitam um ou mais cargos (menções, IDs ou nomes). O Petto diz quais não conseguiu dar e por quê, no seu idioma: o cargo está acima do Petto, acima de você ou é gerenciado por uma integração.
• temp dá um cargo por um tempo (até um ano) e o Petto o tira quando acaba. Se o membro já tinha o cargo, o Petto avisa: ele ainda será tirado. temp-list mostra quem tem um cargo temporário e quando termina.
• Um cargo temporário que você tira à mão, ou dá para sempre com add, é esquecido, então o temporizador nunca o tira depois.
• group create|delete|view|list|give|take guarda conjuntos de cargos com nome para dar ou tirar de uma vez.
• create, delete, edit, color, icon, mentionable, hoist, topcolor, list e in gerenciam os próprios cargos.

​

Cargos em massa

• Uma tarefa por servidor por vez. Uma nova espera a que está rodando terminar.
• Segura em servidores grandes. Os membros são lidos em páginas de 1000, nunca todos de uma vez, e o próprio limite do Discord dita o ritmo.
• Sobrevive a uma reinicialização. Se o Petto reiniciar enquanto uma tarefa roda, ela continua do membro em que estava.
• Um cartão a acompanha no canal: membros verificados, alterados, que já estavam certos e que falharam, o tempo restante e o que fazer para pausar ou cancelar. Ao terminar mostra o resultado e quanto tempo levou.
• Ela para sozinha se o Discord recusar 15 membros seguidos, o que significa que o Petto perdeu a permissão ou que o cargo ficou acima do dele.
• Um membro que saiu enquanto a tarefa rodava conta como já estando certo, não como falha.

​

Opções

​

Prévia, status, pausa e cancelamento

​

Cargos ao entrar e cargos persistentes

• /role join add|remove|list|clear|apply é o !joinrole: cargos dados quando um membro entra. apply dá um cargo de entrada agora aos membros que já estão no servidor.
• /role sticky enable|disable|status é o !stickyroles: o Petto devolve os cargos de um membro quando ele volta.

​

A página Cargos do dashboard

1. Escolha o cargo e se quer atribuir ou remover. Os cargos que o Petto não consegue dar aparecem em cinza com o motivo. Um cargo com permissões poderosas mostra um aviso e uma caixa para confirmar.
2. Escolha quem: todos os membros, humanos ou bots, um intervalo de datas de entrada (seletores de data reais, além de botões para os últimos 7, 30 ou 90 dias e para mais de 30 dias, 90 dias ou um ano), quantos cargos têm, os cargos que devem ter ou não ter (algum ou todos) e se pula os membros que ainda não aceitaram as regras.
3. Adicione um motivo para o registro de auditoria e, se quiser, um canal para avisar quando terminar.
4. Clique em Prévia para ver quantos membros seriam alterados, ou em Começar. Depois de uma prévia, Executar de verdade inicia a mesma tarefa.
5. Acompanhe a tarefa: uma barra de progresso, membros verificados, alterados, que já estavam certos e que falharam, o tempo restante, e Pausar, Retomar e Cancelar. A página se atualiza sozinha.
6. Trabalhos recentes lista os últimos com o resultado e, se um falhou, por quê: falta Gerenciar cargos ao Petto, o cargo foi apagado, é gerenciado por uma integração, está acima do Petto, etc.