amayo/README.MD

# Amayo Bot — Guía de Comandos para Discord

Bienvenido/a. Aquí tienes una guía lista para pegar en tu servidor de Discord con todos los comandos disponibles y lo que hacen.

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

## Comandos por categoría

### IA
- `!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
- `!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)
- `!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
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.

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

### Slash commands
- `/ping`
  - Qué hace: Responde con “pong!” (prueba rápida de slash).

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

## Bloque listo para copiar y pegar en tu server

Copia todo 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
• !ai <mensaje> — Chatea con la IA (aliases: !chat, !gemini)

Utilidad
• !ayuda [comando|categoría] — Lista y detalles de comandos

Red
• !ping — Prueba de latencia

Configuración (Admin)
• !configuracion — Panel de ajustes del servidor

Alianzas (Admin)
• !crear-embed <nombre> — Crear bloque interactivo
• !editar-embed <nombre> — Editar bloque
• !lista-embeds — Ver bloques
• !eliminar-embed — Eliminar bloques
• !canal-alianza — Configurar canal
• !listar-canales-alianza — Ver configurados
• !eliminar-canal-alianza — Eliminar canal de la configuración
• !displaydemo — Demo de componentes

Slash
• /ping — Pong!

Más ayuda: !ayuda | !ayuda <comando> | !ayuda <categoría>
```