Merge pull request #7 from Shnimlz/Shnimlz-patch-3

Improve README formatting and add badges

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)
+<div align="center">
 
-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`)
+**Tu asistente definitivo para Discord con IA integrada** ⚡
-- Ayuda en Discord: `!ayuda`, `!ayuda <comando>`, `!ayuda <categoría>`
-- Algunos comandos requieren permisos de Administrador; están marcados.
 
-## Comandos por categoría
+[![Prefix](https://img.shields.io/badge/Prefix-!-success?style=for-the-badge)](https://github.com)
 
-### IA
+</div>
-- `!ai <mensaje>`
-  - 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
+> 📝 **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)
-- `!ping`
-  - Aliases: `!latency`, `!pong`
-  - Qué hace: Verifica la latencia y que el bot esté respondiendo.
 
-### 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)
+## 📚 Tabla de Contenidos
-- `!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.
 
-### Alianzas (Gestión de bloques y canales) — Admin
+- [🧠 Inteligencia Artificial](#-inteligencia-artificial)
-Bloques (presentaciones/embeds avanzados con Display Components):
+- [🛠️ Utilidad](#️-utilidad)
-- `!crear-embed <nombre>`
+- [📡 Red](#-red)
-  - Aliases: `!embed-crear`, `!nuevo-embed`, `!blockcreatev2`
+- [⚙️ Configuración](#️-configuración)
-  - Qué hace: Crea un bloque/embedded nuevo con editor interactivo.
+- [👑 Administración](#-administración)
-  - Permisos: Administrador.
+- [🤝 Alianzas](#-alianzas)
-- `!editar-embed <nombre>`
+  - [📦 Gestión de Bloques/Embeds](#-gestión-de-bloquesembeds)
-  - Aliases: `!embed-editar`, `!modificar-embed`, `!blockeditv2`
+  - [📢 Canales de Alianza](#-canales-de-alianza)
-  - Qué hace: Edita un bloque/embedded existente con herramientas interactivas.
+  - [🎨 Demostración](#-demostración)
-  - Permisos: Administrador.
+- [⚡ Slash Commands](#-slash-commands)
-- `!lista-embeds`
+- [💡 Consejos Rápidos](#-consejos-rápidos)
-  - Aliases: `!embeds`, `!ver-embeds`, `!embedlist`
+- [📋 Bloque para tu Servidor](#-bloque-para-tu-servidor)
-  - 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.
 
-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:
+## 🧠 Inteligencia Artificial
-- `!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).
 
-### Slash commands
+### `!ai <mensaje>`
-- `/ping`
+> **Aliases:** `!chat`, `!gemini`
-  - Qué hace: Responde con “pong!” (prueba rápida de slash).
 
-## Consejos rápidos
+💬 Chatea con la IA (Gemini) directamente desde Discord. Pregunta lo que quieras, desde programación hasta consejos generales.
-- ¿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 <comando>` para ver el uso correcto.
 
-## 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
+
+<table>
+<tr>
+<td width="30%"><b>Comando</b></td>
+<td width="70%"><b>Descripción</b></td>
+</tr>
+
+<tr>
+<td>
+
+**`!crear-embed <nombre>`**
+
+*Aliases:* `!embed-crear`, `!nuevo-embed`, `!blockcreatev2`
+
+</td>
+<td>
+
+✨ Crea un bloque/embedded nuevo con editor interactivo avanzado y Display Components.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+**`!editar-embed <nombre>`**
+
+*Aliases:* `!embed-editar`, `!modificar-embed`, `!blockeditv2`
+
+</td>
+<td>
+
+✏️ Edita un bloque/embedded existente con herramientas interactivas completas.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+**`!lista-embeds`**
+
+*Aliases:* `!embeds`, `!ver-embeds`, `!embedlist`
+
+</td>
+<td>
+
+📋 Lista todos los bloques existentes con paginación y acciones rápidas.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+**`!eliminar-embed`**
+
+*Aliases:* `!embed-eliminar`, `!borrar-embed`, `!embeddelete`
+
+</td>
+<td>
+
+🗑️ Panel interactivo para eliminar bloques de forma segura.
+
+</td>
+</tr>
+
+</table>
+
+### 📢 Canales de Alianza
+
+<table>
+<tr>
+<td width="30%"><b>Comando</b></td>
+<td width="70%"><b>Descripción</b></td>
+</tr>
+
+<tr>
+<td>
+
+**`!canal-alianza`**
+
+*Aliases:* `!alchannel`, `!channelally`
+
+</td>
+<td>
+
+🎯 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.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+**`!listar-canales-alianza`**
+
+*Aliases:* `!listchannels-alliance`, `!listalchannel`, `!channelsally`, `!alliancechannels`
+
+</td>
+<td>
+
+📊 Muestra todos los canales de alianza configurados con estado y estadísticas detalladas.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+**`!eliminar-canal-alianza`**
+
+*Aliases:* `!removechannel-alliance`, `!removealchannel`, `!delalchannel`
+
+</td>
+<td>
+
+❌ Elimina la configuración de alianza de un canal seleccionado (mantiene el historial).
+
+</td>
+</tr>
+
+</table>
+
+### 🎨 Demostración
+
+| Comando | Descripción |
+|---------|-------------|
+| **`!displaydemo`**<br>*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
+
+<details>
+<summary><b>¿Olvidaste el prefix?</b></summary>
+
+Usa `@mencionar_al_bot ayuda` o prueba `!ayuda`
+
+</details>
+
+<details>
+<summary><b>¿Un comando no funciona?</b></summary>
+
+- ✅ Puede requerir permisos de Administrador o ser exclusivo del dueño
+- ✅ Asegúrate de usarlo en un canal de texto compatible
+- ✅ Escribe `!ayuda <comando>` para ver el uso correcto
+
+</details>
+
+<details>
+<summary><b>¿Necesitas ayuda específica?</b></summary>
+
+Usa `!ayuda <categoría>` para filtrar por tipo de comando
+
+**Categorías disponibles:**
+- `IA`
+- `Utilidad`
+- `Red`
+- `Configuración`
+- `Administración`
+- `Alianzas`
+
+</details>
+
+---
+
+## 📋 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 <mensaje> — 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 <nombre> — Crear bloque interactivo
 • !editar-embed <nombre> — 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 <comando> | !ayuda <categoría>
 ```
+
+---
+
+<div align="center">
+
+### ⚡ 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)
+
+</div>