Conceptos básicos
+ + +🚀 Primeros Pasos
- Toda pieza de contenido en Amayo se identifica mediante una key
- única. Estas keys se usan en comandos, relaciones y validaciones. Usa un formato consistente como
- categoria_nombre
- (ej: item_iron_sword).
+ ¡Bienvenido a Amayo Bot! Este bot transforma tu servidor de Discord en una experiencia de juego completa con economía, minijuegos, misiones y mucho más.
✨ ¿Qué puedes hacer con Amayo?
+-
+
- Jugar Minijuegos: Mina recursos, pesca, pelea contra enemigos y cultiva en granjas +
- Economía Completa: Gana monedas, compra en la tienda, craftea items y gestiona tu inventario +
- Sistema de Progresión: Sube de nivel, completa misiones, desbloquea logros y mantén tu racha diaria +
- Personalización: Equipa armas, armaduras y capas para mejorar tus estadísticas +
- IA Conversacional: Chatea con Gemini AI directamente desde Discord +
- Sistema de Alianzas: Comparte enlaces de invitación y gana puntos para tu servidor +
Permisos necesarios
--
-
- Permiso de Discord Administrar Servidor. -
- O un rol Staff configurado para los comandos del bot. -
Sistema de pesos
+⚡ Prefix del Bot
- Al definir tablas de recompensas o aparición de enemigos, usa un campo weight.
- Cuanto mayor sea el peso, mayor la probabilidad de ser seleccionado.
+ El prefix por defecto es !
+
+ Los administradores pueden cambiarlo con !configuracion
+
❓ Obtener Ayuda
+
+ Usa !ayuda para ver todos los comandos disponibles
+
+ También puedes usar !ayuda <comando> para detalles específicos
{ "itemKey": "iron_ore", "weight": 10 }
-{ "itemKey": "gold_ore", "weight": 3 }Items (EconomyItem)
+ +⚡ Comandos Básicos
- Administra todo el inventario del juego. Usa !item-crear
- para abrir el editor interactivo y completa cada pestaña antes de guardar.
+ Estos son los comandos esenciales que necesitas conocer para empezar.
Comandos clave
--
-
!item-crear <key>— Crear un item nuevo.
- !item-editar <key>— Editar un item existente.
- !items-lista [página]— Ver listado paginado.
- !item-ver <key>— Ver detalles completos.
- !item-eliminar <key>— Eliminar un item.
-
Campos del modal Base
--
-
- Nombre: Texto visible para jugadores. -
- Descripción: Lore o efectos. -
- Categoría: Agrupa items (ej.
weapons).
- - Icon URL: Imagen opcional. -
- Stackable y Máx inventario: Usa
true,10, -false,1o deja el límite vacío para infinito. -
-
Props disponibles
-Herramientas (tool)
- {
- "tool": { "type": "pickaxe|rod|sword|bow|halberd|net", "tier": 1 }
-}Define el tipo de actividad que habilita tu item. El campo tier controla los requisitos mínimos.
Durabilidad (breakable)
- {
- "breakable": {
- "enabled": true,
- "maxDurability": 100,
- "durabilityPerUse": 1
- }
-}Sólo funciona con items no apilables. Ajusta la pérdida de durabilidad por uso para balancear actividades.
-Cofres (chest)
- {
- "chest": {
- "enabled": true,
- "rewards": [ ... ],
- "consumeOnOpen": true
- }
-}Permite definir loot tables internas, recompensas de monedas, items o roles.
-Comida y pociones (food)
- {
- "food": {
- "healHp": 50,
- "healPercent": 25,
- "cooldownSeconds": 60
- }
-}Útil para pociones curativas o consumibles con cooldown.
-Bonos de combate
-{
- "damage": 10,
- "defense": 5,
- "maxHpBonus": 20
-}Configura stats extra para armas, armaduras o capas.
-Etiquetas y metadatos
-Usa el modal Tags para añadir etiquetas separadas por coma, como weapon,rare,crafteable. Sirven para filtrar o aplicar reglas.
📋 Información y Utilidad
+!ayuda [comando|categoría]
+ Muestra la lista de comandos. También puedes usar !help, !comandos o !cmds
!ping
+ Verifica la latencia del bot. También: !latency, !pong
!player [@usuario]
+ Muestra tu perfil completo de jugador con estadísticas, equipo e inventario. También: !perfil, !profile, !yo, !me
Mobs (Enemigos)
+ +🎮 Sistema de Juego
- Los enemigos definen los encuentros durante minijuegos y niveles de área. Se crean con
- !mob-crear y usan stats y tablas de drop en formato JSON.
+ El sistema de juego de Amayo incluye HP (puntos de vida), estadísticas de combate, niveles de progresión y más.
Campos principales
--
-
- Base: Nombre y categoría opcional. -
- Stats: Define
attack, -hp,defense,xpReward.
- - Drops: Incluye
drawsy una tabla con premios ponderados.
-
Ejemplo de configuración
-{
- "attack": 10,
- "hp": 100,
- "defense": 5,
- "xpReward": 50
-}{
- "draws": 2,
- "table": [
- { "type": "coins", "amount": 50, "weight": 10 },
- { "type": "item", "itemKey": "leather", "qty": 1, "weight": 5 }
- ]
-}!mobs-lista para auditar stats rápidamente y
- !mob-ver <key> para revisar drops antes de activar un área.
- Áreas de juego (GameArea)
-- Las áreas definen dónde se desarrollan las actividades principales (minar, pescar, pelear, plantar). Cada área puede tener múltiples niveles configurables. -
Modal Base
+⚔️ Estadísticas de Combate
-
-
- Nombre: Ej. Caverna de Hierro. -
- Tipo:
MINE, -LAGOON,FIGHToFARM. -
+ - HP (Vida): Tus puntos de vida actuales y máximos +
- ATK (Ataque): Daño que infliges a los enemigos +
- DEF (Defensa): Reduce el daño recibido +
- Bonos de Equipo: Las armas, armaduras y capas mejoran tus stats
Modal Config (JSON)
-{
- "cooldownSeconds": 60,
- "description": "Una mina profunda",
- "icon": "⛏️"
-}El ícono se mostrará en las tarjetas generadas por DisplayComponents.
+📊 Ver tus Estadísticas
+!player
+ Vista general de tu perfil
+!stats
+ Estadísticas detalladas de todas tus actividades
+!area-eliminar, revisa niveles asociados para evitar referencias rotas.
+ 💡 Consejo:
+ Equipa mejores armas y armaduras para aumentar tus estadísticas y tener más éxito en los minijuegos de combate.
Niveles de área (GameAreaLevel)
+ +🎯 Minijuegos y Actividades
- Cada nivel controla requisitos, mobs, recompensas y vigencia. Gestiona niveles con
- !area-nivel <areaKey> <level>.
+ Los minijuegos son la forma principal de ganar recursos, monedas y experiencia. Cada uno tiene su propio estilo y recompensas.
Requisitos
-{
- "tool": {
- "required": true,
- "toolType": "pickaxe",
- "minTier": 2,
- "allowedKeys": ["iron_pickaxe", "diamond_pickaxe"]
- }
-}Sirve para validar herramientas necesarias. Combínalo con los tiers definidos en los items.
-Recompensas
-{
- "draws": 3,
- "table": [
- { "type": "coins", "amount": 100, "weight": 10 },
- { "type": "item", "itemKey": "iron_ore", "qty": 2, "weight": 5 }
- ]
-}Define múltiples extracciones de la tabla con pesos personalizados.
-Mobs
-{
- "mobPool": {
- "draws": 2,
- "table": [
- { "mobKey": "goblin", "weight": 10 },
- { "mobKey": "troll", "weight": 3 }
- ]
- }
-}Ventana
-{
- "window": {
- "from": "2025-01-01T00:00:00Z",
- "to": "2025-01-31T23:59:59Z"
- }
-}Ofertas de tienda (ShopOffer)
-
- Usa !offer-crear para lanzar nuevas ofertas con stock limitado,
- precios compuestos y ventanas temporales.
-
Precio (JSON)
-{
- "coins": 100,
- "items": [
- { "itemKey": "iron_ore", "qty": 5 },
- { "itemKey": "wood", "qty": 10 }
- ]
-}⛏️ Minar (Mining)
+Ve a la mina y extrae recursos minerales valiosos. Necesitas un pico para minar.
+!mina [nivel] [herramienta] [area:clave]
+ Aliases: !minar
Ejemplos:
+• !mina — Mina en el nivel más alto desbloqueado
• !mina 2 — Mina en el nivel 2
• !mina 1 iron_pickaxe — Usa un pico específico
Recompensas típicas:
+Minerales (hierro, oro, diamantes), gemas, monedas
+Límites y ventana
--
-
- Límite por usuario: Máximo por jugador. -
- Stock global: Total disponible. -
- Ventana: Fechas ISO de inicio y fin. -
Logros
-
- Motiva a los jugadores con hitos permanentes. Crea logros con
- !logro-crear y configúralos usando el editor DisplayComponents.
-
Requisitos comunes
--
-
collect_items: Recolectar items específicos.
- complete_missions: Completar misiones listadas.
- reach_level: Alcanzar cierto nivel o racha.
- stat_value: Llegar a un valor en estadísticas.
-
🎣 Pescar (Fishing)
+Lanza tu caña en la laguna y captura peces y tesoros acuáticos. Necesitas una caña de pescar.
+!pescar [nivel] [herramienta] [area:clave]
+ Aliases: !fish
Ejemplos:
+• !pescar — Pesca automáticamente
• !pescar 3 — Pesca en nivel 3
Recompensas típicas:
+Peces, perlas, tesoros, monedas
+Recompensas posibles
--
-
- Monedas -
- Items entregados automáticamente -
- Roles (usa ID de Discord) -
- Puntos de logro -
!logros-lista para auditar logros y
- !logro-ver <key> para validar estructura antes de publicarlos.
- Misiones
-
- Las misiones permiten objetivos diarios, semanales o repetibles. Adminístralas con
- !mision-crear y
- !misiones-lista.
-
Tipos de misión
--
-
- daily: Reinicia cada día. -
- weekly: Reinicia cada semana. -
- one_time: Se completa una vez. -
- repeatable: Puede repetirse sin límite. -
⚔️ Pelear (Combat)
+Entra a la arena y enfrenta enemigos peligrosos. Las armas mejoran tu daño.
+!pelear [nivel] [arma] [area:clave]
+ Aliases: !fight, !arena
Ejemplos:
+• !pelear — Combate automático
• !pelear 1 iron_sword — Usa espada de hierro
Recompensas típicas:
+Experiencia, botines de enemigos, armaduras, armas, monedas
+Requisitos combinables
--
-
- Consumir items o recursos. -
- Completar minijuegos específicos. -
- Derrotar mobs concretos. -
- Lograr cantidades de monedas. -
🌾 Plantar/Cultivar (Farming)
+Cultiva plantas y cosecha alimentos en tu granja. Usa una azada para mejores resultados.
+!plantar [nivel] [herramienta]
+ Aliases: !farm
Recompensas típicas:
+Vegetales, frutas, semillas, ingredientes de cocina
+Cada minijuego tiene un tiempo de espera (cooldown) entre usos. Usa !cooldowns para ver tus tiempos activos.
Cofres y recompensas
+ +🎒 Inventario y Equipo
- Configura cofres usando props chest en los items y define tablas de recompensas con pesos.
+ Gestiona todos tus items y equipa armas, armaduras y capas para mejorar tus estadísticas.
📦 Ver tu Inventario
+!inventario [página|filtro]
+ Aliases: !inv
Muestra todos tus items con cantidades, información de herramientas y estadísticas.
+Ejemplos:
+• !inv — Ver inventario completo
• !inv 2 — Ver página 2
• !inv sword — Filtrar por "sword"
• !inv iron_sword — Ver detalles de un item específico
🧰 Equipar Items
+!equipar <slot> <itemKey>
+ Aliases: !equip
Equipa un item en uno de los tres slots disponibles.
+⚔️ weapon
+Armas que aumentan tu daño (ATK)
+🛡️ armor
+Armaduras que aumentan tu defensa (DEF)
+🧥 cape
+Capas con bonos especiales (HP, stats)
+Ejemplos:
+• !equipar weapon iron_sword
• !equipar armor leather_armor
• !equipar cape red_cape
Usa !player para ver rápidamente tu equipo actual y las estadísticas que te otorgan.
💰 Sistema de Economía
++ Gana y gestiona monedas para comprar items, participar en eventos y mejorar tu progreso. +
+Recompensas soportadas
--
-
- Monedas (
coins)
- - Items (usa
itemKeyyqty)
- - Roles de Discord (
roleId)
-
🪙 Ver tus Monedas
+!monedas [@usuario]
+ Muestra el balance de monedas tuyo o de otro usuario.
+Consejos
+💸 Cómo Ganar Monedas
-
-
- Usa
consumeOnOpenpara cofres desechables.
- - Combina cofres con logros y eventos para mejores recompensas. -
- Define varias entradas con pesos distintos para crear rarezas. +
- Jugar minijuegos (minar, pescar, pelear, plantar) +
- Completar misiones +
- Mantener tu racha diaria +
- Abrir cofres +
- Vender items (si está habilitado)
Crafteos
-
- Gestiona recetas desde la base de datos o crea comandos personalizados. El servicio de economía incluye
- craftByProductKey para validar materiales y entregar productos.
-
-
-
- Define recetas en Prisma con entradas y productos. -
- Usa misiones o eventos para desbloquear recetas temporales combinando props y tags. -
- Considera usar
craftingOnly: trueen items que no se consiguen por drops.
-
Mutaciones
-
- Las mutaciones permiten modificar items existentes con efectos adicionales (ej. reforjar armas). Usa
- findMutationByKey y
- applyMutationToInventory desde el servicio de economía.
-
Políticas
-{
- "mutationPolicy": {
- "allowedKeys": ["fire_upgrade", "ice_upgrade"],
- "deniedKeys": ["cursed_upgrade"]
- }
-}Sugerencias
--
-
- Crea mutaciones exclusivas por eventos. -
- Combínalas con logros o misiones épicas. -
- Controla conflictos usando
deniedKeys.
-
Pociones y consumibles
-
- Usa props food para crear pociones curativas, boosters temporales o consumibles con cooldown.
-
Ejemplo de poción
-{
- "food": {
- "healHp": 75,
- "healPercent": 15,
- "cooldownKey": "healing_potion",
- "cooldownSeconds": 45
- }
-}Buenas prácticas
--
-
- Usa
cooldownKeypara compartir cooldown.
- - Balancea
healHpyhealPercentpara distintos niveles.
- - Combina con logros para recompensar uso estratégico. -
Herramientas y durabilidad
-
- La durabilidad se administra a través de la combinación de props tool
- y breakable. Para que un item pierda durabilidad, debe ser
- no apilable (stackable=false).
-
-
-
- La función
reduceToolDurabilitydescuentadurabilityPerUsetras cada minijuego.
- - Cuando la durabilidad llega a 0, el item se elimina del inventario. -
- Si
breakable.enabledesfalse, la herramienta es indestructible.
- - Usa tiers para bloquear áreas avanzadas. Ejemplo: Un área puede requerir una herramienta
pickaxecontier >= 2.
-
Las monedas son específicas por servidor. Cada servidor de Discord tiene su propia economía independiente.
Servicios del sistema
+ +🛒 Tienda y Compras
++ La tienda ofrece items especiales, herramientas, consumibles y más. Compra con tus monedas ganadas. +
+ +🏪 Abrir la Tienda
+!tienda [categoría]
+ Aliases: !shop, !store
Abre un panel interactivo con todas las ofertas disponibles.
+Funciones del panel:
+-
+
- Ver detalles de cada item +
- Navegar por páginas +
- Comprar x1 o x5 unidades +
- Ver stock disponible +
- Ver tu saldo de monedas +
🔢 Sistema de Compras
+Precios: Los items pueden costar monedas y/o otros items
+Stock: Algunas ofertas tienen stock limitado global
+Límite por usuario: Puedes tener un límite de compras por oferta
+Ofertas temporales: Algunas solo están disponibles en fechas específicas
+El panel de la tienda expira después de 5 minutos. Usa el botón "🔄 Actualizar" para refrescar el stock y precios.
+🔨 Crafteo y Creación
++ Transforma materiales crudos en items útiles usando el sistema de crafteo. +
+ +⚒️ Craftear Items
+!craftear <productKey> [cantidad]
+ Aliases: !craft
Crea un item usando una receta predefinida. Consume los materiales necesarios automáticamente.
+Ejemplos:
+• !craftear iron_sword — Craftea 1 espada de hierro
• !craftear health_potion 5 — Craftea 5 pociones
📋 Cómo Funciona
+-
+
- El bot verifica si tienes los materiales necesarios en tu inventario +
- Si los tienes, consume los materiales +
- Agrega el producto crafteado a tu inventario +
- Te notifica el resultado +
Las recetas son configuradas por los administradores del servidor. Si falla un crafteo, es posible que no tengas los materiales necesarios o que la receta no esté configurada.
+🏆 Logros
++ Desbloquea logros completando objetivos y recibe recompensas especiales. Los logros son permanentes y demuestran tus hazañas. +
+ +🎖️ Ver tus Logros
+!logros [@usuario]
+ Aliases: !achievements, !logro, !achievement
Muestra tus logros desbloqueados, progreso actual y puntos totales.
+�� Lo que Verás
+-
+
- Logros Desbloqueados: Los 5 más recientes que has completado +
- En Progreso: Top 5 logros con barra de progreso +
- Por Categoría: Desglose por minería, pesca, combate, economía, etc. +
- Puntos Totales: Tu puntuación acumulada +
- Porcentaje: Cuántos logros has desbloqueado del total +
�� Recompensas
+Los logros pueden otorgar:
+-
+
- 💰 Monedas +
- 📦 Items exclusivos +
- 👑 Roles de Discord especiales +
- ⭐ Puntos de logro +
Los logros se desbloquean automáticamente cuando cumples los requisitos. ¡No necesitas reclamarlos manualmente!
+📜 Misiones
++ Completa misiones para obtener grandes recompensas. Las misiones se renuevan periódicamente y ofrecen objetivos variados. +
+ +📋 Ver Misiones
+!misiones [categoría]
+ Aliases: !quests, !mision, !quest
Muestra todas las misiones disponibles con tu progreso y recompensas.
+📝 Tipos de Misiones
+📅 Diarias
+Se reinician cada día. Perfectas para juego diario.
+📆 Semanales
+Se reinician cada semana. Objetivos más grandes.
+♾️ Permanentes
+Se completan una vez y quedan para siempre.
+🔄 Repetibles
+Pueden completarse múltiples veces sin límite.
+🎁 Reclamar Recompensas
+!mision-reclamar <id>
+ Reclama las recompensas de una misión completada. El ID aparece en el comando !misiones.
+Enfócate en completar misiones diarias para maximizar tus recompensas. ¡Revisa las misiones cada día!
+🔥 Racha Diaria
++ Mantén tu racha diaria activa para recibir recompensas progresivas cada día. ¡Cuanto más larga sea tu racha, mejores serán las recompensas! +
+ +🎁 Reclamar Racha
+!racha
+ Aliases: !streak, !daily
Reclama tu recompensa diaria y verifica tu racha actual.
+📊 Estadísticas de Racha
+-
+
- Racha Actual: Cuántos días consecutivos llevas activo +
- Mejor Racha: Tu récord de días consecutivos +
- Días Activos: Total de días que has reclamado (no consecutivos) +
- Próximo Hito: Cuántos días faltan para el siguiente milestone +
🎯 Hitos Importantes
+Alcanza estos hitos para recompensas especiales:
+Si pasas más de 24 horas sin reclamar tu racha, ¡se reiniciará a 1! Asegúrate de reclamarla cada día.
+🍖 Consumibles y Pociones
++ Usa pociones y comida para recuperar HP durante tus aventuras. Los consumibles tienen cooldowns individuales. +
+ +🧪 Usar Consumibles
+!comer <itemKey>
+ Aliases: !usar-comida, !usar
Consume un item de comida o poción para curarte.
+Ejemplo:
+• !comer health_potion
💚 Tipos de Curación
+-
+
- Curación Fija: Recupera una cantidad específica de HP (ej: +50 HP) +
- Curación Porcentual: Recupera un % de tu HP máximo (ej: +25%) +
- Curación Mixta: Combina ambos tipos +
⏱️ Cooldowns
+Cada consumible tiene su propio cooldown. Algunos comparten el mismo cooldown (cooldownKey) para evitar spam de curaciones.
+Lleva siempre pociones en tu inventario antes de entrar a combates difíciles. ¡Pueden salvarte la vida!
+🎁 Cofres y Recompensas
++ Los cofres contienen recompensas aleatorias que pueden incluir items raros, monedas y hasta roles especiales de Discord. +
+ +📦 Abrir Cofres
+!abrir <itemKey>
+ Aliases: !open
Abre un cofre de tu inventario y recibe recompensas aleatorias.
+Ejemplo:
+• !abrir mystery_chest
🎲 Qué Puedes Obtener
+-
+
- 💰 Monedas: Cantidades variables de monedas +
- 📦 Items: Herramientas, armas, materiales, consumibles +
- 👑 Roles: Roles exclusivos de Discord (si están configurados) +
- ✨ Items Raros: Objetos únicos y de edición limitada +
🔢 Sistema de Probabilidades
++ Los cofres usan un sistema de pesos (weights) para determinar las recompensas. Items con mayor peso aparecen con más frecuencia. +
+Algunos cofres se consumen al abrirlos, mientras que otros son reutilizables. ¡Revisa la descripción del cofre!
+✨ Encantamientos y Mutaciones
++ Mejora tus items aplicándoles encantamientos o mutaciones especiales que les otorgan poderes adicionales. +
+ +🔮 Aplicar Encantamientos
+!encantar <itemKey> <mutationKey>
+ Aliases: !mutar, !enchant
Aplica una mutación/encantamiento a un item específico de tu inventario.
+Ejemplo:
+• !encantar iron_sword fire_enchant
⚡ Tipos de Mejoras
+Los encantamientos pueden:
+-
+
- Aumentar daño o defensa +
- Agregar efectos elementales (fuego, hielo, veneno) +
- Mejorar la durabilidad +
- Otorgar habilidades especiales +
🛡️ Políticas de Mutación
++ Algunos items tienen restricciones sobre qué encantamientos pueden recibir. Los items pueden tener listas de encantamientos permitidos o prohibidos. +
+Los encantamientos raros suelen estar disponibles solo durante eventos especiales o pueden requerir items específicos.
+🔥 Sistema de Fundición
++ La fundición te permite transformar materiales en lingotes y otros items, pero toma tiempo. Programa tus fundiciones y reclama cuando estén listas. +
+ +🔨 Iniciar Fundición
+!fundir <outputKey> <cantidad> <segundos> <input:qty>...
+ Aliases: !smelt
Crea un trabajo de fundición que estará listo después del tiempo especificado.
+Ejemplos:
+• !fundir iron_ingot 1 60 iron_ore:3
↳ Funde 1 lingote de hierro en 60 segundos usando 3 minerales
+• !fundir steel_bar 2 300 iron_ore:5 coal:2
↳ Funde 2 barras de acero en 5 minutos usando 5 hierro y 2 carbón
+✅ Reclamar Productos
+!fundir-reclamar
+ Recoge los productos de tus fundiciones completadas. El bot te notificará cuando estén listas.
+⚙️ Cómo Funciona
+-
+
- El bot verifica que tienes los materiales necesarios +
- Consume los materiales de tu inventario +
- Crea un trabajo de fundición con un tiempo de espera +
- Cuando el tiempo termina, puedes reclamar el producto +
Programa varias fundiciones a la vez para maximizar tu producción. ¡El bot te avisará cuando estén listas!
+🤖 Inteligencia Artificial
++ Chatea con Gemini AI directamente desde Discord. Haz preguntas, pide ayuda o simplemente conversa. +
+ +💬 Chatear con la IA
+!ai <mensaje>
+ Aliases: !chat, !gemini
Envía un mensaje a la IA y recibe una respuesta inteligente.
+Ejemplos:
+• !ai ¿Cómo funciona JavaScript?
• !ai Explícame el Sistema Solar
• !ai Dame consejos para jugar mejor
🎯 Qué Puedes Hacer
+-
+
- Hacer preguntas sobre cualquier tema +
- Pedir explicaciones y tutoriales +
- Obtener consejos y estrategias +
- Resolver problemas y dudas +
- Generar ideas creativas +
Amayo Bot usa Google's Gemini AI para proporcionar respuestas inteligentes y contextuales. Las respuestas largas se dividen automáticamente en múltiples mensajes.
+⏰ Sistema de Recordatorios
++ Programa recordatorios para que el bot te avise en el futuro. Perfecto para no olvidar eventos, tareas o actividades. +
+ +📝 Crear Recordatorio
+!recordar <texto> <fecha/hora>
+ Aliases: !reminder, !rec
Crea un recordatorio que el bot enviará en el momento especificado.
+📅 Formatos Aceptados
+Tiempo Relativo:
+• en 15 minutos, en 1 hora, en 2 días
• dentro de 30 minutos
• 15m, 2h, 3d (al final del mensaje)
Fechas Naturales:
+• mañana a las 9:00
• el miércoles a las 17:00
• el viernes 10am
📌 Ejemplos Completos
+• !recordar revisar el evento en 2 horas
• !recordar reunión importante mañana 3pm
• !recordar comprar items de la tienda 30m
Los recordatorios requieren que el bot tenga configurado Appwrite. Si el comando no funciona, contacta al administrador del bot.
+🤝 Sistema de Alianzas
++ El sistema de alianzas permite a los servidores compartir enlaces de invitación y ganar puntos. Requiere permisos de Administrador. +
+ +📊 Ver Leaderboard
+!leaderboard
+ Muestra el ranking de usuarios con más puntos de alianza en tu servidor.
+⚙️ Comandos de Administración
+Solo para usuarios con permisos de Administrador:
+!crear-embed <nombre>
+ Crea un bloque/embedded con editor interactivo
+!editar-embed <nombre>
+ Edita un bloque existente
+!lista-embeds
+ Lista los bloques con paginación
+!canal-alianza
+ Configura un canal para alianzas
+!listar-canales-alianza
+ Ver canales configurados
+⚙️ Panel de Administración
+ ADMIN ONLY ++ Comandos avanzados para administradores que permiten crear y gestionar todo el contenido del bot. Requiere permisos de Administrador del servidor. +
+ +Estos comandos permiten configurar items, enemigos, áreas, niveles, ofertas, logros y misiones. Para documentación detallada sobre cómo crear contenido, consulta CREACION_DE_CONTENIDO.md
📦 Gestión de Items
+!item-crear <key>
!item-editar <key>
!items-lista
!item-ver <key>
!item-eliminar <key>
👾 Gestión de Enemigos
+!mob-crear <key>
!mob-editar <key>
!mobs-lista
!mob-eliminar <key>
🗺️ Gestión de Áreas
+!area-crear <key>
!area-editar <key>
!areas-lista
!area-nivel <key> <nivel>
!area-eliminar <key>
🛒 Gestión de Ofertas
+!offer-crear
!offer-editar
🏆 Gestión de Logros
+!logro-crear <key>
!logros-lista
!logro-ver <key>
!logro-eliminar <key>
📜 Gestión de Misiones
+!mision-crear <key>
!misiones-lista
!mision-ver <key>
!mision-eliminar <key>
🔧 Configuración del Servidor
++ Los administradores pueden personalizar el comportamiento del bot en su servidor. +
+ +⚙️ Panel de Configuración
+!configuracion
+ Aliases: !config, !ajustes, !settings
Requiere: Administrador
+Abre un panel interactivo para modificar la configuración del servidor.
+🎛️ Opciones Disponibles
+-
+
- Prefix del Bot: Cambia el prefijo de comandos (por defecto
!)
+ - Canales Permitidos: Limita dónde funciona el bot +
- Roles de Staff: Configura qué roles pueden usar comandos admin +
- Límites y Cooldowns: Ajusta tiempos de espera +
📊 Estadísticas y Progreso
++ Revisa tus estadísticas detalladas y cooldowns activos para planificar tu progreso. +
+Economy Service
--
-
findItemByKeyyaddItemByKey
- consumeItemByKeyygetInventoryEntry
- craftByProductKeyybuyFromOffer
- findMutationByKeyyapplyMutationToInventory
+ - Actividades completadas +
- Estadísticas de combate +
- Economía y transacciones +
- Items craftead os y usados +
- Récords personales +
📈 Ver Estadísticas
+!stats [@usuario]
+ Aliases: !estadisticas, !est
Muestra estadísticas detalladas organizadas por categorías:
+-
+
⏱️ Ver Cooldowns
+!cooldowns
+ Aliases: !cds, !tiempos, !cd
Muestra todos los cooldowns activos con tiempo restante:
+-
+
- Minijuegos (mina, pesca, pelea, granja) +
- Consumibles usados +
- Comandos con tiempos de espera +
💡 Tips y Trucos
++ Consejos para aprovechar al máximo Amayo Bot y progresar más rápido. +
+ +🎯 Progresión Eficiente
+-
+
- Reclama tu racha diaria todos los días +
- Completa misiones diarias primero +
- Equipa siempre las mejores armas y armaduras +
- Guarda monedas para ofertas especiales
Minigames Service
--
-
runMinigamepara ejecutar cualquier actividad.
- runMiningyrunFishingcomo atajos.
- - Valida cooldowns, requisitos de herramientas y entrega recompensas. -
- Reduce durabilidad automáticamente cuando corresponde. + +
- Lleva siempre pociones de curación +
- Mejora tu equipo antes de niveles difíciles +
- Revisa las estadísticas de enemigos +
- Usa encantamientos para ventajas especiales +
- Vende items que no necesitas +
- Craftea items valiosos para revender +
- Programa fundiciones durante la noche +
- Revisa la tienda regularmente +
- Usa
!ayudapara ver todos los comandos
+ - Revisa
!cooldownspara planificar actividades
+ - Consulta
!playerfrecuentemente
+ - Participa en eventos del servidor
⚔️ Combate
+-
+
💰 Economía
+-
+
🎮 General
+-
+
Preguntas frecuentes
+❓ Preguntas Frecuentes
+¿Qué pasa si olvido definir stackable?
+ ¿Cómo cambio el prefix del bot?
- Por defecto los items son apilables. Si tu herramienta pierde durabilidad, asegúrate de marcarla como no apilable en el modal Base.
+ Los administradores pueden usar !configuracion para cambiar el prefix del bot a cualquier carácter o palabra.
¿Cómo pruebo mis configuraciones?
+¿Qué hago si pierdo items o monedas?
- Usa comandos de prueba en un servidor privado con el bot y confirma con
- !player,
- !stats y !inventario.
+ El bot guarda todo en una base de datos segura. Si crees que hubo un error, contacta a un administrador del servidor. Ellos pueden revisar los logs y corregir problemas.
¿Puedo clonar contenido entre servidores?
+¿Puedo transferir items entre servidores?
- Sí. Los items globales están disponibles en todos los servidores; los locales se limitan a su guild. Usa las herramientas de exportación de Prisma si necesitas migraciones masivas. + No, cada servidor tiene su propia economía independiente. Tus items y monedas en un servidor no están disponibles en otros.
¿Cómo despliego esta documentación?
+¿Cómo obtengo más monedas rápido?
- Consulta las instrucciones en server/README.md para publicar en Heroku como app independiente.
+ Las mejores formas son: mantener tu racha diaria, completar misiones diarias y semanales, jugar minijuegos frecuentemente, y abrir cofres. También puedes vender items que no necesitas.
+
¿Por qué algunos comandos no funcionan?
++ Verifica que estés usando el prefix correcto, que tengas los permisos necesarios, y que el comando esté habilitado en tu servidor. Algunos comandos requieren configuración previa por parte de los administradores. +
+¿Qué significa que un item es "stackable"?
++ "Stackable" significa que puedes tener múltiples unidades del mismo item en un solo slot del inventario. Los items no-stackable ocupan un slot por unidad (común en herramientas y armas). +
+¿Cómo reporto un bug?
++ Contacta a un administrador de tu servidor con detalles específicos: qué comando usaste, qué esperabas que pasara, y qué pasó en realidad. Incluye capturas de pantalla si es posible. +
+¿El bot está siempre en línea?
++ El bot intenta estar en línea 24/7, pero puede tener mantenimientos ocasionales. Si el bot está offline, contacta al propietario del bot o espera a que vuelva.
+ Amayo Bot • Guía Completa +
++ Guía Completa de Amayo Bot +
++ Aprende a usar todos los comandos y funcionalidades de Amayo Bot en tu servidor de Discord. Sistema de economía, minijuegos, misiones, logros, IA conversacional y mucho más. +
+🚀 Primeros Pasos
++ ¡Bienvenido a Amayo Bot! Este bot transforma tu servidor de Discord en una experiencia de juego completa con economía, minijuegos, misiones y mucho más. +
+ +✨ ¿Qué puedes hacer con Amayo?
+-
+
- Jugar Minijuegos: Mina recursos, pesca, pelea contra enemigos y cultiva en granjas +
- Economía Completa: Gana monedas, compra en la tienda, craftea items y gestiona tu inventario +
- Sistema de Progresión: Sube de nivel, completa misiones, desbloquea logros y mantén tu racha diaria +
- Personalización: Equipa armas, armaduras y capas para mejorar tus estadísticas +
- IA Conversacional: Chatea con Gemini AI directamente desde Discord +
- Sistema de Alianzas: Comparte enlaces de invitación y gana puntos para tu servidor +
⚡ Prefix del Bot
+
+ El prefix por defecto es !
+
+ Los administradores pueden cambiarlo con !configuracion
+
❓ Obtener Ayuda
+
+ Usa !ayuda para ver todos los comandos disponibles
+
+ También puedes usar !ayuda <comando> para detalles específicos
+
⚡ Comandos Básicos
++ Estos son los comandos esenciales que necesitas conocer para empezar. +
+ +📋 Información y Utilidad
+!ayuda [comando|categoría]
+ Muestra la lista de comandos. También puedes usar !help, !comandos o !cmds
!ping
+ Verifica la latencia del bot. También: !latency, !pong
!player [@usuario]
+ Muestra tu perfil completo de jugador con estadísticas, equipo e inventario. También: !perfil, !profile, !yo, !me
🎮 Sistema de Juego
++ El sistema de juego de Amayo incluye HP (puntos de vida), estadísticas de combate, niveles de progresión y más. +
+ +⚔️ Estadísticas de Combate
+-
+
- HP (Vida): Tus puntos de vida actuales y máximos +
- ATK (Ataque): Daño que infliges a los enemigos +
- DEF (Defensa): Reduce el daño recibido +
- Bonos de Equipo: Las armas, armaduras y capas mejoran tus stats +
📊 Ver tus Estadísticas
+!player
+ Vista general de tu perfil
+!stats
+ Estadísticas detalladas de todas tus actividades
+Equipa mejores armas y armaduras para aumentar tus estadísticas y tener más éxito en los minijuegos de combate.
+🎯 Minijuegos y Actividades
++ Los minijuegos son la forma principal de ganar recursos, monedas y experiencia. Cada uno tiene su propio estilo y recompensas. +
+ +⛏️ Minar (Mining)
+Ve a la mina y extrae recursos minerales valiosos. Necesitas un pico para minar.
+!mina [nivel] [herramienta] [area:clave]
+ Aliases: !minar
Ejemplos:
+• !mina — Mina en el nivel más alto desbloqueado
• !mina 2 — Mina en el nivel 2
• !mina 1 iron_pickaxe — Usa un pico específico
Recompensas típicas:
+Minerales (hierro, oro, diamantes), gemas, monedas
+🎣 Pescar (Fishing)
+Lanza tu caña en la laguna y captura peces y tesoros acuáticos. Necesitas una caña de pescar.
+!pescar [nivel] [herramienta] [area:clave]
+ Aliases: !fish
Ejemplos:
+• !pescar — Pesca automáticamente
• !pescar 3 — Pesca en nivel 3
Recompensas típicas:
+Peces, perlas, tesoros, monedas
+⚔️ Pelear (Combat)
+Entra a la arena y enfrenta enemigos peligrosos. Las armas mejoran tu daño.
+!pelear [nivel] [arma] [area:clave]
+ Aliases: !fight, !arena
Ejemplos:
+• !pelear — Combate automático
• !pelear 1 iron_sword — Usa espada de hierro
Recompensas típicas:
+Experiencia, botines de enemigos, armaduras, armas, monedas
+🌾 Plantar/Cultivar (Farming)
+Cultiva plantas y cosecha alimentos en tu granja. Usa una azada para mejores resultados.
+!plantar [nivel] [herramienta]
+ Aliases: !farm
Recompensas típicas:
+Vegetales, frutas, semillas, ingredientes de cocina
+Cada minijuego tiene un tiempo de espera (cooldown) entre usos. Usa !cooldowns para ver tus tiempos activos.
+ Administra todo el inventario del juego. Usa !item-crear
+ para abrir el editor interactivo y completa cada pestaña antes de guardar.
+
Comandos clave
+-
+
!item-crear <key>— Crear un item nuevo.
+ !item-editar <key>— Editar un item existente.
+ !items-lista [página]— Ver listado paginado.
+ !item-ver <key>— Ver detalles completos.
+ !item-eliminar <key>— Eliminar un item.
+
Campos del modal Base
+-
+
- Nombre: Texto visible para jugadores. +
- Descripción: Lore o efectos. +
- Categoría: Agrupa items (ej.
weapons).
+ - Icon URL: Imagen opcional. +
- Stackable y Máx inventario: Usa
true,10, +false,1o deja el límite vacío para infinito. +
+
Props disponibles
+Herramientas (tool)
+ {
+ "tool": { "type": "pickaxe|rod|sword|bow|halberd|net", "tier": 1 }
+}Define el tipo de actividad que habilita tu item. El campo tier controla los requisitos mínimos.
Durabilidad (breakable)
+ {
+ "breakable": {
+ "enabled": true,
+ "maxDurability": 100,
+ "durabilityPerUse": 1
+ }
+}Sólo funciona con items no apilables. Ajusta la pérdida de durabilidad por uso para balancear actividades.
+Cofres (chest)
+ {
+ "chest": {
+ "enabled": true,
+ "rewards": [ ... ],
+ "consumeOnOpen": true
+ }
+}Permite definir loot tables internas, recompensas de monedas, items o roles.
+Comida y pociones (food)
+ {
+ "food": {
+ "healHp": 50,
+ "healPercent": 25,
+ "cooldownSeconds": 60
+ }
+}Útil para pociones curativas o consumibles con cooldown.
+Bonos de combate
+{
+ "damage": 10,
+ "defense": 5,
+ "maxHpBonus": 20
+}Configura stats extra para armas, armaduras o capas.
+Etiquetas y metadatos
+Usa el modal Tags para añadir etiquetas separadas por coma, como weapon,rare,crafteable. Sirven para filtrar o aplicar reglas.
Mobs (Enemigos)
+
+ Los enemigos definen los encuentros durante minijuegos y niveles de área. Se crean con
+ !mob-crear y usan stats y tablas de drop en formato JSON.
+
Campos principales
+-
+
- Base: Nombre y categoría opcional. +
- Stats: Define
attack, +hp,defense,xpReward.
+ - Drops: Incluye
drawsy una tabla con premios ponderados.
+
Ejemplo de configuración
+{
+ "attack": 10,
+ "hp": 100,
+ "defense": 5,
+ "xpReward": 50
+}{
+ "draws": 2,
+ "table": [
+ { "type": "coins", "amount": 50, "weight": 10 },
+ { "type": "item", "itemKey": "leather", "qty": 1, "weight": 5 }
+ ]
+}!mobs-lista para auditar stats rápidamente y
+ !mob-ver <key> para revisar drops antes de activar un área.
+ Áreas de juego (GameArea)
++ Las áreas definen dónde se desarrollan las actividades principales (minar, pescar, pelear, plantar). Cada área puede tener múltiples niveles configurables. +
+Modal Base
+-
+
- Nombre: Ej. Caverna de Hierro. +
- Tipo:
MINE, +LAGOON,FIGHToFARM. +
+
Modal Config (JSON)
+{
+ "cooldownSeconds": 60,
+ "description": "Una mina profunda",
+ "icon": "⛏️"
+}El ícono se mostrará en las tarjetas generadas por DisplayComponents.
+!area-eliminar, revisa niveles asociados para evitar referencias rotas.
+ Niveles de área (GameAreaLevel)
+
+ Cada nivel controla requisitos, mobs, recompensas y vigencia. Gestiona niveles con
+ !area-nivel <areaKey> <level>.
+
Requisitos
+{
+ "tool": {
+ "required": true,
+ "toolType": "pickaxe",
+ "minTier": 2,
+ "allowedKeys": ["iron_pickaxe", "diamond_pickaxe"]
+ }
+}Sirve para validar herramientas necesarias. Combínalo con los tiers definidos en los items.
+Recompensas
+{
+ "draws": 3,
+ "table": [
+ { "type": "coins", "amount": 100, "weight": 10 },
+ { "type": "item", "itemKey": "iron_ore", "qty": 2, "weight": 5 }
+ ]
+}Define múltiples extracciones de la tabla con pesos personalizados.
+Mobs
+{
+ "mobPool": {
+ "draws": 2,
+ "table": [
+ { "mobKey": "goblin", "weight": 10 },
+ { "mobKey": "troll", "weight": 3 }
+ ]
+ }
+}Ventana
+{
+ "window": {
+ "from": "2025-01-01T00:00:00Z",
+ "to": "2025-01-31T23:59:59Z"
+ }
+}Ofertas de tienda (ShopOffer)
+
+ Usa !offer-crear para lanzar nuevas ofertas con stock limitado,
+ precios compuestos y ventanas temporales.
+
Precio (JSON)
+{
+ "coins": 100,
+ "items": [
+ { "itemKey": "iron_ore", "qty": 5 },
+ { "itemKey": "wood", "qty": 10 }
+ ]
+}Límites y ventana
+-
+
- Límite por usuario: Máximo por jugador. +
- Stock global: Total disponible. +
- Ventana: Fechas ISO de inicio y fin. +
Logros
+
+ Motiva a los jugadores con hitos permanentes. Crea logros con
+ !logro-crear y configúralos usando el editor DisplayComponents.
+
Requisitos comunes
+-
+
collect_items: Recolectar items específicos.
+ complete_missions: Completar misiones listadas.
+ reach_level: Alcanzar cierto nivel o racha.
+ stat_value: Llegar a un valor en estadísticas.
+
Recompensas posibles
+-
+
- Monedas +
- Items entregados automáticamente +
- Roles (usa ID de Discord) +
- Puntos de logro +
!logros-lista para auditar logros y
+ !logro-ver <key> para validar estructura antes de publicarlos.
+ Misiones
+
+ Las misiones permiten objetivos diarios, semanales o repetibles. Adminístralas con
+ !mision-crear y
+ !misiones-lista.
+
Tipos de misión
+-
+
- daily: Reinicia cada día. +
- weekly: Reinicia cada semana. +
- one_time: Se completa una vez. +
- repeatable: Puede repetirse sin límite. +
Requisitos combinables
+-
+
- Consumir items o recursos. +
- Completar minijuegos específicos. +
- Derrotar mobs concretos. +
- Lograr cantidades de monedas. +
Cofres y recompensas
+
+ Configura cofres usando props chest en los items y define tablas de recompensas con pesos.
+
Recompensas soportadas
+-
+
- Monedas (
coins)
+ - Items (usa
itemKeyyqty)
+ - Roles de Discord (
roleId)
+
Consejos
+-
+
- Usa
consumeOnOpenpara cofres desechables.
+ - Combina cofres con logros y eventos para mejores recompensas. +
- Define varias entradas con pesos distintos para crear rarezas. +
Crafteos
+
+ Gestiona recetas desde la base de datos o crea comandos personalizados. El servicio de economía incluye
+ craftByProductKey para validar materiales y entregar productos.
+
-
+
- Define recetas en Prisma con entradas y productos. +
- Usa misiones o eventos para desbloquear recetas temporales combinando props y tags. +
- Considera usar
craftingOnly: trueen items que no se consiguen por drops.
+
Mutaciones
+
+ Las mutaciones permiten modificar items existentes con efectos adicionales (ej. reforjar armas). Usa
+ findMutationByKey y
+ applyMutationToInventory desde el servicio de economía.
+
Políticas
+{
+ "mutationPolicy": {
+ "allowedKeys": ["fire_upgrade", "ice_upgrade"],
+ "deniedKeys": ["cursed_upgrade"]
+ }
+}Sugerencias
+-
+
- Crea mutaciones exclusivas por eventos. +
- Combínalas con logros o misiones épicas. +
- Controla conflictos usando
deniedKeys.
+
Pociones y consumibles
+
+ Usa props food para crear pociones curativas, boosters temporales o consumibles con cooldown.
+
Ejemplo de poción
+{
+ "food": {
+ "healHp": 75,
+ "healPercent": 15,
+ "cooldownKey": "healing_potion",
+ "cooldownSeconds": 45
+ }
+}Buenas prácticas
+-
+
- Usa
cooldownKeypara compartir cooldown.
+ - Balancea
healHpyhealPercentpara distintos niveles.
+ - Combina con logros para recompensar uso estratégico. +
Herramientas y durabilidad
+
+ La durabilidad se administra a través de la combinación de props tool
+ y breakable. Para que un item pierda durabilidad, debe ser
+ no apilable (stackable=false).
+
-
+
- La función
reduceToolDurabilitydescuentadurabilityPerUsetras cada minijuego.
+ - Cuando la durabilidad llega a 0, el item se elimina del inventario. +
- Si
breakable.enabledesfalse, la herramienta es indestructible.
+ - Usa tiers para bloquear áreas avanzadas. Ejemplo: Un área puede requerir una herramienta
pickaxecontier >= 2.
+
Servicios del sistema
+Economy Service
+-
+
findItemByKeyyaddItemByKey
+ consumeItemByKeyygetInventoryEntry
+ craftByProductKeyybuyFromOffer
+ findMutationByKeyyapplyMutationToInventory
+
Minigames Service
+-
+
runMinigamepara ejecutar cualquier actividad.
+ runMiningyrunFishingcomo atajos.
+ - Valida cooldowns, requisitos de herramientas y entrega recompensas. +
- Reduce durabilidad automáticamente cuando corresponde. +
Preguntas frecuentes
+¿Qué pasa si olvido definir stackable?
+ + Por defecto los items son apilables. Si tu herramienta pierde durabilidad, asegúrate de marcarla como no apilable en el modal Base. +
+¿Cómo pruebo mis configuraciones?
+
+ Usa comandos de prueba en un servidor privado con el bot y confirma con
+ !player,
+ !stats y !inventario.
+
¿Puedo clonar contenido entre servidores?
++ Sí. Los items globales están disponibles en todos los servidores; los locales se limitan a su guild. Usa las herramientas de exportación de Prisma si necesitas migraciones masivas. +
+¿Cómo despliego esta documentación?
+
+ Consulta las instrucciones en server/README.md para publicar en Heroku como app independiente.
+