From 96fe80de5f44b24bcf7a1f892cd24d0d0ebf07cc Mon Sep 17 00:00:00 2001 From: shnimlz Date: Fri, 10 Oct 2025 00:33:28 -0500 Subject: [PATCH] Implement code structure updates and remove redundant code blocks --- README.MD | 422 ++++-- src/server/public/404.html | 46 - src/server/public/index.html | 1643 ------------------------ src/server/public/index.html.backup | 824 ------------ src/server/public/index.html.v2.backup | 1323 ------------------- 5 files changed, 294 insertions(+), 3964 deletions(-) delete mode 100644 src/server/public/404.html delete mode 100644 src/server/public/index.html delete mode 100644 src/server/public/index.html.backup delete mode 100644 src/server/public/index.html.v2.backup diff --git a/README.MD b/README.MD index 42142ac..2793312 100644 --- a/README.MD +++ b/README.MD @@ -1,170 +1,336 @@ -# Amayo Bot — Guía de Comandos para Discord +# 🤖 Amayo Bot — Guía de Comandos para Discord -> Nota: Para crear y editar Items, Mobs, Áreas, Niveles y Ofertas con los editores interactivos, consulta la guía: [CREACION_DE_CONTENIDO.md](./CREACION_DE_CONTENIDO.md) +
-Bienvenido/a. Aquí tienes una guía lista para pegar en tu servidor de Discord con todos los comandos disponibles y lo que hacen. +![Version](https://img.shields.io/badge/version-2.0-blueviolet?style=for-the-badge) +![Discord](https://img.shields.io/badge/Discord-Bot-5865F2?style=for-the-badge&logo=discord&logoColor=white) +![AI](https://img.shields.io/badge/AI-Gemini-4285F4?style=for-the-badge&logo=google&logoColor=white) -- Prefix por defecto: `!` (puede cambiarse con `!configuracion`) -- Ayuda en Discord: `!ayuda`, `!ayuda `, `!ayuda ` -- Algunos comandos requieren permisos de Administrador; están marcados. +**Tu asistente definitivo para Discord con IA integrada** ⚡ -## Comandos por categoría +[![Prefix](https://img.shields.io/badge/Prefix-!-success?style=for-the-badge)](https://github.com) -### IA -- `!ai ` - - Aliases: `!chat`, `!gemini` - - Qué hace: Chatea con la IA (Gemini) directamente desde Discord. - - Ejemplo: `!ai ¿Cómo funciona JavaScript?` +
-### Utilidad -- `!ayuda [comando|categoría]` - - Aliases: `!help`, `!comandos`, `!cmds` - - Qué hace: Muestra la lista de comandos y detalles por categoría. Si pasas un nombre de comando o categoría, filtra el resultado. +--- -### Red -- `!ping` - - Aliases: `!latency`, `!pong` - - Qué hace: Verifica la latencia y que el bot esté respondiendo. +> 📝 **Nota importante:** Para crear y editar Items, Mobs, Áreas, Niveles y Ofertas con los editores interactivos, consulta la guía: [CREACION_DE_CONTENIDO.md](./CREACION_DE_CONTENIDO.md) -### Configuración (Admin) -- `!configuracion` - - Aliases: `!config`, `!ajustes`, `!settings` - - Qué hace: Abre el panel de configuración del servidor (por ejemplo, cambiar el prefix). - - Permisos: Requiere Administrador. +--- -### Administración (Owner) -- `!admin-comandos` - - Aliases: `!cmdadmin`, `!synccommands`, `!comandos-admin` - - Qué hace: Panel del dueño para registrar/limpiar comandos slash y revisar memoria. - - Permisos: Solo propietario del bot. +## 📚 Tabla de Contenidos -### Alianzas (Gestión de bloques y canales) — Admin -Bloques (presentaciones/embeds avanzados con Display Components): -- `!crear-embed ` - - Aliases: `!embed-crear`, `!nuevo-embed`, `!blockcreatev2` - - Qué hace: Crea un bloque/embedded nuevo con editor interactivo. - - Permisos: Administrador. -- `!editar-embed ` - - Aliases: `!embed-editar`, `!modificar-embed`, `!blockeditv2` - - Qué hace: Edita un bloque/embedded existente con herramientas interactivas. - - Permisos: Administrador. -- `!lista-embeds` - - Aliases: `!embeds`, `!ver-embeds`, `!embedlist` - - Qué hace: Lista los bloques existentes con paginación y acciones rápidas. - - Permisos: Administrador. -- `!eliminar-embed` - - Aliases: `!embed-eliminar`, `!borrar-embed`, `!embeddelete` - - Qué hace: Panel interactivo para eliminar bloques de forma segura. - - Permisos: Administrador. +- [🧠 Inteligencia Artificial](#-inteligencia-artificial) +- [🛠️ Utilidad](#️-utilidad) +- [📡 Red](#-red) +- [⚙️ Configuración](#️-configuración) +- [👑 Administración](#-administración) +- [🤝 Alianzas](#-alianzas) + - [📦 Gestión de Bloques/Embeds](#-gestión-de-bloquesembeds) + - [📢 Canales de Alianza](#-canales-de-alianza) + - [🎨 Demostración](#-demostración) +- [⚡ Slash Commands](#-slash-commands) +- [💡 Consejos Rápidos](#-consejos-rápidos) +- [📋 Bloque para tu Servidor](#-bloque-para-tu-servidor) -Canales de alianza (puntos por enlaces válidos, etc.): -- `!canal-alianza` - - Aliases: `!alchannel`, `!channelally` - - Qué hace: Abre el centro de configuración para asignar un bloque a un canal de texto y activarlo. - - Permisos: Administrador. -- `!listar-canales-alianza` - - Aliases: `!listchannels-alliance`, `!listalchannel`, `!channelsally`, `!alliancechannels` - - Qué hace: Muestra los canales de alianza configurados con estado y estadísticas. - - Permisos: Administrador recomendado. -- `!eliminar-canal-alianza` - - Aliases: `!removechannel-alliance`, `!removealchannel`, `!delalchannel` - - Qué hace: Elimina la configuración de alianza de un canal seleccionado (mantiene historial). - - Permisos: Administrador. +--- -Demostración/ejemplos: -- `!displaydemo` - - Aliases: `!ddemo`, `!componentsdemo` - - Qué hace: Demostración de Display Components con accesorios y acciones. - - Permisos: Administrador. -- `!test1` - - Qué hace: Mensaje de ejemplo de componentes/embeds (demo interna). +## 🧠 Inteligencia Artificial -### Slash commands -- `/ping` - - Qué hace: Responde con “pong!” (prueba rápida de slash). +### `!ai ` +> **Aliases:** `!chat`, `!gemini` -## Consejos rápidos - - Puede requerir permisos de Administrador o ser solo del dueño. - - Asegúrate de usarlo en un canal de texto compatible. - - Escribe `!ayuda ` para ver el uso correcto. +💬 Chatea con la IA (Gemini) directamente desde Discord. Pregunta lo que quieras, desde programación hasta consejos generales. -## Bloque listo para copiar y pegar en tu server +**Ejemplo:** +``` +!ai ¿Cómo funciona JavaScript? +``` -Copia todo este bloque y pégalo en tu canal de información o bienvenida. +--- + +## 🛠️ Utilidad + +### `!ayuda [comando|categoría]` +> **Aliases:** `!help`, `!comandos`, `!cmds` + +📚 Muestra la lista completa de comandos y detalles por categoría. Puedes filtrar por comando específico o categoría. + +**Ejemplos:** +``` +!ayuda +!ayuda ai +!ayuda Alianzas +``` + +--- + +## 📡 Red + +### `!ping` +> **Aliases:** `!latency`, `!pong` + +🏓 Verifica la latencia del bot y confirma que está respondiendo correctamente. + +--- + +## ⚙️ Configuración + +> 🔒 **Requiere:** Permisos de Administrador + +### `!configuracion` +> **Aliases:** `!config`, `!ajustes`, `!settings` + +🔧 Abre el panel de configuración del servidor donde puedes personalizar el prefix y otras opciones. + +--- + +## 👑 Administración + +> 🔒 **Requiere:** Ser el propietario del bot + +### `!admin-comandos` +> **Aliases:** `!cmdadmin`, `!synccommands`, `!comandos-admin` + +🎛️ Panel exclusivo del dueño del bot para registrar/limpiar comandos slash y revisar el estado de memoria. + +--- + +## 🤝 Alianzas + +> 🔒 **Requiere:** Permisos de Administrador + +Sistema completo de gestión de alianzas con bloques personalizados y canales configurables. + +### 📦 Gestión de Bloques/Embeds + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ComandoDescripción
+ +**`!crear-embed `** + +*Aliases:* `!embed-crear`, `!nuevo-embed`, `!blockcreatev2` + + + +✨ Crea un bloque/embedded nuevo con editor interactivo avanzado y Display Components. + +
+ +**`!editar-embed `** + +*Aliases:* `!embed-editar`, `!modificar-embed`, `!blockeditv2` + + + +✏️ Edita un bloque/embedded existente con herramientas interactivas completas. + +
+ +**`!lista-embeds`** + +*Aliases:* `!embeds`, `!ver-embeds`, `!embedlist` + + + +📋 Lista todos los bloques existentes con paginación y acciones rápidas. + +
+ +**`!eliminar-embed`** + +*Aliases:* `!embed-eliminar`, `!borrar-embed`, `!embeddelete` + + + +🗑️ Panel interactivo para eliminar bloques de forma segura. + +
+ +### 📢 Canales de Alianza + + + + + + + + + + + + + + + + + + + + + + +
ComandoDescripción
+ +**`!canal-alianza`** + +*Aliases:* `!alchannel`, `!channelally` + + + +🎯 Abre el centro de configuración para asignar un bloque a un canal de texto y activar el sistema de puntos por enlaces válidos. + +
+ +**`!listar-canales-alianza`** + +*Aliases:* `!listchannels-alliance`, `!listalchannel`, `!channelsally`, `!alliancechannels` + + + +📊 Muestra todos los canales de alianza configurados con estado y estadísticas detalladas. + +
+ +**`!eliminar-canal-alianza`** + +*Aliases:* `!removechannel-alliance`, `!removealchannel`, `!delalchannel` + + + +❌ Elimina la configuración de alianza de un canal seleccionado (mantiene el historial). + +
+ +### 🎨 Demostración + +| Comando | Descripción | +|---------|-------------| +| **`!displaydemo`**
*Aliases:* `!ddemo`, `!componentsdemo` | 🎪 Demostración completa de Display Components con todos los accesorios y acciones disponibles. | +| **`!test1`** | 🧪 Mensaje de ejemplo de componentes/embeds (demo interna para pruebas). | + +--- + +## ⚡ Slash Commands + +### `/ping` +🏓 Responde con "pong!" - Prueba rápida de comandos slash. + +--- + +## 💡 Consejos Rápidos + +
+¿Olvidaste el prefix? + +Usa `@mencionar_al_bot ayuda` o prueba `!ayuda` + +
+ +
+¿Un comando no funciona? + +- ✅ Puede requerir permisos de Administrador o ser exclusivo del dueño +- ✅ Asegúrate de usarlo en un canal de texto compatible +- ✅ Escribe `!ayuda ` para ver el uso correcto + +
+ +
+¿Necesitas ayuda específica? + +Usa `!ayuda ` para filtrar por tipo de comando + +**Categorías disponibles:** +- `IA` +- `Utilidad` +- `Red` +- `Configuración` +- `Administración` +- `Alianzas` + +
+ +--- + +## 📋 Bloque para tu Servidor + +Copia este bloque y pégalo en tu canal de información o bienvenida: ``` -## Sistema RPG (Beta) - -El bot incluye un sistema RPG ligero con progreso persistente y combate simplificado. - -### Conceptos Clave -- **HP Persistente:** Tu vida (HP) se mantiene entre actividades. Si llegas a 0 en combate, resurges automáticamente al 50% de tu máximo (regeneración de seguridad) y se incrementa `Veces Derrotado`. -- **Rachas de Victoria:** Cada 3 victorias consecutivas obtienes +1% de daño (hasta +30%). Al perder, la racha se reinicia. -- **Herramientas con Durabilidad por Instancia:** Las herramientas no apilables crean instancias independientes; cada uso consume durabilidad de una instancia. Al agotarse una instancia, desaparece solo esa (si quedan otras, se siguen usando). Cuando la última instancia se rompe, el ítem queda completamente agotado. -- **Origen de Herramienta:** El sistema selecciona herramienta en este orden: (1) la que pases directamente (argumento), (2) la equipada (slot apropiado), (3) la mejor del inventario. El comando mostrará su procedencia (`toolSource`). -- **Combate Simplificado:** Se simulan rondas contra mobs; se registra daño infligido/recibido, mobs derrotados y resultado (Victoria/Derrota). -- **Resumen Visual:** Corazones (❤/♡) y barra de durabilidad reflejan estado tras cada acción. - -### Comandos RPG Principales -- `!mina [nivel] [toolKey]` — Minar (usa pico). -- `!pescar [nivel] [toolKey]` — Pescar (usa caña). -- `!pelear [nivel] [toolKey]` — Combatir (usa espada). -- `!combate-historial [n]` — Últimos combates resumidos. -- `!tool-breaks [n]` — Rupturas recientes de herramientas (memoria). -- (Opcional futuro) `!tool-info ` — Ver instancias y durabilidad. - -### Estadísticas (PlayerStats) -Se actualizan automáticamente: -- Actividades: `minesCompleted`, `fishingCompleted`, `fightsCompleted`. -- Combate: `mobsDefeated`, `damageDealt`, `damageTaken`, `timesDefeated`, `currentWinStreak`, `longestWinStreak`. - -### Estructura de Resultados -Cada minijuego produce un `RunResult` con bloque `tool` (incluye `toolSource`, `brokenInstance`, `instancesRemaining`) y, si aplica, `combat` con: -- `playerStartHp`, `playerEndHp`, `outcome`, `damageDealt`, `damageTaken`, `mobsDefeated`. - -### Próximas Mejoras Planeadas -- Tabla persistente de rupturas (`ToolBreakLog`). -- Definiciones avanzadas de mobs (stats dinámicos, efectos críticos, resistencias). -- Efectos de equipo: críticos, sangrado, bloqueo, robo de vida. -- Consumo de pociones en combate y estados alterados. -- Eventos programados (ataques globales de mobs) vía funciones externas (Appwrite / cron). - -### Notas Técnicas -- HP y maxHp: `PlayerState` + bonificaciones de equipo. -- Racha: cálculo en `getEffectiveStats()` (1% cada 3 victorias, tope 30%). -- Durabilidad: lógica por instancia en `reduceToolDurability` (remueve instancia agotada). -- Combate: loop interno en servicio de minijuegos actualiza daño y resultado, persistiendo HP final. -- Logs: Rupturas se guardan en memoria (buffer circular) para inspección rápida. - -> Esta sección está en evolución: puede cambiar estructura interna para soportar mobs declarativos y balance más profundo. - 📌 Amayo Bot — Guía Rápida de Comandos Prefix: ! (puedes cambiarlo con !configuracion) -IA +🧠 IA • !ai — Chatea con la IA (aliases: !chat, !gemini) -Utilidad +🛠️ Utilidad • !ayuda [comando|categoría] — Lista y detalles de comandos -Red +📡 Red • !ping — Prueba de latencia -Configuración (Admin) +⚙️ Configuración (Admin) • !configuracion — Panel de ajustes del servidor -Alianzas (Admin) +🤝 Alianzas (Admin) +📦 Bloques/Embeds: • !crear-embed — Crear bloque interactivo • !editar-embed — Editar bloque • !lista-embeds — Ver bloques • !eliminar-embed — Eliminar bloques + +📢 Canales: • !canal-alianza — Configurar canal • !listar-canales-alianza — Ver configurados • !eliminar-canal-alianza — Eliminar canal de la configuración + +🎨 Demo: • !displaydemo — Demo de componentes -Slash +⚡ Slash • /ping — Pong! Más ayuda: !ayuda | !ayuda | !ayuda ``` + +--- + +
+ +### ⚡ Desarrollado con 💜 + +**Amayo Bot © 2025** + +Potenciado por Discord.js & Gemini AI + +[![Discord.js](https://img.shields.io/badge/Discord.js-v14-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.js.org) +[![Node.js](https://img.shields.io/badge/Node.js-v18+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org) +[![Gemini](https://img.shields.io/badge/Gemini-AI-4285F4?style=flat-square&logo=google&logoColor=white)](https://ai.google.dev) + +
\ No newline at end of file diff --git a/src/server/public/404.html b/src/server/public/404.html deleted file mode 100644 index 98a5da6..0000000 --- a/src/server/public/404.html +++ /dev/null @@ -1,46 +0,0 @@ - - - - - - Página no encontrada | Amayo Docs - - - - -
-

404

-

No encontramos la página que buscabas.

- Regresar al índice -
- - diff --git a/src/server/public/index.html b/src/server/public/index.html deleted file mode 100644 index 45337aa..0000000 --- a/src/server/public/index.html +++ /dev/null @@ -1,1643 +0,0 @@ - - - - - - Amayo Bot | Guía Completa para Usuarios de Discord - - - - - - - - -
-
-
-
-
- - -
- -
-
- -
-
- -
- - - - - - Amayo Bot • v2.0.1-dev - -
- - -

- - Guía Completa - - - Amayo Bot - -

- - -

- Sistema completo de economía, minijuegos, misiones y IA para Discord -

- - -
- -
-
- - Comenzar ahora - - - - - - - -
- - -
- - Discord.js 15.0-dev - - - Enero 2025 - - - 23 Secciones • Creación de Contenido Incluida - -
-
-
-
- - -
- -
- -
- - -
-
- - -
-

🚀 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

-
-
-
-
- -
- 💡 Consejo: -

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

-
-
-
-
- -
- ⏰ Cooldowns: -

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

-
-
-
-
- -
- 💡 Tip: -

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)
    • -
