README.es.md

RB4InstrumentMapper

Un programa que interpreta y convierte datos de paquetes de instrumentos hechos para Xbox One a controles virtuales, para usar en juegos como Clone Hero.

Todos los instrumentos de Xbox One funcionan (guitarras/baterías de RB4, guitarras de GHL), y también el adaptador de RB4 inalámbrico para instrumentos anteriores (RB4 Wireless Legacy Adapter.)

Secciones

• Instalación
  • Configurando ViGEmBus
  • Configurando vJoy
• Usando guitarras y baterías de Rock Band 4
  • Configurando
    • Stratocaster, Jaguar, Batería
    • Riffmaster
  • Usando
    • ¿Problemas emparejando?
• Usando guitarras de Guitar Hero Live o el adaptador de RB4 inalámbrico para instrumentos anteriores
  • Configurando
  • Usando
• Configurando tus Instrumentos
  • Clone Hero
  • YARG
  • GHWT: Definitive Edition
  • RPCS3
• Registro de Paquetes
• Registro de Errores
• Construyendo
• Referencias
• Licencia

Instalación

1. Descarga y instala RB4InstrumentMapper de la pagina de publicaciones (Releases).
2. Descarga y configura ViGEmBus o vJoy usando las guías abajo.
   • ViGEmBus es recomendado porque es más fácil de usar y no requiere configuración adicional. vJoy es una opción alternativa por si tienes problemas con ViGEmBus.
   • Los dos se pueden instalar al mismo tiempo, pero RB4InstrumentMapper solo va a usar uno.

Configurando ViGEmBus

1. Descarga e instala ViGEmBus.
2. ¡Eso es todo!

Configurando vJoy

1. Descarga e instala vJoy.

2. Después de descargar, abre el menú de Inicio, busca la carpeta llamada vJoy y abre Configure vJoy dentro de esa carpeta.

3. Configura un dispositivo (Device) para cada uno de tus instrumentos usando estas opciones:

   • Number of Buttons: 16
   • POV Hat Switch: Continuous, POVs: 1
   • Axes: X, Y, Z

   

4. Haz click en Apply

5. ¡Eso es todo!

---

Usando guitarras y baterías de Rock Band 4

RB4InstrumentMapper NO es necesario para usar guitarras en Fortnite

Configurando

Stratocaster, Jaguar, Batería

Para usar guitarras y baterías inalámbrica de Rock Band 4, vas a necesitar un receptor para controles inalámbricos de Xbox One. Las dos versiones oficiales se ven así:

• ¡No son iguales a los receptores inalámbricos de Xbox 360! Tienes que tener un receptor para controles inalámbricos de Xbox One (o solo "Xbox"), como los ejemplos arriba.
• Los receptores que no son originales no se han probado y no recibirán soporte técnico.

Adicionalmente, las guitarras Jaguar requieren una actualización de firmware para conectarse a receptores para controles inalámbricos de Xbox One.

• Instrucciones (Inglés)
• Recargo de la Wiki de Clone Hero, en caso de que el enlace de arriba caiga otra vez.

Riffmaster

Para usar la Riffmaster, vas a necesitar su receptor dedicado, en la foto abajo:

Usando

1. En el menú desplegable de Controller Emulation Mode, selecciona el modo de emulación que quieres usar.

   

2. Haz click en el botón de Start para empezar a leer datos que va a mandar tu instrumento.

3. Conecta tus instrumentos. Van a estar detectados y funcionando hasta que presiones el botón de Stop o cierres el programa.

   • Los instrumentos deben de estar conectados antes o después de presionar el botón de Start, el orden no importa.

4. Configura tus instrumentos en los juegos en los que los vas a usar

¿Problemas emparejando?

Es posible que guitarras/baterías no se emparejan correctamente solo usando el botón de emparejar. Esto incluye la batería de PDP y la guitarra Jaguar en ocasión. Sigue estos pasos para emparejar tu instrumento correctamente:

1. Entra a Configuración de Windows > Dispositivos > Bluetooth y otros dispositivos
2. Haz click en Agregar Bluetooth u otro dispositivo y elije Otro.
3. Presiona y sostén el botón de emparejar hasta que el botón de Xbox parpadee rapido.
4. Elije Xbox compatible game controller de la lista cuando aparezca.
5. Si eso no funciona, reinicia tu computadora y trata otra vez.

---

Usando guitarras de Guitar Hero Live o el adaptador de RB4 inalámbrico para instrumentos anteriores (RB4 Wireless Legacy Adapter)

Configurando

Vas a necesitar instalar el controlador de WinUSB al receptor de Guitar Hero Live o el adaptador de RB4 inalámbrico para instrumentos anteriores (RB4 Wireless Legacy Adapter) antes de usarlos. Es posible usar RB4InstrumentMapper para instalarlo directamente, por el menú de Configure Devices en su menú principal:

1. Activa la opción Enable bajo el grupo de USB, y luego haz click en Configure Devices abajo de eso.

   

2. Encuentra el dispositivo que quieres usar en el menú del lado izquierdo.

   

