DocsEconomíaTienda de Servidor

Tienda & Inventario

Tienda del servidor

Cada servidor puede tener su propia tienda con ítems personalizados que los miembros compran con las monedas del sistema de economía. Los administradores crean y gestionan los ítems desde el dashboard; los usuarios los compran y consultan desde Discord.

Los comandos de usuario — /shop, /buy, /inventory y /use — están en desarrollo y aún no están disponibles en el bot. La configuración del lado administrador desde el dashboard sí está activa.

Hay tres tipos de ítem según el efecto que producen al comprarse:

Tipo Efecto al comprar Campo requerido
role Asigna un rol de forma permanente al usuario ID del rol
bank_upgrade Aumenta el límite máximo del banco del usuario Cantidad de aumento
custom Sin efecto automático — el ítem queda en el inventario para uso manual

Crear un ítem

Desde el dashboard, en la sección General → Tienda, puedes añadir, editar, activar/desactivar y eliminar ítems. El proceso para crear uno nuevo:

1
Elige el tipo

Selecciona entre role, bank_upgrade o custom según el efecto que quieres que tenga el ítem.

2
Nombre, emoji y precio

El nombre aparece en la tienda y en el inventario (máximo 50 caracteres). El emoji es decorativo. El precio es en monedas del servidor, mínimo 0.

3
Configura el campo específico del tipo

Para role: selecciona el rol que se asignará. Para bank_upgrade: indica cuántas monedas se añaden al límite del banco. Para custom no hay campo extra.

4
Ajusta stock y disponibilidad

Stock -1 significa unidades ilimitadas. Cualquier número positivo descuenta una unidad por compra y oculta el ítem al agotarse. El toggle de disponibilidad pausa el ítem sin borrarlo.

5
Guarda — el ítem aparece de inmediato

Una vez guardado y activo, el ítem es visible en la tienda del servidor. Puedes editarlo o desactivarlo en cualquier momento.

Campos configurables

Todos los ítems comparten los mismos campos base. Solo los campos requeridos por el tipo seleccionado se vuelven obligatorios; el resto son opcionales.

Nombre — hasta 50 caracteres. Se muestra en la tienda y en el inventario del usuario.

Descripción — hasta 200 caracteres. Texto explicativo que aparece junto al ítem en la tienda. Si se deja vacío no se muestra nada.

Emoji — acompañará al nombre en los listados. Por defecto 🛍️ si no se especifica ninguno.

Precio — en monedas del servidor, mínimo 0. Un precio de 0 permite compras gratuitas.

Stock-1 para unidades ilimitadas, o un número entero positivo para existencias concretas. Al llegar a 0 el ítem se oculta automáticamente de la tienda.

Disponible — toggle de activación. Un ítem desactivado no aparece en la tienda ni puede comprarse, pero conserva toda su configuración.

Los ítems de tipo role requieren que el bot tenga su rol por encima del rol que va a asignar en la jerarquía del servidor. Si el rol del bot está por debajo, la compra fallará.