-
-
- -
- ⚠️ Importante: -

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

-
-
-
- -
- 💡 Tip: -

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

-
    -
  1. El bot verifica si tienes los materiales necesarios en tu inventario
    2. -
  2. Si los tienes, consume los materiales
    3. -
  3. Agrega el producto crafteado a tu inventario
    4. -
  4. Te notifica el resultado
    5. -
-
-
- -
- ⚠️ Nota: -

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
    • -
-
-
- -
- ✨ Automático: -

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.

-
-
-
- -
- �� Tip: -

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:

-
-
3 días
-
7 días
-
14 días
-
30 días
-
60 días
-
90 días
-
180 días
-
365 días
-
-
-
-
- -
- ⚠️ Importante: -

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.

-
-
- -
- 💡 Estrategia: -

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. -

-
-
- -
- 💎 Rareza: -

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. -

-
-
- -
- ✨ Eventos Especiales: -

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

-
    -
  1. El bot verifica que tienes los materiales necesarios
    2. -
  2. Consume los materiales de tu inventario
    3. -
  3. Crea un trabajo de fundición con un tiempo de espera
    4. -
  4. Cuando el tiempo termina, puedes reclamar el producto
    5. -
-
-
- -
- ⏰ Gestión del Tiempo: -

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
    • -
