shni/amayo
Template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improve README formatting and add badges

Browse Source 
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
1 changed files with 294 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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`)
- Ayuda en Discord: `!ayuda`, `!ayuda <comando>`, `!ayuda <categoría>`
- 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 <mensaje>`
- Aliases: `!chat`, `!gemini`
- Qué hace: Chatea con la IA (Gemini) directamente desde Discord.
- Ejemplo: `!ai ¿Cómo funciona JavaScript?`
</div>
### 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 <nombre>`
- Aliases: `!embed-crear`, `!nuevo-embed`, `!blockcreatev2`
- Qué hace: Crea un bloque/embedded nuevo con editor interactivo.
- Permisos: Administrador.
- `!editar-embed <nombre>`
- 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 <mensaje>`
> **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 <comando>` 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
<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>