01La anatomía de un comando
Un comando personalizado es una pregunta que tus espectadores pueden hacer
(!abrazo) y la respuesta que da tu bot. El editor tiene ocho campos;
solo el nombre y la respuesta son obligatorios.
- 01 Nombre: lo que los espectadores escriben después del «!». En minúsculas, una sola palabra.
- 02 Nombres alternativos: activadores extra para el mismo comando (!abrazo y !abrazos pueden funcionar igual).
- 03 Respuesta: lo que dice el bot. Hasta 5 líneas; cada línea es su propio mensaje del chat.
- 04 El ensayo del chat reproduce tu respuesta con valores de ejemplo antes de guardar. El constructor de comandos tiene el mismo.
- 05 Acceso y tiempos de espera: quién puede usarlo, cuánto espera todo el mundo después de cada uso y cuánto espera cada espectador entre sus propios usos.
- 06 Solo durante el directo pausa el comando cuando no estás en directo; Activo es el interruptor general.
- 07 Fuente de datos: inserta un valor obtenido de una de tus fuentes de datos, en lugar de una variable.
{urlfetch:name}, un valor
tomado de una fuente de datos que tú mismo guardaste. La
guía de fuentes de datos explica cómo guardar la primera.02Dos formas de crear uno
Desde el panel
En Comandos, pulsa Nuevo comando, completa el nombre y la respuesta, y luego Crear. Responde en el chat normalmente en unos segundos. Editarlo funciona igual: haz clic en un comando, cámbialo y guarda.
Desde el chat, con !cmd
Tú y tus moderadores también pueden gestionar comandos sin salir del chat, en pleno
directo. Cualquier moderador puede usarlo: !cmd no exige el rol de moderador principal que sí piden otros comandos integrados.
⚔ Ayshacinder !cmd add hype ¡NO NOS RENDIMOS! 🎉
ItsBagelBot @Ayshacinder el comando hype se ha añadido
SnackPackPanda !hype
ItsBagelBot ¡NO NOS RENDIMOS! 🎉
!cmd add <nombre> <respuesta>crea un comando.!cmd edit <nombre> <respuesta>reemplaza su respuesta.!cmd remove <nombre>lo elimina.
03Variables: la parte inteligente
Escribe {user} en una respuesta, y el bot lo reemplaza por el nombre de
quien lanzó el comando. Eso es una variable: un marcador que el bot rellena en el momento
en que responde. Cada variable que entiende, con su sintaxis exacta y un ejemplo concreto,
está en la referencia de variables.
Añade una barra vertical seguida de un texto dentro de las llaves para darle a una variable
algo que decir cuando llega vacía: hug {touser|todo el mundo}
abraza a la persona nombrada, o a todo el mundo cuando nadie es nombrado.
SnackPackPanda !hug
ItsBagelBot SnackPackPanda le da un gran abrazo de bagel a todo el mundo 🥯
SnackPackPanda !hug MikanMeerkat
ItsBagelBot SnackPackPanda le da un gran abrazo de bagel a MikanMeerkat 🥯
04Varias líneas y acciones del chat
Una respuesta puede tener hasta 5 líneas, y cada línea se envía como mensaje propio, de arriba abajo. Y una línea que empieza por uno de estos comandos se convierte en una acción nativa de Twitch en lugar de un mensaje normal:
| La línea empieza por | Lo que ocurre |
|---|---|
/me | Mensaje de «acción» en cursiva, al estilo clásico de IRC. |
/announce | Un anuncio destacado de Twitch. Variantes de color: /announceblue, /announcegreen, /announceorange, /announcepurple. |
/shoutout | Un shoutout nativo de Twitch para el primer nombre de la línea. |
/pin | Envía el mensaje y lo fija hasta el final del directo. |
SnackPackPanda !sorteo
anuncio · ¡El sorteo ha COMENZADO! Escribe !enter para participar.
ItsBagelBot El ganador se elige a la hora en punto. ¡Mucha suerte! 🍀
{args},
{touser}) se limpia antes de llegar al mensaje: nadie
puede colar un /ban o un /timeout en la salida de tu comando.05Las reglas del juego
El editor revisa todo esto por ti y te dice qué falla con palabras sencillas. Como referencia:
| Campo | La regla |
|---|---|
| Nombre | De 1 a 64 caracteres, sin espacios y sin el «!» (el chat lo añade). Se guarda en minúsculas: !Abrazo y !abrazo son el mismo comando. |
| Nombres alternativos | Hasta 25, cada uno con las mismas reglas que el nombre. |
| Respuesta | Hasta 5 líneas de 500 caracteres cada una (un mensaje de chat por línea). |
| Tiempo de espera común | De 0 a 86400 segundos. Se comparte con todo el chat: después de un uso, todo el mundo espera. 0 lo desactiva. |
| Tiempo de espera por espectador | De 0 a 86400 segundos. Cada espectador espera ese tiempo entre sus propios usos; los demás aún pueden usarlo una vez transcurrido el tiempo de espera común. Los nombres alternativos cuentan como el mismo comando. 0 lo desactiva. |
| Acceso | Rango mínimo, en este orden: todos, suscriptores, VIP, moderadores, moderadores principales, streamer. Cada nivel incluye a los que están por encima. |
| Restringir a un ID de usuario | Bloquea un comando a una sola cuenta de Twitch; reemplaza por completo el nivel de acceso. Ideal para el comando personal de un amigo. El campo solo acepta números: el ID de usuario de Twitch, no el nombre de usuario. Para encontrar un ID, usa un buscador de ID de usuario de Twitch en el que confíes, o una herramienta de moderación que muestre los ID de usuario. |
06Evita escribir: el constructor
Toda esta guía está integrada en el constructor de comandos: elige las variables de una lista explicada en lugar de memorizarlas, mira un ensayo del chat en directo mientras escribes y, cuando todo suene bien, envía el comando a tu panel, donde una confirmación lo crea con un clic. Es el camino más corto entre la idea y el comando que funciona.