-
-
- -
- 🌟 Powered by Gemini: -

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

-
-
-
- -
- ⚠️ Nota: -

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. -

- -
- ⚠️ Para Administradores: -

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 Avanzados - -
-
-
- -

- Esta 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 - - - 👾 Crear Enemigos - - - 🗺️ Crear Áreas - - - 📊 Configurar Niveles - - - 🏪 Crear Ofertas - - - ⚖️ Sistema de Pesos - -
-
- - -
-
-

- 📦 - 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"

-
-
- • -
- Nombre: - (requerido) Nombre visible del item -
-
-
- • -
- Descripción: - Texto descriptivo del item -
-
-
- • -
- Categoría: - Agrupa items (weapons, tools, consumables, etc.) -
-
-
- • -
- Icon URL: - URL de imagen (opcional) -
-
-
- • -
- Stackable y Máx: - Formato: 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 !ayuda para ver todos los comandos
    • -
  • Revisa !cooldowns para planificar actividades
    • -
  • Consulta !player frecuentemente
    • -
  • 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. -

-
-
-
- -
-
-
- - -
-
-
-

Amayo Bot

-

Sistema completo de juego, economía y gestión para Discord

-
- -
- Primeros Pasos - • - Comandos - • - Minijuegos - • - FAQ -
- -
-

