Primeros pasos

BonkyMonky tiene tres partes que hablan entre sí: la app, una fuente de navegador en OBS que dibuja los objetos, y VTube Studio, que mueve tu modelo al recibir el golpe.

Necesitas

Windows, una cuenta de Twitch, OBS y VTube Studio

Tiempo

Unos diez minutos, una sola vez

Después

Se actualiza sola y tu sesión se renueva sola

La guía nombra los botones en inglés, como aparecen en la app. Si tu Windows está en español, los verás traducidos.

1. Descarga la appEn la página de versiones baja BonkyMonky-Setup.exe para instalarla, o el .zip si prefieres una copia portátil. Las dos se actualizan solas.
2. Inicia sesión con TwitchPulsa Log in abajo en la barra lateral. Twitch se abre en tu navegador: apruébalo, usando el código que te muestra la app si te lo pide.
3. Enciende la API de VTube StudioEn VTube Studio abre los ajustes y activa Start API. Deja el puerto en 8001. La primera vez que BonkyMonky se conecte, VTube Studio te pedirá permiso: pulsa Allow.
4. Agrega la fuente a OBSCrea una fuente de navegador y marca Local file. Elige bonker.html: en Settings › Updates › Copy Path está la ruta exacta, que no cambia al actualizar. Ponle el tamaño de tu lienzo, normalmente 1920 × 1080, y colócala encima de la captura de VTube Studio.
5. CalibraEn Throws pulsa Calibrate y luego Start calibration. VTube Studio encoge tu modelo. Muévelo hasta que su cara quede bajo la guía redonda que se ve en OBS y continúa. Repite a tamaño completo y confirma. Ahora los objetos apuntan a la cara a cualquier tamaño.

Comprueba que funciona

La barra de arriba muestra cada conexión: un punto verde es que está conectada. Pulsa Test en la barra lateral y lanza algo. Debería verse en OBS y mover tu modelo.

Para mover la guía de calibración, haz clic derecho en la fuente de OBS, elige Interact y pulsa donde está la cara.

Qué sigue

• Elige qué lanza los objetos en tu canal.
• Agrega tus propios objetos y sonidos.
• ¿Algo no conecta? Ve a Si algo falla.

Pedir acceso a la prueba

Avatares, check-in, puntos y créditos están en prueba cerrada con un grupo pequeño de canales. Se aprueba a mano, canal por canal.

Escríbenos a contacto@ayanogroup.com con esto:

• El nombre de tu canal de Twitch.
• Qué quieres probar: avatares, check-in, puntos o créditos.

Cuando te avisemos

1. ConéctateEn la app, con tu sesión de Twitch iniciada: Settings › Advanced › BonkyMonky Cloud › Connect. No pide otra aprobación.
2. ListoAvatares, Puntos y Credits se abren en el momento.

Mientras tanto

Bonks, escenas, acciones, ruletas, accesorios y atuendos funcionan sin acceso. Si tu canal no está en la lista, al pulsar Connect la app te lo dice y te muestra un botón que trae aquí.

Cómo funciona el acceso

• La app confirma tu acceso al abrir y cada hora.
• Si nuestro servidor se cae, todo sigue funcionando hasta 14 días. Una caída nuestra no le pega a tu directo.
• Si desconectas la nube, lo que está en prueba se cierra al momento. Tu configuración se conserva y vuelve al conectarte.

Si vienes de otra versión

BonkyMonky ahora tiene su propio inicio de sesión de Twitch. Hay que hacer dos cosas, una sola vez.

1. Inicia sesión otra vezLa app te lo pide al abrir. Apruebas en Twitch y listo.
2. Rehaz tus recompensas de canalTwitch solo deja cambiar una recompensa a la app que la creó. Las que hizo BonkyMonky con el inicio de sesión anterior ya no se pueden ocultar ni reembolsar. Bórralas en Twitch y vuelve a guardarlas desde su escena. Al abrir esa escena, la app te avisa.

Cómo se actualiza

La app busca versiones nuevas al abrir y cada 6 horas, y las descarga en segundo plano. Cuando hay una lista aparece Restart to update a la izquierda. Reinicia, o simplemente cierra la app y se actualiza al salir. Tus ajustes, objetos y sonidos se conservan.

En Settings › Updates ves tu versión y un botón Check Now. Una copia portátil en una carpeta de solo lectura, como Archivos de programa, no puede reemplazarse sola y te da el enlace de descarga.

Objetos y sonidos

Los objetos son las imágenes que tus viewers lanzan. Vienen algunos con la app y puedes agregar los tuyos.

Dónde

Throws

Se hace solo

La app elige al azar entre los que tengas marcados

Viene listo

Objetos y sonidos de impacto

Agregar y elegir

1. Abre ThrowsAgrega tus imágenes y desmarca las que no quieras.
2. Abre el engrane de un objetoAhí está todo lo suyo.
3. PruébaloCon Test en la barra lateral.

Lo que ajusta cada objeto

La pestaña Bits define la imagen y el tamaño de cada nivel de bits. Sounds guarda los impactos al azar, con otra pestaña para los cheers.

Bonks personalizados

Un bonk personalizado es una receta de lanzamiento que puedes asignar a cualquier canje, comando o evento. Cada uno puede cambiar la cantidad, el ritmo, la duración, el giro, el ángulo y la dirección. También puede usar sus propios objetos y sonidos, marcas que se quedan donde pegó, y un sonido de preparación antes de lanzar.

Cómo se ven los lanzamientos

