V5 Brain SimulatorRun a simulated VEX V5 brain inside VS Code and test your robot code without a robot. The brain runs VEX's real firmware (VEXos) in an emulator, so your VEXcode or PROS program runs as it does on a brain. Its motors, sensors and drivetrain are simulated on a field you can see and drive.
What you getThe brain's screen: the real VEXos screen. Click or drag on it to touch it, and use the brain's button underneath (tap for Back/Home, hold to stop the program).
The controller: what your program prints on the controller screen (an auton selector, for instance), its rumble, and its sticks and buttons as they're pressed. Click its buttons, or use the keys it lists, to work menus on the controller screen.
The field: the robot on the field, live. Click the field, then drive with the keyboard or a gamepad. Switch competition modes (driver, autonomous, disabled) or run a timed match from Field control. The devices: every motor's velocity and position against its target, with volts, amps, power and temperature. Every sensor's reading.
Your robot's ports: V5 Sim: Configure Ports picks the device on each of the 21 smart ports and the 3-wire ports A–H. It also sets cartridges, reversals, tracking wheels, distance sensor mounts and the drivetrain. It flags anything the simulator would refuse before you start. Get started
Requirements
Everything else (the emulator, Python, the robot simulator) comes inside the extension. Get your program onto the brain
Settings
TroubleshootingVEXcode doesn't see the brain (Windows). The brain appears on USB only with the usbip-win2 driver. Without it the simulator falls back to WSL serial ports, which VEXcode can't see. Run V5 Sim: Install USB Driver, then restart the simulator. "WSL can't run Windows programs". Ubuntu 24.04 can switch off WSL's ability to run Windows programs at boot. The extension then puts the brain on USB itself and offers Fix WSL, which turns it back on now and after reboots. macOS: VEXcode's Download button can't see the brain. On a Mac the brain's USB is two serial ports ( Anything else. V5 Sim: Show Log shows what the simulator is doing. V5 Sim: Repair Simulator unpacks it again. Stopping. V5 Sim: Stop, closing VS Code, or reloading the window all stop the simulator gracefully. It is never killed, because a hard stop can crash Windows' USB driver. If VS Code itself was killed and the simulator is still running, open any pane (V5 Sim: Open Field View, for instance), which finds the running simulator, then V5 Sim: Stop. FeedbackIssues and suggestions: GitHub issues. Building the extension or working on the simulator: see DEVELOPMENT.md. LicenseCopyright © 2026 UNSW Robotics Competition Club. The extension is LGPL-3.0-or-later (see NOTICE, LICENSE and COPYING). The simulator it bundles has its own licenses: V5 Simulacrum is LGPL-3.0-or-later, QEMU GPL-2.0-or-later, Python the PSF license. NOTICE lists them, and each package carries their license texts. VEX's firmware isn't included; the extension downloads it from VEX. |