3. Haz click en Switch Driver y espera a que se cambie el controlador. El dispositivo que estás modificando va a salir en el lado derecho cuando se complete esto.

   

   • Por favor toma en cuenta que cualquier juego que tenga soporte directo para estos dispositivos no va funcionar hasta que borres el controlador de WinUSB. Haz click en el botón de Revert Driver para revertir tus cambios para poder usar el dispositivo directamente.

Si tienes problemas con esta instalación, puedes tratar instalar el controlador manualmente (en Ingles). Esto no es recomendado para la mayoría de los usuarios. Solo se debe usar esta alternativa si el menú de Configure Devices no funciona.

• Esto también describe como desinstalar manualmente (en Ingles), en caso de que el dispositivo se quede con el controlador atorado y RB4InstrumentMapper pare de detectarlo.

Usando

1. Activa la opción Enable bajo el grupo de USB.

   

2. ¡Asegúrate que instalaste el controlador de WinUSB en los dispositivos que quieres usar! ¡No serán detectados si no esta hecho!

3. En el menú desplegable de Controller Emulation Mode, selecciona el modo de emulación que quieres usar.

   

4. Haz click en el botón de Start para empezar a leer datos que va a mandar tu instrumento.

5. Configura tus instrumentos en los juegos en los que los vas a usar.

Se detectará de forma automática si se conectan/desconectan instrumentos, pero no se van a mandar datos a los juegos hasta que presiones el botón de Start.

Si tienes problemas con el envío de botones, ya sean presiones o cosas raras, intenta reconectar el receptor/cable. Desafortunadamente, la detección de estos dos tipos de dispositivos no es completamente estable, así que es posible que no funcione perfectamente.

---

Configurando Tus Instrumentos

Ahora que RB4InstrumentMapper está listo y corriendo, puedes configurar los controles de tus instrumentos en los juegos que vas a jugar.

Clone Hero

Si estás usando una guitarra en el modo ViGEmBus, Clone Hero va a mapear todo automáticamente. No debes de tener que hacer ajustes manuales, al menos que estés usando una guitarra de Guitar Hero Live. En ese caso, vas a necesitar cambiar la configuración de Whammy/Palanca de tremolo y de ladear.

• La configuración automática también se va a aplicar a baterías, pero no va estar correcta porque esta diseñada para guitarras. Vas a necesitar cambiar la configuración que esta por defecto y ajustarla manualmente.

Para baterías, modo vJoy, o si necesitas ajustar tus controles por otra razón:

1. Presiona espacio en el menú principal.

   

2. Haz click en Asignar Mando y presiona un botón para que se asigne.

   

3. Haz click en las ranuras bajo la sección de Mando mapear todo en cada control.

   

4. Repite para cada instrumento.

5. Haz click en Listo.

Si requieres mas ayuda mapeando tu instrumento, puedes preguntar por ayuda en el Discord de Clone Hero.

YARG

Consulta la documentación oficial (en Ingles).

GHWT: Definitive Edition

Consulta la documentación oficial (en Ingles).

RPCS3

1. Para usar en RPCS3, usa la opción de ViGEmBus (RPCS3 compatibility) bajo el menú desplegable de Controller Emulation Mode. Eso hace que RB4InstrumentMapper mande sus datos de tus instrumentos al emulador en una forma que no requiere hacer ajustes (o ajustes mínimos) en el emulador de RPCS3.

   

2. Haz click en Pads en RPCS3.

   

3. Cambiar Handlers a "XInput", selecciona tu instrumento bajo Devices y cambia Device Class a "Rock Band - Guitar" si estas usando una guitarra o 'Rock Band - Drums' si estas usando una batería.

   

4. Repite para cada instrumento en las pestañas de Player.

5. Haz click en Listo.

Registro de Paquetes

Se puede usar RB4InstrumentMapper para registrar datos a un archivo por motivos de depuración. Para hacer esto, activa Show Packets (for debugging) y Log packets to file y luego haz click en el botón de Start. Los datos se van a guardar en tu carpeta de Documentos. Asegúrate de incluirla cuando preguntes por ayuda o creas reportes de problemas con la interpretación de datos.

Toma en cuenta que estas opciones son solo para depurar. Dejarlas activadas puede causar problemas con el rendimiento del programa.

Registro de Errores

En caso de que el programa falle, el error se va a registrar en un archivo dentro de la carpeta RB4InstrumentMapper > Logs que va estar localizada en la carpeta de tus Documentos. Asegúrate de incluirla cuando preguntes por ayuda o creas reportes de problemas con el programa.

Construyendo

Para construir este programa, vas a necesitar:

• Visual Studio, o MSBuild/el SDK de .NET + tu editor de código preferido.
• WiX Toolset v4 si quieres construir el instalador.

Referencias

Antecesores:

• Repositorio de GuitarSniffer
• Repositorio de DrumSniffer

Datos de paquetes:

• Registros de paquetes de guitarra por GuitarSniffer
• Hoja de datos de paquetes para guitarras de GuitarSniffer: Nuevos, Viejos
• Codigo fuente de Javascript de rb4.app
• Investigación original, publicada en el repositorio de documentación PlasticBand.

Licencia

Este programa esta publicado con la licencia de MIT. Lee LICENCIA (en Ingles) para mas información.