• Barrage Pattern: Classic usa tus ángulos, Rain cae desde arriba, Shotgun dispara ráfagas de 3 a 5, Alternate cambia de lado y Spiral barre por encima. Random elige uno por ráfaga.
• Throw Variance: cambia distancia, arco, velocidad y dónde caen. En 0 todos siguen el mismo camino.
• Sticky Items: se quedan unos segundos sobre el modelo, lo siguen y luego caen.
• Bounce Off the Model: en Settings › Physics Simulation. Los objetos rebotan en el contorno de tu modelo en vez de atravesarlo.

Eventos

Aquí decides qué lanza objetos en tu canal. Cada evento tiene su propia pestaña en Events.

Dónde

Throws › Events

Se hace solo

Sí: cuando pasa, lanza. Sin nada más que hacer

Necesitas

Tu sesión de Twitch iniciada

Probar sin directo

Test en la barra lateral tiene el Event Simulator: follows, bits, subs, raids, canjes y mensajes falsos que pasan por las mismas reglas que los reales. Event Storm dispara 20 eventos al azar en 10 segundos.

Contador y medidor de hype

La fuente de OBS puede mostrar un contador de bonks y un medidor de hype. Cada golpe lo llena, un bit jefe lo llena diez veces, y se vacía despacio. Lleno, aparece HYPE! y se lanza el Hype Bonk. Ajusta colores, letra, textos y posición en Settings › Overlay Style, con presets o a tu gusto. Follow Model lo mantiene junto a la cabeza de tu modelo.

Reacciones del modelo

En Settings › Model Reactions pulsa Load from VTS y elige qué pasa en un combo, con un bit jefe, cuando el hype se llena o al azar. Las expresiones se apagan solas después del tiempo que pongas.

Accesorios

Imágenes que tus viewers le ponen a tu modelo: un sombrero, unos lentes, una calcomanía. Se mueven y giran con él, y se quitan solos.

Dónde

Accessories

Se hace solo

Se ponen y se quitan solos al terminar su tiempo

Viene listo

El Viewer badge, con la foto y el nombre de quien lo activó

1. Agrega imágenesPNG, JPG o GIF. Si están fuera de 64 a 2048 píxeles, la app las ajusta.
2. Elige dóndeEn cualquier parte, en las partes que marques, o en un punto exacto. Para las dos últimas pulsa Choose in VTS y marca en VTube Studio en menos de un minuto.
3. PruébaloPulsa Put on model. La primera vez, VTube Studio te pide permitir cargar imágenes como objetos: acéptalo.
4. AsígnaloElige ese accesorio, o Random accessory, como tipo de bonk de un canje, comando o evento.

Repetir un accesorio lo deja más tiempo. Max on the model at once quita el más viejo si hay demasiados, y Take all off los quita todos. Un punto exacto se guarda para un modelo; en otro, el accesorio cae en cualquier parte.

Escenas

Una escena es un show corto: un fondo detrás de tu modelo, imágenes y sonidos encima, expresiones y movimientos, cada paso a su tiempo. Al terminar, la app regresa solo lo que la escena cambió.

Dónde

Scenes

Se hace solo

Con su disparador corre sola, y espera si otra escena la bloquea

Ejemplos

Se importan como archivos .bonkscene

Necesitas

Una segunda fuente de OBS para los fondos

Prepararlo, una vez

1. Segunda fuente en OBSAgrega background.html (la ruta está en Scenes › Setup) y ponla debajo de la captura de VTube Studio. Los fondos se dibujan ahí.
2. Expresión baseEn Setup pulsa Load from VTS y elige a qué expresión regresa tu modelo, o None.

Hacer una escena

1. Trae tus archivosCrea la escena y pulsa Import files para tus imágenes, videos y música.
2. Agrega pasosCada uno empieza en At. Un Length hace que se deshaga antes. O pulsa Edit y hazlo a la vista, en el editor visual.
3. Dale un disparadorUn canje, un comando o un cheer. Create on Twitch hace una recompensa propia de la app: se oculta mientras la escena está bloqueada, y si alguien alcanza a canjearla se le reembolsa.
4. PruébalaTry it usa el disparador como un viewer de prueba, con bloqueos y reembolsos como en directo.

El editor visual

Edit abre la escena en su propia ventana. El escenario muestra tu directo desde OBS con el modelo como su propia capa. Arrastra archivos al escenario o a la línea de tiempo, mueve imágenes, y haz doble clic para agregar puntos de recorrido. Preview la reproduce en el editor; Play on stream la reproduce de verdad.

Bloqueos

Las escenas de un mismo grupo (Model, Background, Music o uno tuyo) nunca suenan juntas. Una escena sin grupos, como unas palomas, puede salir durante un modo. Los comandos que llegan bloqueados se pueden ignorar o poner en fila; cheers y Power-ups siempre esperan su turno. Los lanzamientos esperan mientras corre una escena.

Modos y evoluciones

Un modo del modelo (grande, mascota, mini) tiene su expresión y su duración, y comparte el bloqueo Model: solo corre uno a la vez. Puede entrar con una evolución: canción, cuadro de texto, silueta blanca y un destello. Conecta OBS en Setup, elige la captura de VTube Studio y pulsa Capture silhouettes en el modo. Se captura una vez.

Atuendos

En Scenes › Outfits, un atuendo pone imágenes y objetos Live2D en tu modelo, enciende expresiones y oculta partes, mientras un modo o una escena lo use. Pulsa Click its spot y haz clic en tu modelo en VTube Studio. Cada modelo guarda sus posiciones. Export crea un archivo .bonkoutfit con todo lo suyo.

Antes de salir en vivo

Check before going live revisa OBS, VTube Studio, Twitch y los archivos de cada escena, y te dice qué arreglar. Pause scenes detiene lo nuevo, por ejemplo durante un karaoke. Panic termina todo y regresa el modelo a su modo base.

