La capacidad de saludo recibe a la gente en un canal. Una bienvenida tiene dos mitades con públicos distintos: una línea corta que lee toda la sala, y las líneas privadas que orientan al recién llegado sin que nadie más las vea.
Las dos mitades
| Ajuste | Quién lo lee | Cuándo |
|---|---|---|
public_greeting |
Todos los del canal | Solo la primera vez que este bot se encuentra con este apodo aquí |
greeting |
Solo el recién llegado | En cada entrada que la ventana de repetición permita |
onboarding_1 … onboarding_4
|
Solo el recién llegado | En cada entrada que la ventana de repetición permita |
farewell |
Depende de farewell_delivery | Al salir |
Cómo definirlas
/bot set <name> public_greeting <text>\n/bot set <name> greeting <text>\n/bot set <name> onboarding_1 <text>\n/bot set <name> onboarding_2 <text>\n/bot set <name> greeting_delivery private_notice\n/bot set <name> onboarding_delivery private_notice\n/bot set <name> greeter_repeat_window 43200\n/bot set <name> farewell none
Cualquiera de ellas acepta none para borrarla. Una línea borrada se omite, así que un bot con solo un saludo se comporta exactamente como siempre. Las líneas de bienvenida están numeradas en vez de acumularse: definir onboarding_2 dos veces la reemplaza, y eso es lo que permite pegar un script de aprovisionamiento más de una vez.
Entrega
| Modo | Efecto |
|---|---|
public |
Un mensaje en el canal. Se guarda en el historial. |
channel_notice |
Un aviso en el canal. Se guarda en el historial. |
private_notice |
Un aviso que solo ve el recién llegado, en la vista de ese canal. No se guarda en el historial. |
silent |
No se envía nada. |
greeting_delivery cubre el saludo; onboarding_delivery cubre las líneas numeradas y recurre a greeting_delivery cuando no está definido. public_greeting siempre es público: para eso está.
Quién cuenta como nuevo
El bot registra a quién ha recibido en cada canal, y ese registro sobrevive a un reinicio. Quien nunca ha conocido recibe la línea pública y las privadas. Quien conoció hace más de greeter_repeat_window segundos recibe las privadas otra vez, pero a la sala no se le dice dos veces. Quien acaba de estar aquí no recibe nada.
Una ventana de repetición de 0 significa que no hay ventana: las líneas privadas salen en cada entrada. La línea pública sigue saliendo una vez por persona, para siempre.
Marcadores
Cada línea acepta {nickname} para quien entró, {channel} para la sala, {botname} para el bot y {prefix} para su prefijo de comandos. Las líneas también aceptan los escapes de formato IRC: \c04 rojo, \b negrita, \o reset.
Mantener la sala legible
Solo un bot por canal debería saludar. Dos saludadores dan la bienvenida a cada recién llegado dos veces, y por eso un bot que está en todas las salas lleva greeting none. Mantén la línea pública en una frase: es la única parte de una bienvenida que lee toda la sala y la única que persiste. Todo lo que un recién llegado necesita aprender va en la mitad privada.
