shni/amayo

Template

Files

shni 8be8ea5925 Add comprehensive documentation and improvement suggestions for Amayo bot

- Created README.md for static site documentation, detailing features, structure, local usage, and Heroku deployment.
- Added RESUMEN_CAMBIOS.md summarizing critical bug fixes, command updates, and documentation enhancements.
- Introduced SUGERENCIAS_Y_MEJORAS.md with a thorough analysis of the project, new feature suggestions, and technical improvements.

2025-10-07 10:23:15 -05:00

27 KiB

Raw Blame History

🎮 Guía de Usuario Completa - Amayo Bot

Última actualización: Enero 2025 • Versión 0.11.20

Esta es la guía completa de Amayo Bot para usuarios finales de Discord. Aprende a usar todos los comandos, jugar minijuegos, gestionar tu economía y, si eres administrador, cómo crear contenido personalizado para tu servidor.

📋 Tabla de Contenidos

🚀 Primeros Pasos

¿Qué es Amayo Bot?

Amayo Bot es un bot de Discord completo que añade un sistema de juego RPG a tu servidor con:

Minijuegos: Mina, pesca, pelea y cultiva
Economía: Sistema de monedas, tienda e inventario
Progresión: Logros, misiones y rachas diarias
Personalización: Equipo, encantamientos y crafteo
IA: Chat con Gemini AI
Alianzas: Sistema de puntos para servidores

Prefix del Bot

El prefix por defecto es ! pero los administradores pueden cambiarlo.

Ejemplos:

!ayuda - Ver comandos disponibles
!player - Ver tu perfil
!mina - Jugar al minijuego de minería

⚡ Comandos Básicos

Información General

!ayuda o !help - Lista todos los comandos
!ayuda <comando> - Ayuda sobre un comando específico
!ping - Ver la latencia del bot
!player [@usuario] - Ver perfil de jugador

Ver tu Progreso

!inventario o !inv - Ver tu inventario
!stats - Ver tus estadísticas detalladas
!logros - Ver tus logros
!misiones - Ver misiones disponibles
!cooldowns - Ver tus cooldowns activos

🎮 Sistema de Juego

Estadísticas de Combate

Tu personaje tiene las siguientes estadísticas:

HP (Vida): Puntos de vida actuales y máximos
ATK (Ataque): Daño que infliges
DEF (Defensa): Reduce el daño recibido

Equipo

Puedes equipar:

Arma (weapon): Aumenta tu ataque
Armadura (armor): Aumenta tu defensa
Capa (cape): Bonos especiales (HP, stats adicionales)

Comando:

!equipar <slot> <itemKey>

Ejemplos:

!equipar weapon iron_sword
!equipar armor leather_armor
!equipar cape red_cape

🎯 Minijuegos

Los minijuegos son la forma principal de obtener recursos y monedas.

⛏️ Minar

Extrae minerales valiosos de la mina.

Comando: !mina [nivel] [herramienta] [area:clave]

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

Herramienta requerida: Pico (pickaxe)

🎣 Pescar

Captura peces y tesoros en la laguna.

Comando: !pescar [nivel] [herramienta] [area:clave]

Ejemplos:

!pescar - Pesca automática
!pescar 3 - Pesca en nivel 3

Herramienta requerida: Caña de pescar (rod)

⚔️ Pelear

Enfrenta enemigos en la arena.

Comando: !pelear [nivel] [arma] [area:clave]

Ejemplos:

!pelear - Combate automático
!pelear 1 iron_sword - Usa espada específica

Herramienta requerida: Arma (sword, bow, halberd)

🌾 Plantar

Cultiva plantas y cosecha alimentos.

Comando: !plantar [nivel] [herramienta]

Herramienta requerida: Azada (hoe)

Cooldowns

Cada minijuego tiene un tiempo de espera entre usos. Usa !cooldowns para ver cuánto tiempo falta.

💡 Conceptos Básicos

