Variables de formato
Las variables de formato permiten a April insertar valores de Discord en mensajes, embeds, URLs de imagen y campos compatibles del editor.
Variables de mensajes legacy
Sección titulada «Variables de mensajes legacy»Welcome, leaver, logs, protection messages, custom commands, managed embeds, stream monitors y levels usan variables con una sola llave cuando el editor de mensajes muestra botones de variables.
Ejemplo:
Welcome {user.mention} to {guild}. You are member {memberCount.ordinal}.Cada página expone datos diferentes. Si una variable no está disponible para esa función, April la deja sin cambios o la sustituye por un valor fallback.
Variables de usuario comunes
Sección titulada «Variables de usuario comunes»| Variable | Significado |
|---|---|
{user} | Nombre de usuario |
{user.mention} | Mención de usuario de Discord |
{user.status.color} | Color hexadecimal del estado actual del usuario |
{user.discriminator} | Discriminador de Discord cuando está disponible |
{user.avatar} | URL del avatar del usuario |
{user.avatar.rounded} | URL del avatar del usuario para plantillas de imagen |
{user.fullname} | Valor completo de nombre visible disponible para el formateador |
{user.id} | ID de usuario de Discord |
{user.created} | Fecha completa de creación del usuario |
{user.created.date} | Fecha de creación del usuario |
{user.created.ago} | Tiempo relativo desde la creación del usuario |
{user.created.time} | Hora de creación del usuario |
{user.joined} | Fecha completa de entrada al servidor |
{user.joined.date} | Fecha de entrada al servidor |
{user.joined.ago} | Tiempo relativo desde la entrada al servidor |
{user.joined.time} | Hora de entrada al servidor |
Variables de guild y channel
Sección titulada «Variables de guild y channel»| Variable | Significado |
|---|---|
{guild} | Nombre del servidor |
{memberCount} | Recuento aproximado de miembros |
{memberCount.ordinal} | Recuento de miembros como valor ordinal |
{guild.id} | ID del servidor de Discord |
{guild.created.ago} | Tiempo relativo desde la creación del servidor |
{guild.created.date} | Fecha de creación del servidor |
{guild.created.time} | Hora de creación del servidor |
{guild.icon} | URL del icono del servidor |
{channel} | Nombre del channel |
{channel.id} | ID del channel de Discord |
{channel.mention} | Mención del channel de Discord |
{channel.created} | Fecha completa de creación del channel |
{channel.created.date} | Fecha de creación del channel |
{channel.created.time} | Hora de creación del channel |
{channel.created.ago} | Tiempo relativo desde la creación del channel |
{channel.nsfw} | Si el channel está marcado como NSFW |
{channel.topic} | Tema del channel |
Variables de nivel
Sección titulada «Variables de nivel»Úsalas en mensajes de level-up, diseños de rank card y plantillas relacionadas con niveles cuando la página las ofrezca.
| Variable | Significado |
|---|---|
{user.level} | Nivel del usuario en el servidor |
{user.xp} | XP en el nivel actual |
{user.xpRatio} | Progreso del nivel actual de 0 a 1 |
{user.nextLevel} | XP requerida para el siguiente nivel |
{user.totalXp} | XP total acumulada |
Variables de log
Sección titulada «Variables de log»Los eventos de log pueden exponer valores before/after cuando Discord envía ambos estados.
| Variable | Significado |
|---|---|
{before.user} | Nombre de usuario anterior |
{before.user.nickname} | Apodo anterior del servidor |
{before.user.avatar} | URL de avatar anterior |
{before.user.fullname} | Valor completo de usuario anterior |
{after.user} | Nombre de usuario actualizado |
{after.user.nickname} | Apodo actualizado del servidor |
{after.user.avatar} | URL de avatar actualizada |
{after.user.fullname} | Valor completo de usuario actualizado |
{before.channel} | Nombre anterior del channel |
{before.channel.id} | ID anterior del channel |
{before.channel.nsfw} | Estado NSFW anterior |
{before.channel.topic} | Tema anterior del channel |
{after.channel} | Nombre actualizado del channel |
{after.channel.id} | ID actualizado del channel |
{after.channel.nsfw} | Estado NSFW actualizado |
{after.channel.topic} | Tema actualizado del channel |
Algunos eventos de log también añaden valores específicos del evento, como contenido del mensaje o roles cambiados. Usa los botones de variables mostrados en la página de configuración de ese evento.
Variables de stream monitor
Sección titulada «Variables de stream monitor»Las notificaciones de Twitch pueden usar:
| Variable | Significado |
|---|---|
{stream.channel} | Nombre visible del streamer |
{stream.avatarUrl} | URL del avatar del streamer |
{stream.url} | URL del canal de Twitch |
{stream.viewerCount} | Número de espectadores |
{stream.started.ago} | Hora relativa de inicio del stream |
{stream.type} | Tipo de stream |
{stream.length} | Duración del stream |
{stream.title} | Título del stream |
{stream.preview} | URL de miniatura del stream |
{stream.game} | Juego o categoría |
Las notificaciones de YouTube pueden usar {stream.channel.name}, {stream.channel}, {stream.url}, {stream.started.ago} y {stream.title}.
Valores aleatorios
Sección titulada «Valores aleatorios»Las custom commands y otras plantillas de mensaje legacy pueden usar variables de números aleatorios:
{random}{random.1-100}{random} devuelve un valor de 0 a 10. {random.1-100} devuelve un valor dentro del rango configurado.
Variables del espacio de trabajo del editor
Sección titulada «Variables del espacio de trabajo del editor»Los bindings de Editor V2 usan en su lugar sintaxis de salida estilo Liquid:
| Variable | Ejemplo de uso |
|---|---|
{{ user }} | Renderizar el usuario seleccionado en texto |
{{ guild }} | Renderizar el nombre del servidor en texto |
{{ channel }} | Renderizar un valor de channel en texto |
Los bindings de Editor V2 se configuran desde el inspector del workspace. Los valores de una sola llave como {user} no son válidos en bindings de Editor V2.
Valores de URL
Sección titulada «Valores de URL»Las variables de imagen e icono deben resolverse a URLs válidas. Por ejemplo, {user.avatar}, {guild.icon} y {stream.preview} son adecuadas para campos de URL de imagen cuando la función las admite.