Estructura
Comienza con{embed}$v y separa cada bloque con $v. El parser admite también espacios o saltos de línea después del prefijo. Cada bloque usa {clave: valor}; las claves se procesan como datos y nunca como código. Si no usas {embed}$v, Headless conserva el formato de texto plano de ese módulo.
Dónde se usa
El mismo parser se usa en los mensajes de bienvenida, avisos de nivel, anuncios de Booster Roles, respuestas automáticas, apertura de tickets y mensajes personalizados de moderación. No existe un mensaje de salida configurable. Cada módulo aporta sus propias variables: una clave reconocida sin valor en el evento actual se muestra comoN/A. Welcome y Booster Roles tienen vistas previas; Auto Responder valida la plantilla antes de guardarla. Usa la prueba del módulo cuando exista: una vista previa no sustituye la validación al enviar.
Propiedades y sintaxis
Se admitenmessage y content (alias), title, description, url, color, image, thumbnail, timestamp, author, field, footer y button. author usa nombre && [icono HTTPS] && [URL HTTPS]; field usa nombre && valor [&& inline|true|false|yes|no|on|off]; footer usa texto [&& icono HTTPS]. Un botón admite URL && etiqueta o Link|URL && etiqueta && URL && enabled|disabled; disabled desactiva el enlace y ningún botón ejecuta acciones del bot.
Embed template
Los botones de plantilla solo son enlaces web; no pueden reclamar, cerrar, dar roles ni ejecutar otra acción del bot.
message/content se envían como texto normal junto al embed, y url establece el enlace del título.
Límites y validación
title: 256 caracteres; description: 4.096; message/content: 2.000; nombre de campo: 256; valor de campo: 1.024; author: 256; footer: 2.048; etiqueta de botón: 80. Se permiten hasta 25 campos y 5 botones. El texto combinado de título, descripción, autor, footer y campos no puede superar 6.000 caracteres. URLs del embed, imagen, thumbnail e iconos admiten hasta 2.048 caracteres y requieren HTTPS; se rechazan URLs con credenciales. Un botón acepta HTTP o HTTPS y hasta 512 caracteres. El color acepta 3 o 6 dígitos hexadecimales, con # opcional. timestamp no acepta argumento.
Salida válida
Un embed requiere contenido visible (título, descripción, campo, autor, footer, imagen o thumbnail).message/content por sí solos envían texto normal sin embed; una plantilla solo de botón también puede enviar el botón sin un embed vacío. url establece el enlace del título. Propiedades desconocidas, variables desconocidas, valores vacíos, separadores incompletos, URL inválidas o límites excedidos detienen el envío con un error de validación.
Pasos
1
Elige el módulo
Abre la configuración de Welcome, niveles, Booster Roles, Auto Responder, Tickets o mensajes de moderación donde quieras usar la plantilla.
2
Escribe una plantilla
Usa el prefijo y separador exactos; añade cada propiedad como un bloque entre llaves. Para poner texto fuera del embed usa
message o su alias content.3
Valida el resultado
Usa la vista previa o prueba del módulo cuando exista. Corrige las variables que aparezcan como
N/A y cualquier error de URL o límites antes de guardar.