¿Qué es una "key"?

Una key es un identificador único para cada elemento (item, mob, área, etc.). Es como el "nombre interno" del elemento.

Ejemplos de keys:

iron_sword - Espada de hierro
health_potion - Poción de vida
cave_spider - Enemigo araña

⚠️ Importante: Las keys no pueden repetirse y deben ser únicas.

Sistema de Pesos (Weights)

Cuando configuras recompensas o enemigos que aparecen, usas un sistema de pesos para decidir qué tan común es cada cosa.

Ejemplo:

{ "itemKey": "iron_ore", "weight": 10 }  ← Aparece 10 veces de cada 13
{ "itemKey": "gold_ore", "weight": 3 }   ← Aparece 3 veces de cada 13

Cuanto mayor sea el número, más probable es que aparezca.

🎒 Creando Items

Paso 1: Iniciar el Editor

Escribe en Discord:

!item-crear <key>

Ejemplo:

!item-crear iron_sword

Paso 2: Configurar la Base

Haz clic en el botón "Base" y llena los campos:

Campo	Descripción	Ejemplo
Nombre	Nombre visible del item	`Espada de Hierro`
Descripción	Descripción del item	`Una espada forjada con hierro resistente`
Categoría	Tipo de item	`weapons`
Icon URL	URL de una imagen (opcional)	`https://...`
Stackable y Máx	Si se apila y máximo por inventario	`true,10` o `false,1`

¿Qué significa "Stackable"?

true,10 = Se pueden apilar hasta 10 unidades del mismo item
false,1 = Solo puedes tener 1 unidad (común para armas/herramientas)
true, (dejar vacío el número) = Apilable sin límite

Paso 3: Agregar Tags (Opcional)

Los tags te ayudan a organizar tus items. Haz clic en "Tags" y escribe:

weapon, rare, crafteable

Paso 4: Configurar Propiedades Avanzadas (Props)

Aquí defines qué hace especial a tu item. Haz clic en "Props (JSON)".

🛠️ Props para Herramientas

Usa esto si tu item es una herramienta (pico, caña, espada, etc.):

{
  "tool": {
    "type": "pickaxe",
    "tier": 2
  },
  "breakable": {
    "enabled": true,
    "maxDurability": 150,
    "durabilityPerUse": 1
  }
}

Tipos de herramientas disponibles:

pickaxe (pico para minar)
rod (caña para pescar)
sword (espada para pelear)
bow (arco)
halberd (alabarda)
net (red)

Durabilidad:

maxDurability: Cuántos usos tiene antes de romperse
durabilityPerUse: Cuánta durabilidad pierde por uso (normalmente 1)

⚔️ Props para Armas/Armaduras

{
  "damage": 15,
  "defense": 0
}

damage: Daño que hace el arma
defense: Defensa que da la armadura
maxHpBonus: HP extra que otorga (para capas)

🍖 Props para Comida/Pociones

{
  "food": {
    "healHp": 50,
    "cooldownSeconds": 30
  }
}

healHp: Cuánta vida cura
healPercent: Porcentaje de vida que cura (opcional)
cooldownSeconds: Segundos antes de poder usar otra vez

📦 Props para Cofres

Los cofres pueden dar monedas, items o roles cuando se abren:

{
  "chest": {
    "enabled": true,
    "rewards": [
      { "type": "coins", "amount": 100 },
      { "type": "item", "itemKey": "iron_ore", "qty": 5 },
      { "type": "role", "roleId": "123456789012345678" }
    ],
    "consumeOnOpen": true
  }
}

consumeOnOpen: Si es true, el cofre se consume al abrirse

Paso 5: Guardar

Haz clic en "Guardar" y ¡listo! Tu item ha sido creado.

🔍 Gestionando Items

Ver Lista de Items

Para ver todos los items creados en tu servidor:

!items-lista [página]

Ejemplo:

!items-lista 1

Esto mostrará una lista interactiva con botones para:

Ver detalles completos de cada item
Navegar entre páginas
Ver información de categorías y props

Ver Detalles de un Item

Para ver información detallada de un item específico:

!item-ver <key>

Ejemplo:

!item-ver iron_sword

Esto mostrará:

Nombre y descripción
Categoría y tags
Propiedades (damage, defense, tool, etc.)
Configuración de stackable
Si es breakable y su durabilidad

Editar un Item

Para editar un item existente:

!item-editar <key>

Funciona igual que el comando de crear, pero con los valores actuales pre-cargados.

Eliminar un Item

Para eliminar un item permanentemente:

!item-eliminar <key>

⚠️ Advertencia: Esta acción es permanente y no se puede deshacer.

👹 Creando Enemigos (Mobs)

Paso 1: Iniciar el Editor

!mob-crear <key>

Ejemplo:

!mob-crear goblin

Paso 2: Configurar Base

Haz clic en "Base":

Nombre: Goblin
Categoría: enemies (opcional)

Paso 3: Configurar Stats

Haz clic en "Stats (JSON)":

{
  "attack": 10,
  "hp": 50,
  "defense": 3,
  "xpReward": 25
}

attack: Daño que hace el enemigo
hp: Vida del enemigo
defense: Defensa del enemigo
xpReward: Experiencia que da al derrotarlo

Paso 4: Configurar Drops (Recompensas)

Haz clic en "Drops (JSON)":

{
  "draws": 2,
  "table": [
    { "type": "coins", "amount": 20, "weight": 10 },
    { "type": "item", "itemKey": "leather", "qty": 1, "weight": 5 },
    { "type": "item", "itemKey": "goblin_tooth", "qty": 1, "weight": 2 }
  ]
}

draws: Cuántos premios saca de la tabla
table: Lista de posibles premios con su peso (probabilidad)

En este ejemplo:

Hace 2 extracciones
Más probable: 20 monedas (peso 10)
Medianamente probable: 1 cuero (peso 5)
Poco probable: 1 diente de goblin (peso 2)

Paso 5: Guardar

Haz clic en "Guardar".

🔍 Gestionando Enemigos

Ver Lista de Mobs

Para ver todos los enemigos creados en tu servidor:

!mobs-lista [página]

Ejemplo:

!mobs-lista 1

Esto mostrará una lista interactiva con:

Nombre y categoría de cada mob
Stats básicos (HP, ATK, DEF, XP)
Botones para ver más detalles

Eliminar un Mob

Para eliminar un enemigo permanentemente:

!mob-eliminar <key>

Ejemplo:

!mob-eliminar goblin

⚠️ Advertencia: Esta acción es permanente. Si el mob está siendo usado en áreas, puede causar errores.

🗺️ Configurando Áreas de Juego

Las áreas son lugares donde los jugadores pueden realizar actividades como minar, pescar o pelear.

Paso 1: Crear el Área

!area-crear <key>

Ejemplo:

!area-crear mine.iron_cavern

Paso 2: Configurar Base

Haz clic en "Base":

Nombre: Caverna de Hierro
Tipo: Elige uno:
- MINE (minar)
- LAGOON (pescar)
- FIGHT (pelear)
- FARM (plantar)

Paso 3: Configurar Config

Haz clic en "Config (JSON)":

{
  "cooldownSeconds": 60,
  "description": "Una profunda caverna llena de minerales de hierro",
  "icon": "⛏️"
}

cooldownSeconds: Segundos que deben esperar entre usos

Paso 4: Guardar

Haz clic en "Guardar".

🔍 Gestionando Áreas

Ver Lista de Áreas

Para ver todas las áreas configuradas en tu servidor:

!areas-lista [página]

Ejemplo:

!areas-lista 1

Esto mostrará:

Nombre y tipo de cada área (MINE, LAGOON, FIGHT, FARM)
Cooldown configurado
Si es global o del servidor
Botones para ver detalles de niveles