Acciones

Lo que la app hace sola cuando pasa algo. Se lee como una frase: cuando alguien escribe !discord, responde en el chat con tu enlace.

Dónde

Actions

Se hace solo

Sí, una vez encendida

Plantillas

Empieza desde un ejemplo, o importa un paquete .bonkpack

1. Crea unaPulsa New action o empieza desde un ejemplo.
2. Elige cuándoEn el bloque When: un comando, un canje, un cheer, un sub, un follow, un raid, el inicio o el fin del directo, cada ciertos segundos, o un cambio de escena en OBS. Ahí también van quién puede y cada cuánto.
3. Agrega pasosCon Add a step. Van de arriba abajo: responder en el chat, preguntar a un sitio web, seguir solo si, reproducir una escena, esperar, girar una ruleta.
4. PruébalaTry it la corre como tú o como otro rol. Los mensajes solo se ven ahí, salvo que marques enviarlos.

En un mensaje, Insert a value agrega el nombre del viewer, lo que escribió o la respuesta del sitio.

Paquetes

Import a pack agrega acciones de un archivo .bonkpack. Te muestra qué hace y lo que necesita, y sus acciones llegan apagadas. Abre un paquete de tu lista para exportarlo; las llaves nunca van en el archivo.

Pasos en prueba cerrada

Los pasos de avatares, créditos, check-in y puntos solo corren con acceso. Sin él no se borran: la acción dice que necesita acceso, y los de check-in y puntos detienen los pasos siguientes.

Ruletas

Ruletas de premios o retos que giran en tu directo. Cada rebanada muestra su probabilidad real: una con 2 sale el doble y mide el doble.

Dónde

Wheels

Plantillas

Ejemplos y estilos: neón, oro, Halloween, Navidad, pastel, tus colores

Se hace solo

Con el paso de una acción, o a mano

1. Crea unaNew wheel, o empieza desde un ejemplo. Escribe las rebanadas y su probabilidad.
2. Marca las rarasCon Special se ven doradas y celebran más.
3. Elige un estiloWatch it spin te la muestra ahí mismo, sin gastar nada.
4. Ponla a girarCon el paso Spin a wheel de una acción: un canje, un comando, o cheers con un giro por tantos bits. Spin now la gira a mano, por ejemplo por una donación.

Una rebanada puede salir siempre, o solo algunas veces, como un premio del que hay 3. Se va de la ruleta hasta que pulses Reset the wheel, o sola en cada directo. Con Then start arranca otra acción al caer.

Gira una a la vez y las demás hacen fila. Espera si hay una escena o un minijuego.

Ritmo cardíaco

Con un reloj o sensor, tu pulso puede salir en el directo y mover cosas.

1. Instala HypeRateEs gratis. Instálalo en tu reloj o teléfono y ábrelo.
2. Pega tu IDTu ID o enlace en Settings › Heart Rate. ¿Usas Pulsoid? Elígelo y pega su token, que requiere su plan de pago.
3. PruébaloTry a Heart Rate simula uno durante un minuto.

Al pasar de High From corre la reacción del modelo y en Actions arranca Your heart rate goes up. Al bajar, Your heart rate calms down. VTube Studio recibe el parámetro BonkyHeartRate (0 a 220) para mover lo que quieras en tu modelo.

Avatares

Quien escribe en tu chat recibe un bichito de pixel que camina por tu directo. Quien solo mira no aparece hasta que diga algo, y se va tras unos minutos sin hablar.

Dónde

Avatars

Se hace solo

Llegan, caminan y se van solos. Reaccionan a bonks, escenas y raids

Viene listo

Apariencias y siete sombreros

Necesitas

La fuente bonker.html que ya tienes en OBS

1. EnciéndelosEn Avatars activa Avatars on stream. Salen delante de tu modelo. Para que vayan detrás, elige Behind the model, que usa la fuente background.html.
2. AcomódalosEn On screen ajusta su tamaño, el suelo y cuánto ancho usan. OBS lo muestra al momento.
3. PruébalosTry it agrega viewers de prueba y te dice a cuántos cuadros va OBS. También ensaya un raid, un festejo y cada minijuego, sin escribir en el chat.

Comandos del chat

Renómbralos en Chat commands. Cada comando y apariencia tiene su regla de quién puede: todos, o subs, VIPs y nombres que pongas. Mods y tú siempre pueden. Marca la Cabeza en Scenes › Model parts para que suban al lugar correcto.

Apariencias y sombreros

• Import a look agrega tu personaje desde un PNG o WebP: quieto, o caminando con sus cuadros lado a lado.
• La apariencia Photo le da a cada viewer una cabeza con su foto de Twitch.
• En Viewers le das a alguien su propia apariencia, y puedes bloquearla para que no la cambie.
• El paso Avatars de Actions puede desbloquear una apariencia o sombrero: para siempre, por este directo o por unos días. Conéctalo a un canje o a bits.

Lo que hacen solos

Los lanzamientos los tumban, las evoluciones los asustan, la lluvia los hace cubrirse y bailan cuando las escenas están en pausa. Un raid trae al raider con su grupo, y bits y subs hacen festejar al avatar de quien los dio. En OBS scenes without avatars marcas escenas donde se van.

Minijuegos

En Games: rey de la cabeza, rodeo, paracaídas, atrapa las estrellas y duelo. Un mod inicia uno con el comando, o una acción lo arranca desde un canje. Esperan a las escenas, y las escenas los esperan a ellos. Las predicciones y encuestas de Twitch también salen en pantalla, y quien predijo camina a su lado.