- Versión 0.11.20 • Discord.js 15.0.0-dev • Enero 2025 -

-

- Amayo © 2025 — Documentación para usuarios finales de Discord -

-
- -
- - - Volver arriba - -
-
-
-
- - - - diff --git a/src/server/public/index.html.backup b/src/server/public/index.html.backup deleted file mode 100644 index 06c5be9..0000000 --- a/src/server/public/index.html.backup +++ /dev/null @@ -1,824 +0,0 @@ - - - - - - - Amayo Bot | Guía Completa para Usuarios - - - - - - - - - -
-
-
-
-
-
-
-
-

- 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. -

-
- - Comenzar - - -
-
- - Versión 0.11.20 - - - Actualizado: Enero 2025 - - - Discord.js 15.0.0-dev - -
-
-
- -
- - -
-
- - -
-

🚀 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

-
-
-
-
- -
- 💡 Consejo: -

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

-
-
-
-
- -
- ⏰ Cooldowns: -

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,1 o 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 draws y 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 }
-  ]
-}
-
-
-
- Tip: - Usa !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, FIGHT o FARM. -
    • -
-
-
-

Modal Config (JSON)

- 
{
-  "cooldownSeconds": 60,
-  "description": "Una mina profunda",
-  "icon": "⛏️"
-}
-