Eliminar un Área

Para eliminar un área permanentemente:

!area-eliminar <key>

Ejemplo:

!area-eliminar mine.iron_cavern

⚠️ Advertencia:

Esta acción eliminará el área Y todos sus niveles
Se perderá todo el progreso de los jugadores en esa área
Esta acción no se puede deshacer

📊 Configurando Niveles de Área

Los niveles son las "dificultades" de cada área. Cada nivel puede tener diferentes requisitos, recompensas y enemigos.

Paso 1: Crear el Nivel

!area-nivel <key-del-área> <número-de-nivel>

Ejemplo:

!area-nivel mine.iron_cavern 1

Paso 2: Configurar Requisitos

Haz clic en "Requisitos":

{
  "tool": {
    "required": true,
    "toolType": "pickaxe",
    "minTier": 2
  }
}

Significado:

Es obligatorio tener un pico (required: true)
Debe ser un pico de nivel 2 o superior (minTier: 2)

Si no quieres requisitos:

{}

Paso 3: Configurar Recompensas

Haz clic en "Recompensas":

{
  "draws": 3,
  "table": [
    { "type": "coins", "amount": 50, "weight": 10 },
    { "type": "item", "itemKey": "iron_ore", "qty": 2, "weight": 8 },
    { "type": "item", "itemKey": "gold_ore", "qty": 1, "weight": 2 }
  ]
}

En este ejemplo:

Hace 3 extracciones de la tabla
Más probable: 50 monedas
Probable: 2 minerales de hierro
Poco probable: 1 mineral de oro

Paso 4: Configurar Mobs (Enemigos que Aparecen)

Haz clic en "Mobs":

{
  "draws": 1,
  "table": [
    { "mobKey": "cave_spider", "weight": 10 },
    { "mobKey": "bat", "weight": 5 },
    { "mobKey": "cave_troll", "weight": 1 }
  ]
}

draws: Cuántos enemigos pueden aparecer (en este caso, 1)
Más probable: araña de cueva
Menos probable: murciélago
Muy poco probable: troll de cueva

Si no quieres enemigos:

{
  "draws": 0,
  "table": []
}

Paso 5: Configurar Ventana de Disponibilidad (Opcional)

Si quieres que el nivel solo esté disponible en ciertas fechas, haz clic en "Ventana":

Desde: 2025-12-01T00:00:00Z (formato ISO)
Hasta: 2025-12-31T23:59:59Z

Deja en blanco si quieres que esté siempre disponible.

Paso 6: Guardar

Haz clic en "Guardar".

🏪 Creando Ofertas de Tienda

Las ofertas permiten vender items a los jugadores.

Paso 1: Crear la Oferta

!offer-crear

Paso 2: Configurar Base

Haz clic en "Base":

Item Key: iron_sword (el item que quieres vender)
Habilitada?: true (o false para deshabilitarla)

Paso 3: Configurar Precio

Haz clic en "Precio (JSON)":

Precio solo en monedas:

{
  "coins": 100
}

Precio en monedas e items:

{
  "coins": 50,
  "items": [
    { "itemKey": "iron_ore", "qty": 5 },
    { "itemKey": "wood", "qty": 10 }
  ]
}

Significado: Cuesta 50 monedas + 5 minerales de hierro + 10 maderas.

Paso 4: Configurar Límites (Opcional)

Haz clic en "Límites":

Límite por usuario: 5 (cada jugador puede comprar máximo 5)
Stock global: 100 (solo hay 100 unidades disponibles en total)

Deja en blanco para ilimitado.

Paso 5: Configurar Ventana (Opcional)

Si es una oferta temporal (como evento), haz clic en "Ventana":

Inicio: 2025-12-20T00:00:00Z
Fin: 2025-12-25T23:59:59Z

Paso 6: Guardar

Haz clic en "Guardar".

📚 Ejemplos Prácticos

Ejemplo 1: Sistema de Minería Completo

