Moneda de servidor (Multi-Monedas)

Descripción

Guía de Usuario

Cree una o varias monedas propias de su servidor, que los miembros ganan charlando y en los canales de voz, y que luego gastan en una tienda, un casino o los minijuegos. Para los administradores que quieren una economía a medida, con varias divisas convertibles entre sí.

Qué hace

• Crea tantas monedas como quiera, cada una con su nombre y su emoji.
• Distribuye ganancias por actividad: por mensaje, por tiempo pasado en voz, o ambas cosas.
• Restringe las ganancias a determinados canales o categorías, y establece un límite de ganancia.
• Publica paneles interactivos en Discord: saldo, tienda, inventario, casino, conversión.
• Abre una tienda por moneda (precio, stock, fecha de caducidad).
• Ofrece un casino sencillo por moneda (apuesta fija o libre, probabilidad configurable, tiempo de espera).
• Vincula las monedas entre sí con un tipo de cambio (moneda derivada → moneda principal).
• Muestra una clasificación de los más ricos.

Inicio Rápido (Admin)

1. Cree la moneda: /monnaie creer id:gold nom:Oro emoji:💰 (el identificador debe estar en minúsculas, solo letras y cifras).
2. Ajuste las ganancias: /monnaie config_gain — elija el método (mensaje, voz, ambos), la ganancia, el intervalo y el umbral de caracteres.
3. Opcional: limite las ganancias a algunos canales con /monnaie restriction.
4. Llene la tienda: /monnaie boutique_objet, o la pestaña Tienda del panel de control.
5. Opcional: configure el casino con /monnaie casino y designe un rol de gestión con /monnaie staff_role.
6. Publique los paneles en un canal: /monnaie panneau type:👤 Panneau Utilisateur para los miembros, y type:🛠 Panneau Staff en un canal reservado al equipo.

Comandos

Para los miembros

Comando	Descripción
/monnaie liste	Muestra todas las monedas configuradas en el servidor.
/monnaie classement	Clasificación de los miembros más ricos de una moneda.
/monnaie conversions	Muestra las monedas vinculadas y su tipo de cambio.
/monnaie convertir	Convierte una moneda derivada a su moneda principal.

El saldo, la tienda, el inventario y el casino no pasan por comandos: se utilizan desde los botones del panel de usuario.

Para los administradores

Comando	Descripción
/monnaie creer	Crear una moneda (identificador, nombre, emoji).
/monnaie config_gain	Ajustar las ganancias: método, importe, intervalo, umbral de caracteres, límite.
/monnaie restriction	Restringir las ganancias a un canal o una categoría.
/monnaie boutique_objet	Añadir un objeto a la tienda de una moneda.
/monnaie casino	Configurar el casino de una moneda (modo, apuesta, ganancia, probabilidad, tiempo de espera).
/monnaie staff_role	Designar el rol autorizado a usar el panel de staff.
/monnaie lier	Vincular una moneda derivada a una moneda principal con un tipo de cambio.
/monnaie panneau	Publicar un panel interactivo (usuario o staff) en un canal.

Ajustes desde el panel de control

El módulo «Multi-Monedas» ofrece cuatro pestañas:

• Monedas — creación y modificación completa de una moneda: nombre, emoji, método de ganancia, ganancia e intervalo por mensaje, umbral de caracteres, límite diario, ganancia e intervalo en voz, canales y categorías autorizados, ajustes de casino (modo, tiempo de espera, apuesta, ganancia, probabilidad en forma de numerador/denominador) y vínculo de conversión hacia una moneda principal.
• Tienda — objetos de una moneda determinada: nombre, descripción, emoji, precio, stock (vacío = ilimitado), fecha de caducidad.
• Saldos — los cien saldos más altos de una moneda, con la posibilidad de ajustar un saldo miembro por miembro (sustituir un valor, o añadir/retirar un importe).
• Parámetros — el rol de staff autorizado a usar los botones del panel de staff.

La publicación de los paneles de Discord sigue siendo una operación que hay que hacer desde Discord con /monnaie panneau: el panel de control no publica ningún mensaje en su lugar.

Relación con la tienda

Tenga cuidado de no confundir dos sistemas distintos:

• La tienda de este módulo está integrada: cada moneda tiene su propia lista de objetos, la compra se hace con el botón «🛒 Tienda» del panel de usuario, el precio se cobra de inmediato y el objeto va al inventario del miembro. No hay ni ticket ni validación.
• El módulo «ShopDiscord» es un sistema aparte, con su propia moneda llamada «puntos», sus roles de bonificación, sus boosts y una validación por ticket en cada compra. Si busca ese funcionamiento, consulte la página ShopDiscord (Tienda y Puntos) de esta documentación.

Ambos pueden coexistir en un mismo servidor, pero sus saldos no se comunican. Elija uno para su economía principal, o sus miembros ya no sabrán qué moneda sirve para qué.

Las monedas de este módulo también alimentan los minijuegos de la Activity y el módulo Desafíos y Cartas.

Bueno saberlo

• El panel de control muestra un aviso «Módulo inestable — en desarrollo». Pruebe sus ajustes antes de lanzar una economía con la que sus miembros vayan a contar.
• Sin umbral de caracteres no se otorga ninguna ganancia por mensaje. El cálculo usa ese umbral como divisor: un mensaje de la longitud del umbral otorga la ganancia completa, un mensaje más largo otorga proporcionalmente más y uno más corto proporcionalmente menos. Si el umbral es 0, la ganancia siempre es 0. Póngale un valor realista (por ejemplo, 20 caracteres).
• El «límite diario» se compara con el saldo actual, no con las ganancias del día: por encima de ese valor, el miembro deja de ganar nada con esa moneda. Se comporta por tanto como un techo de saldo. Déjelo en 0 si no quiere ningún techo.
• El intervalo es un antispam: un miembro gana como máximo una vez por intervalo (en minutos) y por moneda. Ese contador se guarda en memoria y se reinicia a cero si el bot se reinicia.
• Las ganancias de voz se comprueban una vez por minuto. Una ganancia de voz solo se activa si el importe y el intervalo de voz están ambos rellenados.
• El identificador de una moneda ya no puede modificarse después de su creación (el nombre y el emoji, sí). Elíjalo corto y claro: aparece en los selectores de todos los demás módulos.
• Eliminar una moneda elimina todo lo que va con ella: saldos de los miembros, objetos de la tienda, historial del casino. Es irreversible.
• El casino debe configurarse moneda por moneda, o los miembros recibirán un mensaje pidiéndoles que contacten con un administrador. En modo «fija», la apuesta es impuesta y obligatoria; en modo «libre», el jugador elige su importe.
• La conversión solo va en un sentido: de una moneda derivada hacia su moneda principal. Una moneda no puede vincularse a sí misma.
• El panel de staff da acceso a añadir y retirar moneda. Publíquelo en un canal cerrado y asigne el rol de staff únicamente a personas de confianza: los administradores tienen acceso de todos modos.
• Los objetos de la tienda cuya fecha de caducidad ha pasado se eliminan automáticamente (comprobación cada diez minutos).