Files
CydandClaude Fable 5 2ecb617c09 Phase 8D: universal deployment package (XP + Win10/11, two entry points)
One RIOJoy-<ver>.zip now deploys on both OS generations (~75 MB with the
offline XP prerequisites):
- Layout: RIOJoy\app (net48 x64) + RIOJoy\app-xp (net40 x86) +
  RIOJoy\vendor (ViGEmBus; vendor\xp: .NET 4.0 offline installer +
  KB2468871, both signature-verified; RioGamepadXP driver slots in when
  8B lands - build warns/skips until then).
- RIOJoy\install-core.bat: shared OS-detecting install logic (ver ->
  5.1 = XP); pure cmd.exe on the XP path, delegates to install-rio.ps1
  on 10/11. Exports RIOJOY_APPDIR for shortcut creation.
- postinstall.bat (TeslaConsole, unattended): elevates, runs the core,
  then deletes install.bat + README.txt so C:\games stays clean.
- install.bat (standalone computers): same core + Start Menu/desktop
  shortcuts via make-shortcut.vbs (XP-safe); keeps the README.
- README.txt at the zip root explains which entry point to run.
- deploy *.ps1 re-encoded UTF-8-with-BOM: Windows PowerShell read the
  BOM-less files as ANSI, where an em-dash byte parses as a curly quote
  and breaks string parsing (bit install-rio.ps1 in dry-run testing).

Verified: zip layout correct; extracted package dispatch-tested on
Win10 non-elevated (OS detect -> modern route -> admin guard, system
untouched).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 20:53:43 -05:00
..

RIOJoy - cockpit interface for the VWE pods
============================================

This package installs RIOJoy, the program that connects the cockpit's RIO
hardware (joystick, throttle, pedals, 96 lighted buttons, plasma display)
to games that don't know about the cockpit. It works on two kinds of
Windows:

  * Windows 10 / 11 (64-bit)  - full app, appears to games as an Xbox 360
                                controller (ViGEmBus driver, included)
  * Windows XP SP3 (32-bit)   - full runtime + mapping editor; all
                                prerequisites are included for offline
                                install (.NET 4.0 + its async update)

The installer detects which Windows it is running on and installs the
right pieces automatically. Everything needed is inside this package -
no internet connection is required.


WHICH FILE DO I RUN?
--------------------

  install.bat      <-- RUN THIS on a normal, standalone computer.
                       Right-click -> "Run as administrator" (on XP, log
                       in as an Administrator user first). It installs
                       the prerequisites and puts RIOJoy shortcuts in the
                       Start Menu and on the desktop. RIOJoy does NOT
                       auto-start with Windows - launch it from the
                       shortcut when you want the cockpit active.

  postinstall.bat  --  Used by the arcade cabinet's launcher software
                       (TeslaConsole). It runs automatically after the
                       cabinet extracts this package; you do not need to
                       run it by hand. (It also deletes install.bat and
                       this README so the cabinet's games folder stays
                       clean.)


WHAT GETS INSTALLED
-------------------

  RIOJoy\app\      the program for Windows 10/11
  RIOJoy\app-xp\   the program for Windows XP
  RIOJoy\vendor\   third-party prerequisites (ViGEmBus for 10/11;
                   .NET 4.0 + KB2468871 + the RioGamepadXP joystick
                   driver for XP)

After installing, start RIOJoy and look for its icon in the system tray
(near the clock). Right-click the icon to pick a profile, edit button
mappings, or send commands to the cockpit hardware. Full deployment
notes for cabinet operators are in RIOJoy\README-DEPLOY.txt.


REMOVING RIOJOY
---------------

Run RIOJoy\pre-uninstall.bat as administrator, then delete the folder
you extracted. On a standalone computer also delete the RIOJoy shortcuts
from the Start Menu and desktop.