1. Crear el Pico de Madera

!item-crear wooden_pickaxe

Base:

Nombre: Pico de Madera
Descripción: Un pico básico para empezar a minar
Stackable: false,1

Props:

{
  "tool": { "type": "pickaxe", "tier": 1 },
  "breakable": { "enabled": true, "maxDurability": 50, "durabilityPerUse": 1 }
}

2. Crear el Mineral de Cobre

!item-crear copper_ore

Base:

Nombre: Mineral de Cobre
Descripción: Un mineral común encontrado en las minas
Stackable: true,999

Props:

{
  "craftingOnly": false
}

3. Crear el Área de Mina

!area-crear mine.starter

Base:

Nombre: Mina Inicial
Tipo: MINE

Config:

{
  "cooldownSeconds": 30,
  "icon": "⛏️"
}

4. Crear Nivel 1 de la Mina

!area-nivel mine.starter 1

Requisitos:

{
  "tool": { "required": true, "toolType": "pickaxe", "minTier": 1 }
}

Recompensas:

{
  "draws": 2,
  "table": [
    { "type": "coins", "amount": 10, "weight": 10 },
    { "type": "item", "itemKey": "copper_ore", "qty": 1, "weight": 8 }
  ]
}

Mobs:

{
  "draws": 0,
  "table": []
}

Ejemplo 2: Cofre de Recompensa Diaria

!item-crear daily_chest

Base:

Nombre: Cofre Diario
Descripción: Un cofre que contiene recompensas aleatorias
Stackable: true,10

Props:

{
  "chest": {
    "enabled": true,
    "rewards": [
      { "type": "coins", "amount": 500 },
      { "type": "item", "itemKey": "health_potion", "qty": 3 }
    ],
    "consumeOnOpen": true
  }
}

Ejemplo 3: Espada Legendaria

!item-crear legendary_sword

Base:

Nombre: ⚔️ Espada Legendaria de los Dragones
Descripción: Una espada forjada con escamas de dragón. Aumenta tu poder de ataque en 50 puntos.
Categoría: legendary_weapons
Stackable: false,1

Tags:

legendary, weapon, sword, dragon

Props:

{
  "damage": 50,
  "tool": { "type": "sword", "tier": 5 },
  "breakable": { "enabled": false }
}

Ejemplo 4: Enemigo Boss

!mob-crear dragon_boss

Base:

Nombre: 🐉 Dragón Ancestral
Categoría: boss

Stats:

{
  "attack": 50,
  "hp": 1000,
  "defense": 30,
  "xpReward": 1000
}

Drops:

{
  "draws": 5,
  "table": [
    { "type": "coins", "amount": 1000, "weight": 10 },
    { "type": "item", "itemKey": "dragon_scale", "qty": 3, "weight": 8 },
    { "type": "item", "itemKey": "legendary_sword", "qty": 1, "weight": 1 }
  ]
}

🏆 Creando Logros

Los logros son recompensas que los jugadores pueden obtener al completar ciertos objetivos.

Paso 1: Crear el Logro

!logro-crear <key-única>

Ejemplo:

!logro-crear master_miner

Paso 2: Configurar Base

Haz clic en "Base":

Nombre: Maestro Minero
Descripción: Mina 1000 veces en áreas de minería
Categoría: mining (mining, combat, economy, fishing, etc.)
Icono: ⛏️ (emoji o URL)
Puntos: 100 (puntos que otorga el logro)
Oculto: false (si es true, no se muestra hasta desbloquearlo)

Paso 3: Configurar Requisitos

Haz clic en "Requisitos (JSON)":

Requisitos de Conteo de Acción:

{
  "type": "mine_count",
  "value": 1000
}

Tipos disponibles:

mine_count: Veces que ha minado
fish_count: Veces que ha pescado
fight_count: Veces que ha peleado
craft_count: Veces que ha crafteado
coins_earned: Monedas ganadas en total
items_collected: Items colectados