Concierto y collabs

Concert es para directos de canto: se juntan a los lados de tu modelo con penlights, y los bits lanzan fuegos artificiales. En un chat compartido, los viewers de otros canales reciben avatar con su canal bajo el nombre. Tus comandos y escenas siguen siendo tuyos, salvo que lo permitas.

Check-in

Tu comunidad sella en cada directo. Cada sello suma a su número y a su racha, y sale una animación en pantalla con sus datos.

Dónde

Credits › Open the designer › Check-in

Se hace solo

Una vez encendido: responde, cuenta, anima y paga puntos

Plantillas

Diez, de boleto de metro a pasaporte, y una en blanco

Necesitas

La fuente layers.html en OBS

1. Abre el diseñadorEn Credits pulsa Open the designer y elige Check-in.
2. Agrega la fuenteEl panel In OBS te da la ruta de layers.html. Agrégala como fuente de navegador de 1920 × 1080, encima de todo.
3. Elige una plantillaPulsa Templates y cámbiala a tu gusto. Cómo usar el diseñador.
4. EnciéndeloEn Trigger and chat activa Check-ins are on. Viene apagado.
5. PruébaloTest in OBS lo reproduce de verdad con gente inventada.

Las reglas

• Se escribe !checkin. Cambia el comando en Chat command.
• Solo cuenta con un directo abierto: uno por persona en cada directo, y al menos 3 horas entre uno y otro.
• Quien falta a un directo rompe su racha, salvo que tenga un talismán.
• Si la nube no responde, el sello se guarda y cuenta cuando suba, con su hora real.

Lo que responde en el chat

En Trigger and chat escribes un mensaje para cada caso: cuando cuenta, cuando un talismán salvó la racha, cuando ya selló, y cuando la nube no responde. Si dejas uno vacío, ese caso no dice nada.

Puntos

Una moneda de tu canal que mide pertenencia. Se gana estando, nunca pagando.

Dónde

Points, en la barra lateral

Se hace solo

Sí: cada check-in paga solo

Viene listo

Montos por defecto y los comandos !puntos y !top

De dónde salen

Bits, subs y canjes nunca dan puntos.

1. Abre PointsPonle nombre a tu moneda y ajusta los montos.
2. Enciende los comandosEn Chat commands. !puntos y !top vienen apagados. Un !top racha muestra las rachas.
3. GuardaCon Save.

Ver y corregir a alguien

En Someone's points escribe su nombre de Twitch para ver su saldo e historial. Para corregir, pon la cantidad (negativa para quitar) y el motivo. Te pide confirmar con tu sesión de Twitch.

El ranking

Cuenta lo ganado en total, así que gastar no baja a nadie. Las cuentas de Scenes › Setup que nunca aparecen, como tu bot, quedan fuera.

Créditos

Al terminar tu directo, agradece a quienes estuvieron, con lo que pasó de verdad. La app va anotando lo que ocurre, sin guardar los mensajes del chat, y lo suma.

Dónde

Credits

Se hace solo

Anotar sí. Lanzarlos: tú, una escena de OBS o una acción

Plantillas

Cuatro finales en el diseñador y uno en blanco, y los créditos clásicos

Necesitas

Su propia fuente de OBS

1. Agrega la fuenteEn OBS, una fuente de navegador de 1920 × 1080 con Local file. Copy the path for OBS te da el archivo. Ponla encima de todo.
2. Elige cómo se venCómo salen los nombres, qué va detrás y qué secciones entran. La vista previa usa gente inventada.
3. PruebaTest on stream los reproduce en OBS.
4. LánzalosCon Roll the credits, al entrar a la escena de OBS que elijas, o con el paso de una acción.

La música

Tu propio archivo o sin audio. Con canción, se estiran para terminar con ella; sin canción, la velocidad decide cuánto duran y lo que tengas sonando sigue sonando. Deja Control audio via OBS apagado, o enciéndelo y envía el audio tú.

Un final a tu medida

Con Open the designer, elige Ending y empieza desde una plantilla: Sunset film, Side by side, Avatar parade o High scores. El diseño que elijas reemplaza a los clásicos. Cómo usar el diseñador.

Bueno saber

• Si OBS recarga la fuente, siguen donde iban.
• Un aviso en un directo significa que la app no estuvo escuchando un rato, y puede faltar alguien.
• Si alguien borró sus datos, sus sumas siguen contando, pero su nombre ya no aparece.
• En Your brand, un diseño tiene sus colores, letra, paneles y logo. Viajan al exportarlo, salvo el archivo del logo.

Diseñador

Una ventana donde armas por capas las animaciones de check-in y los finales de tu directo, con datos reales de tu canal.

Dónde

Credits › Open the designer

Plantillas

10 de check-in y 4 de final, más una en blanco para cada uno

Compartir

Exportar e importar llevan sus archivos

1. Elige qué hacesCheck-in o Ending, arriba.
2. Empieza con una plantillaPulsa Templates.
3. CámbialaHaz clic en lo que sea, en el escenario o en la línea de tiempo. Con Add agregas capas.
4. Usa datos realesStream data inserta el nombre, número o racha de la persona, o las listas del directo. Try it with cambia con quién lo ves.
5. MíraloEl botón de reproducir, o Espacio, muestra una vista previa. Test in OBS lo reproduce de verdad con gente inventada.

La línea de tiempo

Ctrl y rueda acerca donde está el ratón. Shift y rueda se mueve a lo largo. Fit muestra todo el diseño. Ctrl+Z deshace.

Ajustar a una canción