El ícono se mostrará en las tarjetas generadas por DisplayComponents.

-
-
-
- Recuerda: - Si eliminas un área con !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
    • -
-
-
-
- Nota: - Usa !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.
    • -
-
-
-
- Tip: - Aprovecha la ventana de disponibilidad para crear eventos temáticos limitados. -
-
- -
-

Cofres y recompensas

-

- Configura cofres usando props chest en los items y define tablas de recompensas con pesos. -

-
-
-

Recompensas soportadas

-
    -
  • Monedas (coins)
    • -
  • Items (usa itemKey y qty)
    • -
  • Roles de Discord (roleId)
    • -
-
-
-

Consejos

-
    -
  • Usa consumeOnOpen para 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: true en 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 cooldownKey para compartir cooldown.
    • -
  • Balancea healHp y healPercent para 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 reduceToolDurability descuenta durabilityPerUse tras cada minijuego.
    • -
  • Cuando la durabilidad llega a 0, el item se elimina del inventario.
    • -
  • Si breakable.enabled es false, la herramienta es indestructible.
    • -
  • Usa tiers para bloquear áreas avanzadas. Ejemplo: Un área puede requerir una herramienta pickaxe con tier >= 2.
    • -
-
- Importante: - Después de cambiar items apilables a no apilables, recrea el item en los inventarios existentes para evitar stacks rotos. -
-
- -
-