Requisitos de Item:

{
  "type": "item_owned",
  "itemKey": "diamond_pickaxe",
  "quantity": 1
}

Paso 4: Configurar Recompensas

Haz clic en "Recompensas (JSON)":

{
  "coins": 5000,
  "items": [
    { "itemKey": "legendary_pickaxe", "qty": 1 }
  ]
}

Paso 5: Guardar

Haz clic en "Guardar".

🔍 Gestionando Logros

Ver Lista de Logros

!logros-lista [página]

Muestra todos los logros del servidor con:

Nombre y descripción
Puntos que otorga
Si está oculto
Botones para ver detalles

Ver Detalles de un Logro

!logro-ver <key>

Ejemplo:

!logro-ver master_miner

Eliminar un Logro

!logro-eliminar <key>

⚠️ Advertencia: Esto eliminará el logro y el progreso de todos los jugadores.

🎯 Creando Misiones

Las misiones son tareas que los jugadores pueden completar para obtener recompensas.

Paso 1: Crear la Misión

!mision-crear <key-única>

Ejemplo:

!mision-crear daily_mining_quest

Paso 2: Configurar Base

Haz clic en "Base":

Nombre: Misión Diaria: Minería
Descripción: Mina 10 veces en cualquier área
Categoría: mining
Tipo: daily (daily, weekly, one_time, repeatable)
Icono: ⛏️
Repetible: true

Paso 3: Configurar Requisitos

Haz clic en "Requisitos (JSON)":

Contar Acción:

{
  "type": "mine_count",
  "count": 10
}

Recolectar Items:

{
  "type": "collect_items",
  "items": [
    { "itemKey": "iron_ore", "quantity": 20 }
  ]
}

Derrotar Enemigos:

{
  "type": "defeat_mobs",
  "mobKey": "goblin",
  "count": 5
}

Paso 4: Configurar Recompensas

Haz clic en "Recompensas (JSON)":

{
  "coins": 1000,
  "xp": 500,
  "items": [
    { "itemKey": "mystery_chest", "qty": 1 }
  ]
}

Paso 5: Guardar

Haz clic en "Guardar".

🔍 Gestionando Misiones

Ver Lista de Misiones

!misiones-lista [página]

Ver Detalles de una Misión

!mision-ver <key>

Eliminar una Misión

!mision-eliminar <key>

👤 Comandos de Jugador

Ver Perfil

!player [@usuario]

Ver Estadísticas

!stats [@usuario]

Ver Cooldowns

!cooldowns

Ver Saldo

!monedas

Ver Racha Diaria

!racha

Ver Inventario

!inventario [página]

Ver Logros

!logros [@usuario]

Ver Misiones

!misiones

Reclamar Misión

!mision-reclamar <key>

❓ Preguntas Frecuentes

¿Puedo editar un item después de crearlo?

Sí, usa el comando:

!item-editar <key>

¿Cómo elimino un item?

Usa el comando:

!item-eliminar <key>

Advertencia: Esta acción es permanente y no se puede deshacer.

¿Cómo veo todos los items creados?

Usa el comando:

!items-lista

Esto mostrará una lista interactiva paginada con todos los items del servidor.

¿Qué formato tienen las fechas ISO?

El formato ISO es: YYYY-MM-DDTHH:MM:SSZ

Ejemplos:

2025-01-15T00:00:00Z (15 de enero de 2025 a las 00:00 UTC)
2025-12-25T23:59:59Z (25 de diciembre de 2025 a las 23:59 UTC)

¿Puedo crear items globales para todos los servidores?

Solo los administradores del bot pueden crear items globales. Los items que crees estarán limitados a tu servidor.

¿Cuántos niveles puedo crear por área?

No hay límite técnico, pero se recomienda entre 5-10 niveles por área para mantener la progresión balanceada.

¿Qué pasa si un jugador no tiene la herramienta requerida?

