Cómo activar widgets de Marketplace desde comandos

Un Comando Personalizado puede enviar un evento de acción a un artículo de Marketplace interactivo dentro de un diseño de Overlay Builder guardado.

Prepara el Widget

  1. Instala el paquete widget desde Marketplace.
  2. Abierto Ajustes → Sobreimpresiones → Overlay Builder.
  3. Añadir un Marketplace Item widget.
  4. Seleccione el paquete instalado y configure sus campos.
  5. Guarda el sobrevalor.
  6. Asegúrese de que el sobreimpuesto guardado —o el Master Overlay que actualmente lo muestra— está activo en su fuente del navegador.

El widget debe existir en un sobreimpuesto guardado antes de que aparezca en el selector objetivo del Constructor de Acción.

Crear el Comando

  1. Abierto Comandos de bot → Comandos.
  2. Crear un Comando Personalizado como spin o decide.
  3. Establecer permisos y enfriamientos apropiados para el efecto.
  4. Deja la respuesta normal en blanco si el widget es la respuesta completa.
  5. En el marco de las acciones, elija Overlay Widgets → Trigger Marketplace Widget.
  6. Seleccione el widget de Mercado guardado.
  7. Introduzca la acción widget documentada por su editor, como spinWheel.
  8. Agregue la carga útil opcional JSON si el widget lo soporta.
  9. Guardar y probar el comando.

Añadir Variables a la carga de pago

Las variables de comando soportadas se pueden insertar en la carga útil JSON:

{
  "viewer": "{user}",
  "message": "{message}",
  "source": "chat-command"
}

El nombre de acción exacto y los campos de carga de pago pertenecen al paquete widget. Utilice su descripción de mercado o documentación de la editorial en lugar de adivinar.

Control quién puede desencadenarlo

Utilice el permiso VIP, Moderador o Broadcaster durante las pruebas. Agregue una refrigeración global para animaciones o juegos que deben terminar antes de que otro espectador comience.

Problemas comunes

  • Widget no está del picker: Añádalo a un overlay, guarda, y luego vuelve a abrir el editor de comandos.
  • No pasa nada: Confirme el sobreimpuesto activo contiene esa instancia exacta del widget.
  • Corridas de acción incorrectas: Revise la clave de acción del editor, incluyendo la capitalización.
  • La carga de pago es ignorada: Validar el JSON y confirmar que el widget soporta esos campos.
  • Los espectadores spam el efecto: Aumente la refrigeración global del comando.
  • Paquete reporta un error: Open Marketplace Detalles del paquete e inspeccionar sus dependencias y estado de funcionamiento.