Moeda do servidor (Multi-Moedas)

Descrição

Guia do Usuário

Crie uma ou mais moedas próprias do seu servidor, que os membros ganham conversando e na voz e depois gastam em uma loja, em um cassino ou nos minijogos. Para administradores que querem uma economia sob medida, com várias moedas conversíveis entre si.

O que ele faz

• Cria quantas moedas você quiser, cada uma com seu nome e seu emoji.
• Distribui ganhos pela atividade: por mensagem, por tempo na voz, ou os dois.
• Restringe os ganhos a determinados canais ou categorias, e define um limite de ganho.
• Publica painéis interativos no Discord: saldo, loja, inventário, cassino, conversão.
• Abre uma loja por moeda (preço, estoque, data de validade).
• Oferece um cassino simples por moeda (aposta fixa ou livre, chance configurável, tempo de espera).
• Vincula as moedas entre si com uma taxa de conversão (moeda derivada → moeda principal).
• Exibe um ranking dos mais ricos.

Início rápido (Admin)

1. Crie a moeda: /monnaie creer id:gold nom:Ouro emoji:💰 (o identificador deve ser em minúsculas, apenas letras e números).
2. Ajuste os ganhos: /monnaie config_gain — escolha o método (mensagem, voz, os dois), o ganho, o intervalo e o limite de caracteres.
3. Opcional: limite os ganhos a alguns canais com /monnaie restriction.
4. Abasteça a loja: /monnaie boutique_objet, ou a aba Loja do dashboard.
5. Opcional: configure o cassino com /monnaie casino e designe um cargo de gestão com /monnaie staff_role.
6. Publique os painéis em um canal: /monnaie panneau type:👤 Panneau Utilisateur para os membros, e type:🛠 Panneau Staff em um canal reservado à equipe.

Comandos

Para os membros

Comando	Descrição
/monnaie liste	Exibe todas as moedas configuradas no servidor.
/monnaie classement	Ranking dos membros mais ricos de uma moeda.
/monnaie conversions	Exibe as moedas vinculadas e sua taxa de conversão.
/monnaie convertir	Converte uma moeda derivada em sua moeda principal.

O saldo, a loja, o inventário e o cassino não passam por comandos: são usados pelos botões do painel do usuário.

Para os administradores

Comando	Descrição
/monnaie creer	Criar uma moeda (identificador, nome, emoji).
/monnaie config_gain	Ajustar os ganhos: método, valor, intervalo, limite de caracteres, limite.
/monnaie restriction	Restringir os ganhos a um canal ou a uma categoria.
/monnaie boutique_objet	Adicionar um item à loja de uma moeda.
/monnaie casino	Configurar o cassino de uma moeda (modo, aposta, ganho, chance, tempo de espera).
/monnaie staff_role	Designar o cargo autorizado a usar o painel da equipe.
/monnaie lier	Vincular uma moeda derivada a uma moeda principal com uma taxa.
/monnaie panneau	Publicar um painel interativo (usuário ou equipe) em um canal.

Configuração pelo dashboard

O módulo "Multi-Moedas" oferece quatro abas:

• Moedas — criação e modificação completa de uma moeda: nome, emoji, método de ganho, ganho e intervalo por mensagem, limite de caracteres, limite diário, ganho e intervalo na voz, canais e categorias autorizados, configurações do cassino (modo, tempo de espera, aposta, ganho, chance em forma de numerador/denominador) e vínculo de conversão com uma moeda principal.
• Loja — itens de uma moeda específica: nome, descrição, emoji, preço, estoque (vazio = ilimitado), data de validade.
• Saldos — os cem maiores saldos de uma moeda, com a possibilidade de ajustar o saldo membro por membro (substituir um valor, ou adicionar/retirar um montante).
• Parâmetros — o cargo de equipe autorizado a usar os botões do painel da equipe.

A publicação dos painéis no Discord continua sendo uma operação feita pelo Discord com /monnaie panneau: o dashboard não publica mensagem no seu lugar.

Relação com a loja

Atenção para não confundir dois sistemas distintos:

• A loja deste módulo é integrada: cada moeda tem sua própria lista de itens, a compra é feita pelo botão "🛒 Boutique" do painel do usuário, o preço é debitado imediatamente e o item vai para o inventário do membro. Não há ticket nem validação.
• O módulo "ShopDiscord" é um sistema separado, com sua própria moeda chamada "pontos", seus cargos de bônus, seus boosts e uma validação por ticket em cada compra. Se é esse funcionamento que você procura, consulte a página ShopDiscord (Loja & Pontos) desta documentação.

Os dois podem coexistir em um mesmo servidor, mas seus saldos não se comunicam. Escolha um deles para a sua economia principal, senão seus membros não saberão mais qual moeda serve para quê.

As moedas deste módulo também alimentam os minijogos da Activity e o módulo Desafios & Cartas.

Bom saber

• O dashboard exibe um aviso "Módulo instável — em desenvolvimento". Teste suas configurações antes de lançar uma economia com a qual seus membros vão contar.
• Sem limite de caracteres, nenhum ganho por mensagem é creditado. O cálculo usa esse limite como divisor: uma mensagem com o tamanho do limite rende o ganho completo, uma mensagem mais longa rende proporcionalmente mais, uma mais curta proporcionalmente menos. Se o limite for 0, o ganho será sempre 0. Coloque um valor realista (por exemplo, 20 caracteres).
• O "limite diário" é comparado ao saldo atual, não aos ganhos do dia: acima desse valor, o membro não ganha mais nada nessa moeda. Ele se comporta, portanto, como um teto de saldo. Deixe em 0 se você não quiser nenhum teto.
• O intervalo é um antispam: um membro ganha no máximo uma vez por intervalo (em minutos), por moeda. Esse contador é mantido em memória e volta a zero se o bot reiniciar.
• Os ganhos na voz são verificados uma vez por minuto. Um ganho na voz só é acionado se o valor e o intervalo de voz estiverem ambos preenchidos.
• O identificador de uma moeda não pode mais ser alterado após a criação (o nome e o emoji, sim). Escolha-o curto e claro: ele aparece nos seletores de todos os outros módulos.
• Excluir uma moeda exclui tudo o que vem com ela: saldos dos membros, itens da loja, histórico do cassino. É irreversível.
• O cassino deve ser configurado moeda por moeda, senão os membros recebem uma mensagem pedindo que entrem em contato com um administrador. No modo "fixo", a aposta é imposta e obrigatória; no modo "livre", o jogador escolhe o valor.
• A conversão vai em um só sentido: de uma moeda derivada para sua moeda principal. Uma moeda não pode ser vinculada a si mesma.
• O painel da equipe dá acesso à adição e à remoção de moeda. Publique-o em um canal fechado e atribua o cargo de equipe apenas a pessoas de confiança: os administradores têm acesso de qualquer forma.
• Os itens da loja cuja data de validade já passou são excluídos automaticamente (verificação a cada dez minutos).