El bot le mostrará un mensaje indicando qué herramienta necesita y de qué nivel.

¿Cómo funcionan los pesos (weights)?

Los pesos determinan la probabilidad relativa. Por ejemplo:

Item A (weight: 10) y Item B (weight: 5)
Item A tiene el doble de probabilidad de salir que Item B
Probabilidad de A: 10/15 = 66.7%
Probabilidad de B: 5/15 = 33.3%

¿Puedo hacer que un item cure un porcentaje de vida en lugar de cantidad fija?

Sí, usa healPercent en las props de food:

{
  "food": {
    "healPercent": 50,
    "cooldownSeconds": 60
  }
}

Esto curará el 50% de la vida máxima del jugador.

¿Cómo hago que un nivel sea más difícil que otro?

Aumenta:

El tier mínimo de herramienta requerida
El peso de enemigos más fuertes
Reduce el peso de recompensas comunes
Aumenta el cooldown del área

¿Puedo combinar diferentes tipos de props en un item?

Sí, puedes combinar múltiples props. Por ejemplo, un item que sea arma y herramienta:

{
  "tool": { "type": "sword", "tier": 3 },
  "damage": 25,
  "breakable": { "enabled": true, "maxDurability": 200, "durabilityPerUse": 1 }
}

🎓 Consejos Pro

Balanceo de Economía

Items iniciales: 10-100 monedas
Items raros: 500-1000 monedas
Items legendarios: 5000+ monedas

Progresión de Herramientas

Tier recomendado:

Tier 1: Madera/Piedra
Tier 2: Cobre/Bronce
Tier 3: Hierro
Tier 4: Acero
Tier 5: Mithril/Legendario

Durabilidad Recomendada

Herramientas básicas: 50-100 usos
Herramientas intermedias: 150-300 usos
Herramientas avanzadas: 500+ usos

Cooldowns Recomendados

Actividades básicas: 30-60 segundos
Actividades intermedias: 2-5 minutos
Actividades difíciles: 10-30 minutos

🆕 Preguntas Frecuentes sobre Logros y Misiones

¿Cómo funcionan los logros?

Los logros son objetivos permanentes que los jugadores desbloquean al cumplir requisitos específicos. Otorgan puntos y recompensas únicas.

¿Cuál es la diferencia entre logros y misiones?

Logros: Permanentes, se desbloquean una vez, dan puntos y prestigio
Misiones: Pueden ser repetibles, tienen tipos (diarias, semanales), dan recompensas cada vez

¿Los logros pueden ser ocultos?

Sí, puedes marcar un logro como hidden: true. Los jugadores no verán su existencia hasta desbloquearlo.

¿Puedo crear misiones que se repitan cada día?

Sí, configura el tipo como daily y repeatable: true. Los jugadores podrán completarla cada día.

¿Cómo veo el progreso de los jugadores en misiones?

Usa !mision-ver <key> para ver estadísticas generales, o pídele al jugador que use !misiones para ver su progreso personal.

¿Los logros y misiones pueden dar items como recompensa?

Sí, ambos pueden recompensar con:

Monedas
XP (experiencia)
Items específicos
Roles de Discord (solo en logros especiales)

¿Qué pasa si elimino un logro que los jugadores ya desbloquearon?

Se eliminará el registro de desbloqueo de todos los jugadores. Es mejor desactivar o editar en lugar de eliminar.

¿Puedo tener misiones con múltiples requisitos?

Sí, usa el tipo all en los requisitos y lista todos los que deben cumplirse:

{
  "type": "all",
  "requirements": [
    { "type": "mine_count", "count": 10 },
    { "type": "collect_items", "items": [...] }
  ]
}

📞 Soporte

Si tienes problemas o preguntas:

Verifica que tengas los permisos necesarios
Revisa que tus JSONs estén bien formateados
Usa los comandos de lista (!items-lista, !mobs-lista, etc.) para verificar que todo se creó correctamente
Revisa los logs del bot en caso de errores
Contacta al soporte del bot en el servidor oficial

