🚀 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.
🎒 Inventario y Equipo
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.
🪙 Ver tus Monedas
!monedas [@usuario]
Muestra el balance de monedas tuyo o de otro usuario.
💸 Cómo Ganar Monedas
- Jugar minijuegos (minar, pescar, pelear, plantar)
- Completar misiones
- Mantener tu racha diaria
- Abrir cofres
- Vender items (si está habilitado)
Las monedas son específicas por servidor. Cada servidor de Discord tiene su propia economía independiente.
🛒 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 ONLYComandos 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>
🎨 Creación de Contenido
Admin/Usuarios AvanzadosEsta sección está diseñada tanto para administradores que crean contenido como para usuarios que quieren entender cómo funciona el sistema completo del bot.
📑 En esta Sección
📦 Crear Items (EconomyItem)
Comando Principal
!item-crear <key-única>
Ejemplo: !item-crear iron_sword
🎛️ Editor Interactivo
El comando abre un editor con botones interactivos:
📝 Base
Configuración básica: nombre, descripción, categoría, stackable
🏷️ Tags
Etiquetas separadas por coma (weapon, rare, crafteable)
⚙️ Props (JSON)
Propiedades avanzadas en formato JSON
💾 Guardar/Cancelar
Confirma o cancela la creación
📋 Modal "Base"
true,10 o false,1
- •
true,10= Apilable hasta 10 unidades - •
false,1= Solo 1 unidad (armas/herramientas) - •
true,= Apilable sin límite
⚙️ Props (JSON) Disponibles
🔧 tool - Herramientas
Define el tipo de actividad que habilita tu item.
{
"tool": {
"type": "pickaxe|rod|sword|bow|halberd|net",
"tier": 1
}
}- •
type: Tipo de herramienta (determina en qué minijuego se usa) - •
tier: Nivel/calidad (usado en requisitos de niveles)
💥 breakable - Durabilidad
Para items no apilables que se desgastan con el uso.
{
"breakable": {
"enabled": true,
"maxDurability": 100,
"durabilityPerUse": 1
}
}📦 chest - Cofres
Permite definir loot tables, recompensas de monedas, items o roles.
{
"chest": {
"enabled": true,
"rewards": [
{ "type": "coins", "amount": 100 },
{ "type": "item", "itemKey": "iron_ore", "qty": 5 },
{ "type": "role", "roleId": "1234567890" }
],
"consumeOnOpen": true
}
}🍖 food - Comida/Pociones
{
"food": {
"healHp": 50,
"healPercent": 25,
"cooldownKey": "healing_potion",
"cooldownSeconds": 60
}
}⚔️ Stats de Combate
{
"damage": 10,
"defense": 5,
"maxHpBonus": 20
}�� Ejemplo Completo: Pico de Hierro
Comando: !item-crear iron_pickaxe
Modal Base:
- • Nombre:
Pico de Hierro - • Descripción:
Un pico resistente para minar minerales - • Categoría:
tools - • Stackable:
false,1
Props (JSON):
{
"tool": { "type": "pickaxe", "tier": 2 },
"breakable": {
"enabled": true,
"maxDurability": 150,
"durabilityPerUse": 1
}
}📚 Documentación Completa
Para información detallada sobre la creación de Mobs, Áreas, Niveles, Ofertas, Logros y Misiones,
consulta el archivo CREACION_DE_CONTENIDO.md
en el repositorio del bot.
Esta sección te da una introducción. El archivo MD contiene ejemplos completos, todas las propiedades disponibles y guías paso a paso.
🔧 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.
📈 Ver Estadísticas
!stats [@usuario]
Aliases: !estadisticas, !est
Muestra estadísticas detalladas organizadas por categorías:
- Actividades completadas
- Estadísticas de combate
- Economía y transacciones
- Items craftead os y usados
- Récords personales
⏱️ 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
⚔️ Combate
- 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
💰 Economía
- Vende items que no necesitas
- Craftea items valiosos para revender
- Programa fundiciones durante la noche
- Revisa la tienda regularmente
🎮 General
- Usa
!ayudapara ver todos los comandos - Revisa
!cooldownspara planificar actividades - Consulta
!playerfrecuentemente - Participa en eventos del servidor
❓ Preguntas Frecuentes
¿Cómo cambio el prefix del bot?
Los administradores pueden usar !configuracion para cambiar el prefix del bot a cualquier carácter o palabra.
¿Qué hago si pierdo items o monedas?
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 transferir items entre servidores?
No, cada servidor tiene su propia economía independiente. Tus items y monedas en un servidor no están disponibles en otros.
¿Cómo obtengo más monedas rápido?
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.