Servicios del sistema

-
-
-

Economy Service

-
    -
  • findItemByKey y addItemByKey
    • -
  • consumeItemByKey y getInventoryEntry
    • -
  • craftByProductKey y buyFromOffer
    • -
  • findMutationByKey y applyMutationToInventory
    • -
-
-
-

Minigames Service

-
    -
  • runMinigame para ejecutar cualquier actividad.
    • -
  • runMining y runFishing como 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. -

-
-
-
-
-
-
- - -
- - - - diff --git a/src/server/public/index.html.v2.backup b/src/server/public/index.html.v2.backup deleted file mode 100644 index e68284f..0000000 --- a/src/server/public/index.html.v2.backup +++ /dev/null @@ -1,1323 +0,0 @@ - - - - - - - Amayo Bot | Guía Completa para Usuarios - - - - - - - - - -
-
-
-
-
-
-
-
-

- 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. -

-
- - Comenzar - - -
-
- - Versión 0.11.20 - - - Actualizado: Enero 2025 - - - Discord.js 15.0.0-dev - -
-
-
- -
- - -
-
- - -
-

🚀 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

-
-
-
-
- -
- 💡 Consejo: -

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

-
-
-
-
- -
- ⏰ Cooldowns: -

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

-
-
-
-
- -
- 💡 Tip: -

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)
    • -