¡Feliz creación de contenido! 🎉

📚 Documentación Completa

Esta guía es un resumen. Para la documentación completa, interactiva y moderna con todas las secciones detalladas, incluyendo:

✅ Todos los comandos con ejemplos
✅ Sistema completo de creación de contenido (Items, Mobs, Áreas, Niveles, Ofertas)
✅ Guía de Props y configuraciones JSON
✅ Ejemplos prácticos completos
✅ Tips, trucos y FAQ
✅ Diseño moderno con navegación interactiva

Accede a: src/server/public/index.html

O visita la URL de tu servidor: http://tu-servidor:puerto/

🔗 Recursos Adicionales

CREACION_DE_CONTENIDO.md - Documentación técnica detallada para administradores sobre creación de contenido
index.html - Documentación web completa e interactiva
Repositorio del Bot - Código fuente y documentación técnica

Última actualización: Enero 2025 • Versión 0.11.20
Amayo Bot © 2025 - Documentación para usuarios finales de Discord

27 KiB Raw Blame History

🎮 Guía de Usuario Completa - Amayo Bot

📋 Tabla de Contenidos

Para Todos los Usuarios

Para Administradores

Recursos

🚀 Primeros Pasos

¿Qué es Amayo Bot?

Prefix del Bot

⚡ Comandos Básicos

Información General

Ver tu Progreso

🎮 Sistema de Juego

Estadísticas de Combate

Equipo

🎯 Minijuegos

⛏️ Minar

🎣 Pescar

⚔️ Pelear

🌾 Plantar

Cooldowns

💡 Conceptos Básicos

¿Qué es una "key"?

Sistema de Pesos (Weights)

🎒 Creando Items

Paso 1: Iniciar el Editor

Paso 2: Configurar la Base

¿Qué significa "Stackable"?

Paso 3: Agregar Tags (Opcional)

Paso 4: Configurar Propiedades Avanzadas (Props)

🛠️ Props para Herramientas

⚔️ Props para Armas/Armaduras

🍖 Props para Comida/Pociones

📦 Props para Cofres

Paso 5: Guardar

🔍 Gestionando Items

Ver Lista de Items

Ver Detalles de un Item

Editar un Item

Eliminar un Item

👹 Creando Enemigos (Mobs)

Paso 1: Iniciar el Editor

Paso 2: Configurar Base

Paso 3: Configurar Stats

Paso 4: Configurar Drops (Recompensas)

Paso 5: Guardar

🔍 Gestionando Enemigos

Ver Lista de Mobs

Eliminar un Mob

🗺️ Configurando Áreas de Juego

Paso 1: Crear el Área

Paso 2: Configurar Base

Paso 3: Configurar Config

Paso 4: Guardar

🔍 Gestionando Áreas

Ver Lista de Áreas

Eliminar un Área

📊 Configurando Niveles de Área

Paso 1: Crear el Nivel

Paso 2: Configurar Requisitos

Paso 3: Configurar Recompensas

Paso 4: Configurar Mobs (Enemigos que Aparecen)

Paso 5: Configurar Ventana de Disponibilidad (Opcional)

Paso 6: Guardar

🏪 Creando Ofertas de Tienda

Paso 1: Crear la Oferta

Paso 2: Configurar Base

Paso 3: Configurar Precio

Precio solo en monedas:

Precio en monedas e items:

Paso 4: Configurar Límites (Opcional)

Paso 5: Configurar Ventana (Opcional)

Paso 6: Guardar

📚 Ejemplos Prácticos

Ejemplo 1: Sistema de Minería Completo

1. Crear el Pico de Madera

2. Crear el Mineral de Cobre

3. Crear el Área de Mina

4. Crear Nivel 1 de la Mina

Ejemplo 2: Cofre de Recompensa Diaria

27 KiB

Raw Blame History