Contenido
Guía de la tienda del servidor de Levlix
El módulo Tienda de Levlix permite a los administradores del servidor ofrecer artículos que se compran con la moneda virtual de puntos del servidor. Los miembros pueden explorar los artículos disponibles, comprarlos con su saldo de puntos y ver su historial de compras completo, ya sea con los comandos de barra de Discord o directamente desde el panel web.
Dónde pueden comprar los miembros
Hay dos formas igual de válidas de explorar y comprar:
- En Discord, con los comandos de barra
/shopque se describen más abajo. - En el panel web, desde Economía → Tienda. Los miembros ven el mismo catálogo que configuraron los administradores de su servidor, con su saldo de puntos actual, insignias de disponibilidad y el historial de compras completo.
Comprar desde el panel pasa exactamente por las mismas comprobaciones de seguridad que el comando de barra: fechas de disponibilidad, caducidad, límites de compra, existencias y pago se aplican todos en el servidor. El descuento de puntos y la asignación del código ocurren en una sola transacción de base de datos, así que una compra que falla a medias (por ejemplo, porque la reserva de códigos se agotó en ese mismo instante) nunca cuesta puntos: a nadie se le cobra por un código que no ha recibido.
Comandos para miembros
Hay un comando para miembros:
/shop
Abre el panel de la tienda con dos pestañas:
| Pestaña | Qué puedes hacer |
|---|---|
| Tienda | Ver todos los artículos disponibles en este momento, con su precio, las existencias restantes y cuántas veces más puedes comprarlos. Elige un artículo en el menú, confirma y la compra se realiza. |
| Mis compras | Ver lo que has comprado en la tienda de este servidor, con la fecha, el precio y el código que recibiste. |
La opción tab te permite abrir el panel directamente en una pestaña. Los artículos que ya has comprado hasta el límite y los artículos agotados no se ofrecen.
Tras una compra confirmada:
- Levlix comprueba tu saldo actual y las existencias del artículo.
- El código del artículo te llega por mensaje directo.
- Si tienes los MD cerrados, el código se te muestra en un mensaje efímero (solo tú puedes verlo).
- Tu saldo de puntos se reduce en el precio del artículo.
Los artículos que entrega el bot no tienen código: el artículo se te aplica y la confirmación lo indica. La pestaña Mis compras muestra primero tus efectos activos.
Si no tienes suficientes puntos, Levlix te dice cuántos puntos necesitas y cuántos tienes ahora.
Comprar desde el panel
Abre Economía → Tienda en el panel web de Levlix. Los miembros llegan directamente a la vista de tienda; quienes gestionan el servidor ven por defecto la vista de gestión y pueden abrir la tienda tal como la ven los miembros añadiendo ?view=store a la URL de la tienda.
La página de la tienda muestra:
| Elemento | Qué significa |
|---|---|
| Saldo de puntos | Tus puntos actuales del servidor, actualizados tras cada compra. |
| Insignias de estado | Disponible, Programado (se desbloquea en una fecha futura), Agotado o Caducado. |
| Botón Comprar | Desactivado cuando el artículo no está activo, has alcanzado su límite de compras o tu saldo es demasiado bajo. |
| Mis compras | Todos los códigos que has comprado en este servidor, del más reciente al más antiguo. |
| Efectos activos | Roles, potenciadores, escudos y apodos que tienes ahora, con su fecha de fin. |
Mostrar un código que compraste
Para proteger los códigos comprados si alguien mira tu pantalla, el historial de compras muestra por defecto solo los últimos cuatro caracteres de cada código. Haz clic en Mostrar en una fila para cargar el valor completo cuando lo necesites. Cada vez que muestras un código queda registrado, así que siempre tienes prueba de qué canjeaste y cuándo.
Las compras de artículos que entrega el bot muestran lo que compraste y su estado (activo hasta, programado, usado, caducado, revocado, reembolsado) en lugar de un código.
Artículos agotados y programados
- Los artículos agotados aparecen en gris y no se pueden comprar. Siguen en la página para que los miembros vean lo que se ha ofrecido en el pasado.
- Los artículos programados indican la fecha en que se desbloquean. El botón de compra está desactivado hasta que se alcanza
available_from. - Los artículos caducados siguen en la lista con la insignia Caducado y no se pueden comprar.
Administración: gestionar la tienda
Los administradores añaden, editan y eliminan artículos de la tienda en el panel web de Levlix. Cada artículo tiene estas opciones de configuración:
| Ajuste | Descripción |
|---|---|
| Título del artículo | Nombre que se muestra a los usuarios |
| Precio (puntos) | Coste en puntos del servidor |
| Tipo de artículo | Lo que recibe el comprador: un código de una reserva o algo que entrega el propio bot (ver más abajo) |
| Existencias | Número opcional de unidades para artículos que entrega el bot; vacío significa ilimitado |
| Límite de compras | Número máximo de veces que un miembro puede comprar este artículo; 0 significa ilimitado |
| Anunciar compras | Canal opcional en el que el bot publica cuando alguien compra el artículo |
| Fecha de finalización | Fecha opcional a partir de la cual el artículo sale de la tienda |
Cuando se venden todos los códigos de un artículo, este se marca automáticamente como agotado y se oculta de la lista de la tienda.
Un artículo que nadie ha comprado todavía se puede eliminar. En cuanto alguien lo compra, su tarjeta muestra Finalizar ahora en lugar de Eliminar: las compras y los roles, potenciadores o apodos en curso siguen vinculados al artículo, así que se finaliza en lugar de eliminarse. Finalizar ahora fija su fecha de finalización en el momento actual, el artículo sale de la tienda de inmediato y permanece en la lista de gestión en Caducado. Para volver a venderlo, dale una nueva fecha de finalización en Editar.
Para una gestión rápida desde Discord, abre /setup, elige Participación y luego Tienda. El panel de la tienda muestra tus artículos y tiene los botones Crear artículo, Publicar escaparate y Comprobar caducidad ahora, además de un menú que publica un solo artículo en un canal. Los gestores de la tienda sin el permiso Gestionar servidor llegan al mismo panel con el botón Gestionar tienda de /shop. Aun así, el panel web sigue siendo la forma más cómoda de trabajar con varios artículos a la vez.
Filtrar artículos de la tienda por estado
La página de gestión tiene un filtro de estado (Todos, Activo, Programado, Caducado, Agotado) para que vayas directamente a los artículos que requieren atención. El estado se calcula con las mismas reglas que la tienda aplica a los miembros, lo que significa que las dos vistas nunca pueden contradecirse.
Artículos que entrega el bot
Además de códigos, la tienda puede vender cosas que el bot aplica por sí mismo. Elige el tipo al crear el artículo; el tipo no se puede cambiar después, pero sus ajustes sí.
| Tipo | Lo que recibe el miembro | Ajustes | Permiso del bot |
|---|---|---|---|
| Rol temporal | Un rol durante un número de días (de 1 a 365) | Rol, duración | Gestionar roles, y el rol debe estar por debajo del rol más alto del bot |
| Potenciador de XP personal | Un multiplicador sobre su propia XP durante un número de horas (de 1 a 168) | Multiplicador (de 1,5x a 5x en pasos de 0,5), duración | ninguno |
| Escudo de racha | Protección para la racha diaria: un escudo cubre un día perdido | Máximo que puede tener un miembro (de 1 a 10) | ninguno |
| Apodo | Un apodo de su elección dentro de una plantilla que tú defines, durante un número de días (de 1 a 90) | Plantilla con {text}, duración |
Gestionar apodos |
| Boleto de lotería | Un boleto para la ronda actual del artículo; un boleto es una oportunidad | Día de la semana y hora del sorteo (UTC), comisión de la casa (de 0 a 50 por ciento), boletos por miembro y ronda, canal de resultados | Enviar mensajes en el canal de resultados |
Cada artículo que entrega el bot puede tener existencias (cuántas unidades hay en total), un límite de compras por miembro, ambas cosas o ninguna. Los artículos de código siguen calculando sus existencias a partir del número de códigos sin usar.
Cómo funciona la entrega
- Comprar en Discord aplica el artículo de inmediato. Comprar en el panel pasa la tarea al bot, que la aplica en unos pocos minutos como máximo, incluso si estaba desconectado en el momento de la compra.
- Volver a comprar un artículo temporal lo prolonga: el nuevo periodo empieza cuando termina el actual.
- Un potenciador de XP personal nunca se acumula con un potenciador para todo el servidor. Se aplica el multiplicador mayor.
- Los escudos de racha se usan automáticamente: cuando un miembro se salta días, se consume un escudo por cada día perdido y la racha continúa. Sin escudos suficientes, la racha se reinicia y los escudos se conservan.
- Un artículo de apodo permite al miembro escribir el texto; el bot lo inserta en tu plantilla (por ejemplo
VIP {text}). El texto pasa por los filtros de palabras de moderación del servidor cuando el módulo de moderación está activado. - Cuando un artículo termina, el bot quita el rol o restaura el apodo anterior. Un rol que el miembro ya tenía antes de comprar nunca se quita, y un apodo que el miembro haya cambiado entretanto no se toca.
Reembolsos
Si el bot no puede aplicar un artículo (el rol se eliminó, el bot no tiene el permiso, el miembro se fue o el propietario del servidor compró un apodo), la compra se reembolsa automáticamente: los puntos vuelven al saldo, la unidad de existencias queda libre y el comprador recibe un mensaje directo con el motivo. La compra aparece como Reembolsado en el historial.
Revocar una concesión
Quienes gestionan la tienda ven quién tiene ahora un artículo que entrega el bot a través de Concesiones en la tarjeta del artículo y pueden revocar una concesión desde ahí. El bot la deshace en unos pocos minutos. Revocar no reembolsa.
Anuncios de compras
Activa Anunciar compras y elige un canal para que el bot publique un mensaje breve cada vez que alguien compre el artículo. En ese mensaje se menciona a los miembros.
Los Ajustes de la tienda, en la parte superior de la página de gestión, contienen los valores predeterminados que hereda cada artículo: un canal de anuncios predeterminado y si los artículos nuevos empiezan con los anuncios activados. Un artículo sin canal propio publica en el canal predeterminado; los resultados de los sorteos de lotería usan la misma alternativa. Sin canal predeterminado, cada artículo que anuncia tiene que elegir el suyo. El Nivel de gestor de la tienda sigue en Ajustes del servidor.
Lotería
Un artículo de lotería funciona por rondas. Cada boleto comprado aporta su precio menos la comisión de la casa al bote de la ronda; la comisión de la casa simplemente se retira de la circulación. A la hora del sorteo, el bot elige un boleto al azar (cada boleto cuenta una vez, así que más boletos significan más oportunidades), paga el bote entero a ese miembro en puntos, publica el resultado en el canal de resultados y abre la siguiente ronda. Una ronda sin boletos se cierra sin aviso.
Quienes gestionan la tienda pueden usar Sortear ahora (el sorteo se realiza en menos de un minuto) y Anular ronda (se reembolsan todos los boletos y se abre la siguiente ronda; el bot publica un aviso breve). Un artículo de lotería no se puede eliminar mientras su ronda abierta tenga boletos: primero sortea o anula. Si dejas que el artículo caduque, se detiene la venta de boletos, pero la ronda abierta se sigue sorteando.
La tarjeta de la tienda muestra el bote actual, cuántos boletos contiene, tus propios boletos y la hora del próximo sorteo. La vista /shop de Discord muestra la misma línea.
Rol de gestor de la tienda
Por defecto, solo los administradores del servidor pueden gestionar la tienda. Si quieres que otro rol (por ejemplo, un Community Manager o un equipo de tienda propio) cree y edite artículos, ajusta el Nivel de gestor de la tienda en Ajustes del servidor a Moderadores+ o Administradores y propietario. La jerarquía de roles (user → moderator → admin → owner) determina quién ve la vista de gestión y quién ve la tienda.
| Ajuste | Resultado |
|---|---|
| Administradores y propietario (predeterminado) | Solo los administradores y el propietario del servidor pueden gestionar la tienda. |
| Moderadores+ | Los moderadores, los administradores y el propietario pueden gestionar la tienda. |
| Solo el propietario | Solo el propietario del servidor puede gestionar la tienda. |
Los miembros por debajo del rol configurado siempre llegan a la vista de tienda, aunque abran directamente la URL de gestión. Quienes gestionan la tienda y la previsualizan conservan el enlace Volver a la gestión, así que nunca se pierden.
Gestionar los saldos de los usuarios
Los administradores del servidor pueden añadir, quitar o ajustar manualmente el saldo de puntos de un miembro desde el panel web de Levlix. Cada cambio queda registrado en el historial de auditoría para una transparencia total.
Casos especiales y notas de seguridad
- Comprobación de membresía en cada compra desde el panel. La URL de la tienda es pública para cualquiera con una cuenta de Levlix, pero solo los miembros del servidor pueden comprar: el gestor de compras vuelve a comprobar la membresía antes de tocar la reserva de códigos.
- Un código por comprador, siempre. Mientras una compra está en curso, la fila del comprador se bloquea brevemente en la base de datos, así que hacer doble clic en el botón de compra (o que la misma persona abra dos pestañas) nunca puede obtener dos códigos con un solo pago.
- ¿Bot caído? Las compras siguen funcionando. Las compras del panel se publican a través de Redis para que el bot pueda enviar un MD al ganador, pero el código se entrega de inmediato dentro del panel en cualquier caso. Si el bot está desconectado, la compra se realiza igualmente y el código te espera en tu historial de compras cuando recargues.
- El cambio a agotado es instantáneo. Cuando se canjea el último código de un artículo desde el panel, el artículo se marca como agotado en la misma solicitud. El siguiente visitante no ve un "queda 1" desactualizado.