mmotools Discord Bot

O Bot Divisor de Lucros foi projetado para simplificar a gestão de eventos e a distribuição justa de lucros entre os participantes de atividades em grupo. Com ele, você pode automatizar a contagem de participação em canais de voz, calcular splits de forma transparente e gerenciar saldos individuais.

• Divisão de Lucros Transparente: Calcule e distribua lucros de eventos de forma automática, com base na participação de cada membro.
• Aplicação de Taxas Flexível: Configure uma taxa percentual (ex: 12,5%) que será deduzida do lucro total antes da distribuição, garantindo que as despesas do evento sejam cobertas.
• Criação Automática de Canais de Evento: Ao criar um evento, o bot gerencia a criação de canais de voz e texto dedicados para facilitar a organização e comunicação.
• Contagem de Participação em Tempo Real: A participação é rastreada automaticamente enquanto os membros estão nos canais de voz designados. Entrar ou sair do canal pausa/retoma a contagem.
• Apelidos (Nicknames) Utilizados: O bot utiliza o apelido (nickname) do usuário no servidor para uma identificação mais amigável nas mensagens e painéis.
• Privacidade por Servidor: Cada servidor mantém seus próprios eventos e configurações, garantindo que as informações de um servidor não sejam visíveis para outros.
• Painel de Configurações por Servidor: Gerencie permissões de botões e outras opções específicas para cada servidor, garantindo flexibilidade e controle.

Para uma experiência completa e organizada, o bot utiliza os seguintes canais:

• Painel de Eventos: 🎯-painel-eventos
  • Este é o canal principal onde os eventos são criados, iniciados e finalizados. Aqui, os participantes podem ver o status dos eventos e interagir com as funcionalidades básicas.
• Painel de Administração: 🔧-painel-admin
  • Exclusivo para administradores, este painel permite gerenciar eventos, ajustar participações, visualizar e modificar saldos, e realizar outras ações administrativas.
• Painel de Configurações: ⚙️-painel-configuracoes
  • Permite que administradores configurem permissões para botões específicos e outras opções do bot em seu servidor.
• Painel de Pings de Evento: 🏓-ping-evento
  • Crie e gerencie pings para organizar eventos futuros, permitindo que os usuários se inscrevam em papéis específicos.
• Painel de Attendance: 📈-painel-attendance
  • Gerencie e visualize os pontos de attendance dos membros, importantes para sistemas de ranqueamento ou recompensas.
• Guia de Uso: 📘-guia-de-uso
  • Este canal contém este guia detalhado sobre como usar todas as funcionalidades do bot.
• Avisos e Logs: 📢-avisos
  • Usado para notificações importantes do sistema e logs, especialmente no servidor mestre.

Observação: Foi tentado utilizar o bot sem conceder permissão de Administrador, mas tivemos resultados ruins: algumas funções não funcionaram corretamente e diversos problemas ocorreram. Por isso, o controle administrativo se torna necessário para garantir o funcionamento pleno do bot.

O bot mmotools foi desenvolvido para automatizar tarefas complexas e essenciais na gestão de eventos e na divisão de lucros no seu servidor Discord. Para operar de forma eficaz e sem interrupções, ele precisa de um conjunto robusto de permissões, incluindo as de administrador. Os principais motivos são:

• Gerenciamento de Canais: O bot precisa criar, editar e deletar canais de voz e texto dinamicamente para cada evento (canais de evento, painéis administrativos, etc.), além de mover usuários entre canais de voz para funcionalidades como o MOR (Movimento de Ranking).
• Interação com Mensagens e Painéis: O bot envia e edita mensagens constantemente, além de gerenciar botões e interações nos painéis. Permissões elevadas garantem que ele possa se comunicar e interagir sem falhas.
• Gestão de Cargos (MOR): Para funções avançadas como a aplicação de MOR, o bot pode precisar ajustar cargos de usuários. Ter permissões de administrador e estar hierarquicamente acima dos cargos que gerencia é crucial para que essas ações sejam bem-sucedidas.
• Robustez e Consistência: Com permissões de administrador, o bot consegue reagir melhor a mudanças inesperadas no servidor (como exclusão acidental de um canal) e manter a consistência dos dados e funcionalidades, recriando ou ajustando elementos conforme necessário.

Garantimos que o bot não realizará qualquer tipo de manipulação no seu servidor que não tenha sido previamente permitida ou que já não seja do seu conhecimento. O objetivo é apenas garantir a estabilidade e a funcionalidade completa do sistema, permitindo que ele gerencie seus eventos de forma autônoma e eficiente.

1. Vá para o canal 🎯-painel-eventos.
2. Clique no botão Criar Evento.
3. Um modal se abrirá. Informe apenas o Nome do evento.
4. O bot criará automaticamente um canal de voz e um canal de texto para o seu evento. Uma mensagem com o botão “Iniciar” será enviada ao canal de texto do evento.

1. Entre no canal de voz recém-criado para o evento.
2. Sua participação começará a ser contada automaticamente.
3. Sair do canal de voz pausará a contagem. Você pode entrar e sair várias vezes.

1. No canal de texto do evento, o criador do evento (líder) deve clicar no botão Iniciar.
2. Isso iniciará oficialmente a contagem de participação e desativará o botão “Iniciar”.
3. Importante: Apenas o líder do evento pode iniciá-lo.

1. No 🎯-painel-eventos, clique no botão Finalizar.
2. Um modal se abrirá. Informe o Lucro Total bruto do evento e a Taxa extra (%) (se houver).
3. O bot apresentará uma prévia de distribuição no canal do evento, detalhando:
   • Lucro Bruto: O valor total informado.
   • Taxa do Evento: O valor deduzido.
   • Lucro Líquido: O valor a ser dividido.
   • Distribuição por Participante: Quanto cada um receberá, com base na participação.