Escribe cuánto quieres que dure en How long it lasts, como 5:00, o pulsa Fit it to the song. Todo conserva su lugar y las listas se ajustan, hasta 3 veces más rápido. Si el directo tiene demasiados nombres para leer, dale más tiempo o muestra las listas por páginas.

Después de los créditos

En After the credits eliges una escena final o nada.

La nube

BonkyMonky Cloud guarda una copia de tus directos y los números de tu comunidad. Así, si pierdes tu PC, tu comunidad no pierde sus rachas.

Dónde

Settings › Advanced › BonkyMonky Cloud

Se hace solo

Sube cada minuto. Sin internet, espera y sube después

Necesitas

Acceso para tu canal

Solo suben los directos que empiecen después de conectar. Los mensajes del chat nunca suben. Qué se guarda exactamente.

Varias PC

La primera que conectas es la principal, y solo ella empieza directos nuevos. Si cambias de PC, usa Make this the main PC en la nueva. Te pide confirmar con Twitch.

Tus datos

Exportar y borrar te piden tu sesión de Twitch: una PC robada no alcanza. Una PC sin usarse 90 días deja de servir, y conectarse otra vez no cuesta nada. Tus archivos locales no se tocan.

Si algo falla

Un punto rojo en la barra de arriba te dice qué conexión está caída. Haz clic en la barra para ver el detalle.

Los eventos que pasan sin conexión esperan en fila y se lanzan al reconectar, hasta Queue Max Wait.

¿Algo raro en un directo? Test › Logs › Open Folder tiene un archivo por día. Si nos escribes a contacto@ayanogroup.com, adjúntalo.

Términos de uso

Última actualización: 2026-11-06. La versión en español es la que rige; la inglesa es una traducción.

1. Qué es y quién lo opera

BonkyMonky es una app para streamers de Twitch con un servicio opcional en la nube. Lo opera Qtz, con domicilio en México. Al usarlo aceptas estos términos y el aviso de privacidad. Si no estás de acuerdo, no lo uses.

2. Edad

Debes tener 13 años o más. Si tienes entre 13 y 17 años, necesitas permiso de tu madre, padre o tutor.

3. Un servicio gratuito y en prueba

Se ofrece tal como está: puede tener errores, interrupciones o cambios, y puede dejar de estar disponible. El acceso a las funciones en prueba se da canal por canal y se puede retirar. Los puntos no tienen valor en dinero y no se pueden canjear por dinero.

4. Uso permitido

No está permitido usar BonkyMonky para acosar, publicar datos de otras personas sin permiso, infringir derechos de terceros, saltarse sus límites o atacar el servicio, ni para violar las reglas de Twitch. Podemos retirar el acceso a quien no cumpla.

5. Lo que hace cada streamer

Tus diseños, escenas e imágenes siguen siendo tuyos. Confirmas que tienes derecho a usarlos. Al conectar tu canal, le avisas a tu comunidad que sus datos se guardan según el aviso de privacidad.

6. Responsabilidad

En la medida en que la ley lo permita, no respondemos por daños derivados de fallas del servicio ni por la pérdida de datos.

7. Código de terceros

Basado en KBonk de typeou, con licencia MIT. Los créditos y las licencias están en la sección About de la app.

8. Cambios y ley aplicable

Si cambiamos estos términos, publicaremos la nueva versión aquí con su fecha. Se rigen por las leyes de México.

First steps

BonkyMonky has three parts that talk to each other: the app, a Browser Source in OBS that draws the items, and VTube Studio, which moves your model when it gets hit.

You need

Windows, a Twitch account, OBS and VTube Studio

Time

About ten minutes, once

After that

It updates itself and your login renews itself

1. Download the appOn the releases page, get BonkyMonky-Setup.exe to install it, or the .zip if you prefer a portable copy. Both update themselves.
2. Log in with TwitchPress Log in at the bottom of the sidebar. Twitch opens in your browser: approve it, using the code the app shows if it asks for one.
3. Turn on the VTube Studio APIIn VTube Studio, open Settings and turn on Start API. Leave the port at 8001. The first time BonkyMonky connects, VTube Studio asks for permission: press Allow.
4. Add the source to OBSCreate a Browser Source and tick Local file. Pick bonker.html: Settings › Updates › Copy Path has the exact path, which stays the same after updates. Size it to your canvas, usually 1920 × 1080, and place it above the VTube Studio capture.
5. CalibrateIn Throws, press Calibrate, then Start calibration. VTube Studio shrinks your model. Move it until its face sits under the round guide in OBS and continue. Repeat at full size and confirm. Items now aim at the face at any size.

Check that it works

The top bar shows each link: a green dot means connected. Press Test in the sidebar and throw something. It should show in OBS and move your model.

To move the calibration guide, right-click the source in OBS, choose Interact and click where the face is.

What's next

• Choose what throws items on your channel.
• Add your own items and sounds.
• Something won't connect? See If something fails.

Request access to the test

Avatars, check-in, points and credits are in closed test with a small group of channels. Each channel is approved by hand.

Write to contacto@ayanogroup.com with:

• Your Twitch channel name.
• What you want to try: avatars, check-in, points or credits.

When we tell you

1. ConnectIn the app, logged in to Twitch: Settings › Advanced › BonkyMonky Cloud › Connect. It asks for no other approval.
2. That's itAvatars, Points and Credits open right away.

Meanwhile

Bonks, scenes, actions, wheels, accessories and outfits work without access. If your channel isn't on the list, pressing Connect says so and shows a button that brings you here.

How access works

• The app confirms your access when it opens and every hour.
• If our server goes down, everything keeps working for up to 14 days. An outage of ours doesn't hit your stream.
• If you disconnect the cloud, what's in test closes right away. Your settings are kept and return when you connect.

