Improve README formatting and add badges

Updated README to enhance formatting and add badges.
This commit is contained in:
Shni
2025-10-08 11:35:14 -05:00
committed by GitHub
parent 6e239ef18f
commit de098a3c32

379
README.MD
View File

@@ -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 📌 Amayo Bot — Guía Rápida de Comandos
Prefix: ! (puedes cambiarlo con !configuracion) Prefix: ! (puedes cambiarlo con !configuracion)
IA 🧠 IA
• !ai <mensaje> — Chatea con la IA (aliases: !chat, !gemini) • !ai <mensaje> — Chatea con la IA (aliases: !chat, !gemini)
Utilidad 🛠️ Utilidad
• !ayuda [comando|categoría] — Lista y detalles de comandos • !ayuda [comando|categoría] — Lista y detalles de comandos
Red 📡 Red
• !ping — Prueba de latencia • !ping — Prueba de latencia
Configuración (Admin) ⚙️ Configuración (Admin)
• !configuracion — Panel de ajustes del servidor • !configuracion — Panel de ajustes del servidor
Alianzas (Admin) 🤝 Alianzas (Admin)
📦 Bloques/Embeds:
• !crear-embed <nombre> — Crear bloque interactivo • !crear-embed <nombre> — Crear bloque interactivo
• !editar-embed <nombre> — Editar bloque • !editar-embed <nombre> — Editar bloque
• !lista-embeds — Ver bloques • !lista-embeds — Ver bloques
• !eliminar-embed — Eliminar bloques • !eliminar-embed — Eliminar bloques
📢 Canales:
• !canal-alianza — Configurar canal • !canal-alianza — Configurar canal
• !listar-canales-alianza — Ver configurados • !listar-canales-alianza — Ver configurados
• !eliminar-canal-alianza — Eliminar canal de la configuración • !eliminar-canal-alianza — Eliminar canal de la configuración
🎨 Demo:
• !displaydemo — Demo de componentes • !displaydemo — Demo de componentes
Slash Slash
• /ping — Pong! • /ping — Pong!
Más ayuda: !ayuda | !ayuda <comando> | !ayuda <categoría> 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>