4. Você terá duas opções:
   • Sim, pagar agora: Este botão apenas simboliza que o pagamento será feito fora do bot. Nenhum saldo interno será creditado. Os botões de pagamento serão desativados.
   • Não, creditar saldos: Este botão creditará os valores calculados diretamente nos saldos internos dos participantes no bot. Os botões de pagamento serão desativados.

⚠️ Atenção: Para garantir a integridade dos dados, é obrigatório cancelar a prévia antes de editar participações ou participantes de um evento. Enquanto a prévia estiver aberta, o evento permanece congelado: não é possível editar participações, nem adicionar ou remover membros. Se a prévia não for cancelada, o evento será considerado não editável e nenhuma alteração será permitida.

Importante: Eventos já finalizados também não podem ser editados. Se for necessário corrigir participações ou valores em um evento finalizado, será preciso excluir o evento e criar um novo com as informações corretas.

• Cancelar Prévia: Se a prévia de distribuição não estiver correta ou se você precisar fazer ajustes, clique em Cancelar.
  • O evento retornará ao status Ativo.
  • O lucro bruto inicial será exibido novamente.
  • Você será orientado a usar o Painel de Administração para ajustar participações ou adicionar/remover participantes.
  • Após os ajustes, finalize o evento novamente para gerar uma nova prévia.
• Ajustar Participações (Painel de Administração):
  • Vá para o canal 🔧-painel-admin.
  • Use os botões de gerenciamento para ajustar manualmente a porcentagem de participação de um membro, ou adicionar/remover participantes, apenas após a prévia ter sido cancelada.

Após a confirmação da distribuição (seja por pagamento imediato ou crédito de saldos), o evento será marcado como “Finalizado” e sairá da lista de eventos ativos. Administradores podem visualizar eventos finalizados no 🔧-painel-admin.

R: O bot é projetado para ser resiliente. Ele tentará restaurar os painéis e o estado dos eventos após ser reiniciado, desde que o banco de dados esteja íntegro. A contagem de participação em canais de voz pode ser temporariamente pausada ou reiniciada para sessões abertas, mas o histórico é mantido.

R: Sim! Se a prévia foi gerada e você a cancelou, o evento retorna ao estado ativo para ajustes. Vá ao 🔧-painel-admin, selecione o evento e ajuste a participação conforme necessário. Em seguida, finalize o evento novamente para uma nova prévia.

R: A opção de tolerância foi removida. A participação é contada a partir do momento em que o botão “Iniciar” é clicado no canal do evento.

R: O processo de loot split, com suas etapas distintas, foi pensado para garantir a máxima segurança e justiça na distribuição dos lucros. Cada passo permite que você revise e confirme as informações importantes, minimizando erros.

Quando a prévia do split é gerada, o evento é temporariamente “congelado”. Isso significa que todos os dados de participação e o lucro são fixados naquele momento para que o cálculo seja preciso e consistente. Se permitíssemos alterações diretas (como adicionar/remover participantes ou ajustar porcentagens) enquanto a prévia está aberta, isso poderia desestabilizar o cálculo já feito, levando a inconsistências e possíveis erros na distribuição.

Ao “Cancelar” a prévia, estamos essencialmente “descongelando” o evento e retornando-o a um estado ativo. Isso permite que você faça todos os ajustes necessários com a certeza de que o próximo cálculo será feito com base nos dados mais recentes e corrigidos. É um processo que prioriza a integridade da distribuição, garantindo que o resultado final seja sempre o mais justo para todos.

R: Se você estiver enfrentando problemas como o bot não responder, painéis não aparecerem ou canais não serem criados, aqui estão algumas verificações rápidas que você pode fazer:

• O bot está online? Verifique se o bot está ativo no servidor. Se não estiver ativo pode significar que o seu acesso foi cortado por algum motivo.
• Permissões: Certifique-se de que o bot tenha as permissões necessárias no servidor e nos canais, especialmente as permissões de “Administrador”, “Gerenciar Canais” e “Enviar Mensagens”.

  Observação: Para que a função de aplicar MOR funcione corretamente, o cargo do bot mmotools deve estar acima dos cargos dos outros bots e dos cargos que ele precisa gerenciar na hierarquia do servidor.
  Por exemplo: se o cargo de Líder estiver acima do bot, ele não poderá editar o nome do usuário com esse cargo. Já cargos como Membro, que estejam abaixo do bot, poderão ser editados normalmente.

• Nomes de Canais: Se você notar que está faltando algum canal, pode ser um problema de permissão. O bot precisa de permissões adequadas para criar canais; se estiver faltando alguma permissão, ele não conseguirá criar os canais necessários. Além disso, verifique se já existe um canal com o mesmo nome no seu servidor, pois o bot tenta criar canais com nomes específicos.
• Logs (para administradores): Se as verificações acima não resolverem, um administrador pode verificar os logs no terminal onde o bot está rodando para mensagens de erro mais detalhadas.

• Revisão é Fundamental: Sempre revise o Lucro Total e a Taxa extra (%) antes de confirmar a distribuição para evitar erros.
• Formato de Valores: Ao informar valores monetários nos modais (ex: lucro total), utilize apenas números inteiros, sem formatação (ex: 47300000 para quarenta e sete milhões e trezentos mil).
• Customização de Canais: Você tem liberdade total para mover os canais de texto criados pelo bot para onde preferir no seu servidor. No entanto, é fundamental não excluir as categorias que o bot cria, pois elas servem como base estrutural para o funcionamento de diversas funções do bot.