Coming from another version

BonkyMonky now has its own Twitch login. There are two things to do, once.

1. Log in againThe app asks when it opens. Approve on Twitch and you're done.
2. Remake your channel rewardsTwitch only lets the app that made a reward change it. Rewards BonkyMonky made with the old login can't be hidden or refunded anymore. Delete them on Twitch and save them again from their scene. The app tells you when you open that scene.

How it updates

The app looks for new versions when it opens and every 6 hours, and downloads them in the background. When one is ready, Restart to update appears on the left. Restart, or just close the app and it updates on its way out. Your settings, items and sounds are kept.

Settings › Updates shows your version and a Check Now button. A portable copy in a read-only folder, like Program Files, can't replace itself and links to the download instead.

Items and sounds

Items are the images your viewers throw. Some come with the app and you can add your own.

Where

Throws

Automatic

The app picks at random among the ones you ticked

Included

Items and impact sounds

Add and choose

1. Open ThrowsAdd your images and untick any you don't want.
2. Open an item's cogEverything about it is there.
3. Try itWith Test in the sidebar.

What each item adjusts

The Bits tab sets the image and size of each bit tier. Sounds holds the random impacts, with another tab for cheers.

Custom bonks

A custom bonk is a throw recipe you can attach to any redeem, command or event. Each can change the count, rhythm, duration, spin, angle and direction. It can also use its own items and sounds, decals left at the hit spot, and a windup sound before the throw.

How throws look

• Barrage Pattern: Classic uses your angles, Rain falls from above, Shotgun fires bursts of 3 to 5, Alternate switches sides and Spiral sweeps over the top. Random picks one per barrage.
• Throw Variance: changes distance, arc, speed and where they land. At 0 they all follow the same path.
• Sticky Items: stay on the model for a few seconds, follow it and then fall.
• Bounce Off the Model: in Settings › Physics Simulation. Items bounce off your model's outline instead of falling through it.

Events

This is where you choose what throws items on your channel. Each event has its own tab in Events.

Where

Throws › Events

Automatic

Yes: when it happens, it throws

You need

To be logged in to Twitch

Try it without a stream

Test in the sidebar has the Event Simulator: fake follows, bits, subs, raids, redeems and messages that go through the same rules as real ones. Event Storm fires 20 random events in 10 seconds.

Counter and hype meter

The OBS source can show a bonk counter and a hype meter. Every hit fills it, a boss bit counts ten, and it slowly drains. When full, HYPE! appears and the Hype Bonk is thrown. Set colors, font, texts and position in Settings › Overlay Style, with presets or your own. Follow Model keeps it next to your model's head.

Model reactions

In Settings › Model Reactions, press Load from VTS and pick what happens on a combo, a boss bit, when hype fills, or by chance. Expressions turn off by themselves after the time you set.

Accessories

Images your viewers put on your model: a hat, glasses, a sticker. They move and turn with it, and come off by themselves.

Where

Accessories

Automatic

They go on and come off by themselves when their time ends

Included

The Viewer badge, with the photo and name of who triggered it

1. Add imagesPNG, JPG or GIF. Outside 64 to 2048 pixels, the app adjusts them.
2. Choose whereAnywhere, on parts you tick, or an exact spot. For the last two, press Choose in VTS and mark it in VTube Studio within a minute.
3. Try itPress Put on model. The first time, VTube Studio asks to allow loading images as items: allow it.
4. Assign itPick that accessory, or Random accessory, as the bonk type of a redeem, command or event.

The same accessory again keeps it on longer. Max on the model at once takes the oldest off when there are too many, and Take all off clears them. An exact spot is saved for one model; on another, the accessory lands anywhere.

Scenes

A scene is a short show: a background behind your model, images and sounds over it, expressions and moves, each at its own time. When it ends, the app puts back only what the scene changed.

Where

Scenes

Automatic

With its trigger it runs by itself, and waits if another scene blocks it

Examples

Imported as .bonkscene files

You need

A second OBS source for backgrounds

Set it up, once

1. Second source in OBSAdd background.html (the path is in Scenes › Setup) and place it under the VTube Studio capture. Backgrounds draw there.
2. Base expressionIn Setup, press Load from VTS and pick the expression your model returns to, or None.

Make a scene

1. Bring your filesCreate the scene and press Import files for your images, videos and music.
2. Add stepsEach starts at At. A Length makes it undo itself early. Or press Edit and do it by eye in the visual editor.
3. Give it a triggerA redeem, command or cheer. Create on Twitch makes a reward the app owns: it hides while the scene is blocked, and one that slips through is refunded.
4. Try itTry it uses the trigger as a test viewer, with locks and refunds as on stream.

The visual editor

Edit opens the scene in its own window. The stage shows your stream from OBS with the model as its own layer. Drag files onto the stage or the timeline, move images, and double-click to add path points. Preview plays it in the editor; Play on stream plays it for real.

Locks

Scenes in the same group (Model, Background, Music or your own) never play together. A scene with no groups, like pigeons, can play during a mode. Commands that arrive while blocked can be skipped or wait in line; cheers and Power-ups always wait their turn. Throws wait while a scene plays.

Modes and evolutions

A model mode (big, mascot, mini) has its expression and duration, and shares the Model lock: only one runs at a time. It can come in with an evolution: a song, a text box, a white silhouette and a burst of light. Connect OBS in Setup, pick the VTube Studio capture and press Capture silhouettes in the mode. You capture once.

Outfits

In Scenes › Outfits, an outfit puts pictures and Live2D items on your model, turns expressions on and hides parts, while a mode or scene wears it. Press Click its spot and click your model in VTube Studio. Each model keeps its placements. Export makes a .bonkoutfit file with everything in it.

