Crea un comando personalizado con Nekotina

Los comandos personalizados permiten que Nekotina responda a palabras activadoras propias de tu servidor con mensajes, embeds, acciones de roles y más.

En esta guía crearás felizcumple, un comando para felicitar el cumpleaños de otro miembro con un embed y un GIF.

Si el prefijo de tu servidor es ! (el predeterminado de Nekotina), el uso quedará así:

!felizcumple @Kwee

En el ejemplo, Gwee ejecuta el comando y Kwee es quien recibe la felicitación.

Para tus miembros

Cualquier miembro con permiso en el canal puede usar !nombreDelComando (o el prefijo de tu servidor). En este ejemplo:

!felizcumple @Usuario

No sustituye al módulo nativo de cumpleaños, que anuncia solo cada día sin que nadie ejecute un comando.

Requisitos previos

Antes de empezar, asegúrate de que:

1. Tienes acceso al dashboard de Nekotina con permisos de administrador en el servidor.
2. Conoces el prefijo de comandos de tu servidor (por defecto ! en Nekotina; también puede ser -, ?, etc.).
3. Nekotina puede enviar mensajes y insertar enlaces en el canal donde probarás el comando.
4. Tienes un GIF listo para subir (formato GIF, PNG, JPG o WEBP).

Así se verá la respuesta final cuando Gwee felicite a Kwee:

Paso 1 — Crear el comando

1. Entra al dashboard y selecciona tu servidor.
2. Ve a Utilidades → Comandos personalizados.
3. Pulsa Crear comando y elige Desde cero.
4. En el paso Comando, escribe la palabra activadora:

felizcumple

5. Añade una descripción opcional, por ejemplo: Felicita el cumpleaños de un miembro del servidor.
6. Puedes usar el modo básico del editor; es suficiente para este tutorial.

Paso 2 — Añadir el argumento de miembro

El comando necesita saber a quién felicitar. Añade un argumento de tipo Miembro:

1. En el paso Argumentos (modo avanzado) o durante la configuración del comando, pulsa Añadir argumento.
2. Configura el argumento:

Cómo funcionan los argumentos en los mensajes

Cuando alguien escribe !felizcumple @Kwee, Discord separa el comando en partes:

Nekotina no adivina a quién te refieres: tú defines qué dato espera el comando (un miembro, un número, un texto…) y el usuario lo escribe después del nombre. Ese dato queda guardado bajo el nombre que le diste al argumento.

Para usar ese valor dentro del mensaje o del embed, escribe una variable con este formato:

{{arg.nombre-del-argumento}}

En nuestro caso el argumento se llama destinatario, así que la variable es:

{{arg.destinatario}}

Reglas importantes:

• El texto después de arg. debe coincidir exactamente con el nombre del argumento. Si lo llamaste destinatario, escribe {{arg.destinatario}}; si lo llamas cumpleanero, sería {{arg.cumpleanero}}.
• Si el nombre no coincide, Nekotina no podrá sustituir la variable y el mensaje mostrará el texto literal o fallará.
• Los argumentos de tipo Miembro se pueden usar como mención (@Kwee) o, con otras variables, como avatar ({{arg.destinatario.avatar}}).
• Si añades más de un argumento, van en el orden en que los configuraste. Por ejemplo, !felizcumple @Kwee entrega el primer argumento; un segundo argumento iría después.

Ejemplo de encaje entre configuración y mensaje:

Cuando Gwee ejecute !felizcumple @Kwee, Nekotina reemplazará:

• {{user.mention}} → la mención de Gwee (quien escribió el comando)
• {{arg.destinatario}} → la mención de Kwee (el miembro que Gwee indicó)

Uso en Discord:

!felizcumple @Kwee

Paso 3 — Configurar la acción Enviar mensaje

1. Ve al paso Acciones.
2. Añade una acción de tipo Enviar mensaje (responde en el mismo canal donde se usó el comando).
3. Pulsa Añadir al mensaje y selecciona Embeds.

Así se verá el embed antes de añadir el GIF:

Paso 4 — Configurar el embed

En el editor de embeds, rellena los campos principales:

Variables útiles:

En Ajustes del mensaje, activa Menciones de usuarios para que Discord resuelva correctamente las menciones del embed.

Paso 5 — Acceso y enfriamiento (opcional)

En el paso Acceso puedes afinar quién usa el comando y con qué frecuencia:

Si no configuras restricciones, cualquier miembro podrá usar el comando en cualquier canal permitido por el bot.

Paso 6 — Guardar y probar

1. Revisa el paso Resumen del editor.
2. Pulsa Guardar.
3. En Discord, escribe el comando con un miembro real:

!felizcumple @Kwee

Nekotina publicará el embed con el GIF en el canal. Si Gwee es quien lo ejecuta, la descripción mostrará su mención junto a la de Kwee.

Límites a tener en cuenta

Con Premium puedes encadenar varias acciones (por ejemplo, dar un rol de cumpleañero además del mensaje). En el plan gratuito basta con la acción Enviar mensaje para este tutorial.

Consejos

• Usa un GIF optimizado (poco peso) para que cargue rápido en Discord.
• El nombre del argumento (destinatario) debe coincidir con lo que escribes en {{arg.destinatario}}.
• No incluyas el prefijo en la palabra activadora: escribe felizcumple, no !felizcumple.
• Puedes duplicar el comando y cambiar el GIF para variantes como felizcumple-vip o feliz-cumple.

Problemas frecuentes

Ir más allá

Si activas el modo avanzado, puedes añadir varios embeds y elegir el modo Enviar un embed aleatorio para que Nekotina muestre una felicitación distinta cada vez (similar a la plantilla Consuelo del dashboard). También puedes usar variables calculadas para elegir frases al azar.

Resumen del flujo

1. Crear comando → Palabra activadora felizcumple
2. Añadir argumento → destinatario (Miembro)
3. Acción → Enviar mensaje con embed
4. Embed → Descripción con variables + color + GIF
5. Guardar → Probar con !felizcumple @Kwee

¡Listo! Ya tienes un comando de cumpleaños personalizado en tu servidor con Nekotina.