Permisos y activación
Los subcomandos de prefijo requieren Administrator y solo funcionan dentro de un servidor. El bot necesita ver y enviar mensajes en el canal; en formato embed también necesita Embed Links (Insertar enlaces).set-channel comprueba esos permisos y on no activa el módulo si falta el canal o un permiso. El evento de entrada admite nuevos miembros, incluidas cuentas bot; si Join Gate mantiene activo el estado de raid, la entrega de bienvenidas se pausa. El filtro de bots usado por los logs de entrada no desactiva por sí mismo las bienvenidas.
Hay dos controles de activación: .welcome on activa el módulo maestro después de validar el canal; .welcome off cambia el indicador heredado welcome.enabled, pero no cambia ese interruptor maestro (modules.welcome). Como la entrega consulta el interruptor del módulo, .welcome off por sí solo no garantiza que las bienvenidas se detengan. Para pausarlas realmente, desactiva Welcome en el Dashboard o usa /welcome enabled:false, que actualiza ambos controles.
.welcome off solo cambia el indicador heredado; no desactiva modules.welcome. Para pausar las entregas usa el Dashboard o /welcome enabled:false. Los saludos predeterminados nuevos están en inglés. Al leer la configuración, Headless traduce únicamente los textos predeterminados antiguos que coinciden exactamente; el contenido personalizado de cada servidor, incluido el español, se conserva..welcome set-channel
.welcome on
.welcome
.welcome off es heredado y no sustituye ese interruptor. La comprobación de .welcome set-channel también puede pedir Embed Links aunque el formato guardado sea texto, porque valida ese canal con el formato embed predeterminado.
Contenido y variables
El mensaje puede ser texto, un embed configurado o un script de embed del parser compartido. Usa welcome variables para consultar las claves disponibles; algunas pertenecen a otros eventos y pueden producir N/A. Se admiten enlaces texto, el token{link:Texto|https://...} y menciones de canal {channel:ID}. La vista previa renderiza una muestra con quien ejecutó el comando.
.welcome set-title
.welcome set-message
.welcome format
Menciones y borrado
La mención opcional del nuevo miembro se publica fuera del embed y se puede activar o desactivar conmention. El envío permite menciones de usuarios, pero bloquea @everyone, @here y menciones de roles. autodelete 0 conserva el saludo; un número positivo programa el borrado del mensaje. El Dashboard ofrece además un control separado para el borrado de la mención; ese temporizador no se configura con un subcomando de prefijo.
.welcome mention
Botones, imágenes y apariencia
El Dashboard puede guardar hasta cinco botones URL; el grupo de comandos de prefijo solo expone tres ranuras fijas: reglas, soporte y extra. En el Dashboard los botones se publican solo con etiqueta y URL HTTPS válida; los subcomandos aceptan http://, https:// o discord://. El Dashboard también expone avatar, thumbnail, banner, GIF, color, footer y un texto de autor.set-banner y set-gif aceptan URL pública o off para quitar el medio. En un embed, el GIF se usa como thumbnail salvo que haya un thumbnail personalizado; el banner ocupa la imagen principal.
.welcome set-banner
.welcome button-rules
.welcome preview
Alcance de los comandos
El grupo.welcome muestra el estado. También existe /welcome con opciones channel y enabled para consultar o cambiar el canal y la activación maestra; por ejemplo, /welcome enabled:false la desactiva. La mayoría de los ajustes de contenido se hacen con subcomandos de prefijo o desde el Dashboard.
Pasos
1
Elige un canal
Usa .welcome set-channel #bienvenida. Corrige cualquier permiso que indique el diagnóstico.
2
Redacta y personaliza
Configura título, mensaje y formato; añade medios y botones si los necesitas.
3
Prueba antes de activar
Ejecuta .welcome preview y comprueba el texto, las variables, la imagen, las menciones y los enlaces.
4
Activa o pausa el módulo
Usa
.welcome on después de validar los permisos. Para pausar entregas usa /welcome enabled:false o el control maestro del Dashboard; .welcome off no cambia ese interruptor maestro.Comandos de prefijo
Comandos de prefijo
El prefijo predeterminado es punto y puede cambiar por servidor. Comandos: .welcome; .welcome set-channel #canal; .welcome on u off; .welcome set-title texto; .welcome set-message texto; .welcome variables; .welcome format embed|text; .welcome set-banner URL|off; .welcome set-gif URL|off; .welcome mention on|off [texto]; .welcome avatar on|off; .welcome buttons on|off; .welcome button-rules URL [etiqueta]; .welcome button-support URL [etiqueta]; .welcome button-extra URL [etiqueta]; .welcome autodelete segundos; .welcome preview. Alias del grupo: .bienvenida. Alias adicionales están disponibles en varios subcomandos.
Opciones que no cambian la política de seguridad
Opciones que no cambian la política de seguridad
El comando .welcome autopin está reservado y siempre mantiene el auto-pin desactivado; no fija ni cambia mensajes. Para editar cinco botones, los campos visuales completos o el borrado separado de la mención, usa el Dashboard del servidor.
Pautas de configuración
Setup
Define el canal de bienvenida, configura mensaje y botones y prueba con welcome preview.
Diseño
Mantén un título corto, un texto claro y un botón de reglas fácil de reconocer.
Errores comunes
Revisa permisos del canal, valida la URL de reglas y acorta los mensajes que no se puedan renderizar.