Before going live

Check before going live checks OBS, VTube Studio, Twitch and every scene's files, and says what to fix. Pause scenes stops anything new, for example during karaoke. Panic ends everything and puts the model back in its base mode.

Actions

What the app does by itself when something happens. It reads like a sentence: when someone types !discord, reply in chat with your link.

Where

Actions

Automatic

Yes, once it's on

Templates

Start from an example, or import a .bonkpack pack

1. Make onePress New action or start from an example.
2. Choose whenIn the When block: a command, redeem, cheer, sub, follow, raid, the stream starting or ending, every few seconds, or OBS switching scene. Who may and how often go there too.
3. Add stepsWith Add a step. They run top to bottom: reply in chat, ask a website, only continue if, play a scene, wait, spin a wheel.
4. Try itTry it runs it as you or another role. Messages only show there unless you tick sending them.

In a message, Insert a value adds the viewer's name, what they typed or the website's answer.

Packs

Import a pack adds actions from a .bonkpack file. It shows what it does and what it needs, and its actions arrive off. Open a pack in your list to export it; keys never go in the file.

Steps in closed test

Avatar, credits, check-in and points steps only run with access. Without it they aren't deleted: the action says it needs access, and check-in and points steps stop the steps after them.

Wheels

Wheels of prizes or dares that spin on your stream. Each slice shows its real odds: one with 2 lands twice as often and is twice as big.

Where

Wheels

Templates

Examples and styles: neon, gold, Halloween, Christmas, pastel, your colors

Automatic

With an action's step, or by hand

1. Make oneNew wheel, or start from an example. Write the slices and their chance.
2. Mark the rare onesSpecial makes them gold, with a bigger celebration.
3. Pick a styleWatch it spin shows it right there, using nothing up.
4. Spin itWith an action's Spin a wheel step: a redeem, a command, or cheers with one spin per so many bits. Spin now spins it by hand, say for a donation.

A slice can come out always, or only a few times, like a prize there are 3 of. It leaves the wheel until you press Reset the wheel, or by itself every stream. Then start starts another action when it lands.

One spins at a time and the rest wait in line. It waits for a scene or a minigame.

Heart rate

With a watch or sensor, your heart rate can show on stream and move things.

1. Install HypeRateIt's free. Install it on your watch or phone and start it.
2. Paste your IDYour ID or share link in Settings › Heart Rate. Use Pulsoid? Pick it and paste its token, which needs their paid plan.
3. Try itTry a Heart Rate pretends one for a minute.

Over High From, the model reaction runs and in Actions Your heart rate goes up starts. Coming back down, Your heart rate calms down. VTube Studio gets the BonkyHeartRate parameter (0 to 220) to drive anything on your model.

Avatars

Whoever writes in your chat gets a little pixel critter that walks across your stream. Lurkers don't show up until they say something, and it goes home after some minutes without chatting.

Where

Avatars

Automatic

They arrive, walk and leave by themselves. They react to bonks, scenes and raids

Included

Looks and seven hats

You need

The bonker.html source you already have in OBS

1. Turn them onIn Avatars, turn on Avatars on stream. They show in front of your model. To have them behind, pick Behind the model, which uses the background.html source.
2. Place themIn On screen, set their size, the floor and how much width they use. OBS shows it right away.
3. Try themTry it adds test viewers and says how many frames OBS draws. It also plays a raid, a celebration and every minigame, with nothing going to chat.

Chat commands

Rename them in Chat commands. Each command and look has its own rule of who may: everyone, or subs, VIPs and names you list. Mods and you always can. Mark the Head in Scenes › Model parts so they climb to the right spot.

Looks and hats

• Import a look adds your character from a PNG or WebP: still, or walking with its frames side by side.
• The Photo look gives each viewer a head with their Twitch picture.
• In Viewers you give someone their own look, and can lock it so they can't change it.
• The Avatars step in Actions can unlock a look or hat: for good, for this stream or for some days. Hook it to a redeem or to bits.

What they do by themselves

Throws knock them over, evolutions scare them, rain makes them cover up and they dance while scenes are paused. A raid brings the raider with a crowd, and bits and subs make the giver's avatar celebrate. In OBS scenes without avatars you tick scenes where they leave.

Minigames

In Games: king of the head, rodeo, parachutes, catch the stars and duels. A mod starts one with the command, or an action starts it from a redeem. They wait for scenes, and scenes wait for them. Twitch predictions and polls also show on screen, and whoever predicted walks to their side.

Concert and collabs

Concert is for song streams: they gather at both sides of your model with penlights, and bits launch fireworks. In a shared chat, other channels' viewers get avatars with their channel under the name. Your commands and scenes stay yours unless you allow them.

Check-in

Your community stamps each stream. Each stamp adds to their number and streak, and an animation with their data shows on screen.

Where

Credits › Open the designer › Check-in

Automatic

Once on: it replies, counts, animates and pays points

Templates

Ten, from metro ticket to passport, plus a blank one

You need

The layers.html source in OBS

1. Open the designerIn Credits, press Open the designer and pick Check-in.
2. Add the sourceThe In OBS panel gives you the path to layers.html. Add it as a 1920 × 1080 Browser Source, above everything.
3. Pick a templatePress Templates and change it as you like. How to use the designer.
4. Turn it onIn Trigger and chat, turn on Check-ins are on. It starts off.
5. Try itTest in OBS plays it for real with made-up people.

The rules

• They type !checkin. Change it in Chat command.
• It only counts with a stream open: once per person per stream, and at least 3 hours apart.
• Missing a stream breaks the streak, unless they have a charm.
• If the cloud doesn't answer, the stamp is kept and counts when it uploads, with its real time.