-
-
- -
- ⚠️ Importante: -

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

-
-
-
- -
- 💡 Tip: -

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

-
    -
  1. El bot verifica si tienes los materiales necesarios en tu inventario
    2. -
  2. Si los tienes, consume los materiales
    3. -
  3. Agrega el producto crafteado a tu inventario
    4. -
  4. Te notifica el resultado
    5. -
-
-
- -
- ⚠️ Nota: -

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
    • -
-
-
- -
- ✨ Automático: -

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.

-
-
-
- -
- �� Tip: -

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:

-
-
3 días
-
7 días
-
14 días
-
30 días
-
60 días
-
90 días
-
180 días
-
365 días
-
-
-
-
- -
- ⚠️ Importante: -

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.

-
-
- -
- 💡 Estrategia: -

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. -

-
-
- -
- 💎 Rareza: -

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. -

-
-
- -
- ✨ Eventos Especiales: -

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

-
    -
  1. El bot verifica que tienes los materiales necesarios
    2. -
  2. Consume los materiales de tu inventario
    3. -
  3. Crea un trabajo de fundición con un tiempo de espera
    4. -
  4. Cuando el tiempo termina, puedes reclamar el producto
    5. -
-
-
- -
- ⏰ Gestión del Tiempo: -

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
    • -
-
-
- -
- 🌟 Powered by Gemini: -

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

-
-
-
- -
- ⚠️ Nota: -

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. -

- -
- ⚠️ Para Administradores: -

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. -

- -
-
-

📈 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 !ayuda para ver todos los comandos
    • -
  • Revisa !cooldowns para planificar actividades
    • -
  • Consulta !player frecuentemente
    • -
  • 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. -

-
-
-
- -
-
-
- - -
-
-
-

Amayo Bot

-

Sistema completo de juego, economía y gestión para Discord

-
- -
- Primeros Pasos - • - Comandos - • - Minijuegos - • - FAQ -
- -
-

- Versión 0.11.20 • Discord.js 15.0.0-dev • Enero 2025 -

-

- Amayo © 2025 — Documentación para usuarios finales de Discord -

-
- -
- - - Volver arriba - -
-
-
-
- - - -