diff --git a/README.MD b/README.MD index 2c823d4..5ca8a0e 100644 --- a/README.MD +++ b/README.MD @@ -1,127 +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 -- ¿No recuerdas el prefix? Usa `@mencionar_al_bot ayuda` o prueba `!ayuda`. -- ¿No te funciona un comando? - - 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: ``` 📌 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) + +