What it replies in chat

In Trigger and chat you write a message for each case: when it counts, when a charm saved the streak, when they already checked in, and when the cloud doesn't answer. Leave one empty and that case says nothing.

Points

A currency for your channel that measures belonging. You earn it by being there, never by paying.

Where

Points, in the sidebar

Automatic

Yes: each check-in pays by itself

Included

Default amounts and the !points and !top commands

Where they come from

Bits, subs and redeems never give points.

1. Open PointsName your currency and set the amounts.
2. Turn on the commandsIn Chat commands. !points and !top start off. !top streak shows streaks.
3. SaveWith Save.

See and correct someone

In Someone's points, type their Twitch name to see their balance and history. To correct, enter the amount (negative takes away) and why. It asks you to confirm with your Twitch login.

The ranking

It counts total earned, so spending doesn't lower anyone. The accounts in Scenes › Setup that never appear, like your bot, stay out.

Credits

At the end of your stream, thank who was there, with what really happened. The app notes what occurs, without keeping chat messages, and adds it up.

Where

Credits

Automatic

Noting yes. Rolling them: you, an OBS scene or an action

Templates

Four endings in the designer plus a blank one, and the classic credits

You need

Their own OBS source

1. Add the sourceIn OBS, a 1920 × 1080 Browser Source with Local file. Copy the path for OBS gives you the file. Put it above everything.
2. Choose how they lookHow names show, what goes behind and which sections go in. The preview uses made-up people.
3. Try itTest on stream plays them in OBS.
4. Roll themWith Roll the credits, entering the OBS scene you chose, or an action's step.

The music

Your own file or no audio. With a song, they stretch to end with it; without one, the speed decides how long they last and whatever is playing keeps playing. Leave Control audio via OBS off, or turn it on and route it yourself.

An ending of your own

In Open the designer, pick Ending and start from a template: Sunset film, Side by side, Avatar parade or High scores. The design you choose replaces the classic ones. How to use the designer.

Good to know

• If OBS reloads the source, they go on where they were.
• A warning on a stream means the app wasn't listening for a while, so someone could be missing.
• If someone deleted their data, their totals still count, but their name no longer shows.
• In Your brand, a design has its colors, font, panels and logo. They travel when exported, except the logo's file.

Designer

A window where you build your check-in animations and endings from layers, with your channel's real data.

Where

Credits › Open the designer

Templates

10 check-ins and 4 endings, plus a blank one for each

Sharing

Export and import carry their files

1. Choose what you're makingCheck-in or Ending, at the top.
2. Start from a templatePress Templates.
3. Change itClick anything on the stage or the timeline. Add adds layers.
4. Use real dataStream data inserts the person's name, number or streak, or the stream's lists. Try it with changes who you see it with.
5. Watch itThe play button, or Space, previews it. Test in OBS plays it for real with made-up people.

The timeline

Ctrl and wheel zooms where the mouse is. Shift and wheel moves along. Fit shows the whole design. Ctrl+Z undoes.

Fit it to a song

Write how long you want it in How long it lasts, like 5:00, or press Fit it to the song. Everything keeps its place and lists fit themselves, up to 3 times faster. If a stream has too many names to read, give it more time or show lists one page at a time.

After the credits

In After the credits you choose a final scene or nothing.

The cloud

BonkyMonky Cloud keeps a copy of your streams and your community's numbers. If you lose your PC, your community doesn't lose its streaks.

Where

Settings › Advanced › BonkyMonky Cloud

Automatic

Uploads every minute. Without internet, it waits and uploads later

You need

Access for your channel

Only streams that start after connecting upload. Chat messages never upload. Exactly what's kept.

Several PCs

The first one you connect is the main one, and only it starts new streams. If you change PCs, use Make this the main PC on the new one. It asks you to confirm with Twitch.

Your data

Exporting and deleting ask for your Twitch login: a stolen PC isn't enough. A PC unused for 90 days stops working, and connecting again costs nothing. Your local files aren't touched.

If something fails

A red dot in the top bar tells you which link is down. Click the bar for details.

Events that happen while disconnected wait in a queue and are thrown once reconnected, up to Queue Max Wait.

Something odd during a stream? Test › Logs › Open Folder has a file per day. If you write to contacto@ayanogroup.com, attach it.

Terms of use

Last updated: 2026-11-06. This English version is a translation; if there is any difference, the Spanish version prevails.

1. What it is and who runs it

BonkyMonky is an app for Twitch streamers with an optional cloud service. It's run by Qtz, located in Mexico. By using it you accept these terms and the privacy notice. If you don't agree, don't use it.

2. Age

You must be 13 or older. If you're between 13 and 17, you need permission from a parent or guardian.

3. A free service in test

It's provided as is: it can have errors, interruptions or changes, and can stop being available. Access to features in test is given channel by channel and can be withdrawn. Points have no money value and can't be exchanged for money.

4. Allowed use

You may not use BonkyMonky to harass, publish other people's data without permission, infringe third-party rights, get around its limits or attack the service, or to break Twitch's rules. We can withdraw access from anyone who doesn't comply.

5. What each streamer does

Your designs, scenes and images remain yours. You confirm you have the right to use them. By connecting your channel, you tell your community their data is kept under the privacy notice.

6. Liability

As far as the law allows, we aren't liable for damages from service failures or for data loss.

7. Third-party code

Based on KBonk by typeou, under the MIT license. Credits and licenses are in the app's About section.

8. Changes and governing law

If we change these terms, we'll publish the new version here with its date. They are governed by the laws of Mexico.