fix for that one thing

Step-by-step guide to run the FTC Virtual Robot emulator in Android Studio. No hardware required.

1 Install the Liberica JDK 17 Full

1. Go to bell-sw.com/pages/downloads
2. Select Version 17, Full JDK, and your OS (Windows or Mac)
3. Download and run the installer — accept all defaults

2 Install Android Studio

1. Go to developer.android.com/studio
2. Download and install with all defaults
3. When the Setup Wizard runs on first launch, let it complete fully — it downloads the Android SDK automatically
4. Click Next through all component prompts and wait for the install to finish before continuing

3 Clone the Repository

1. From the Android Studio Welcome screen, click Get from VCS
2. Make sure Git is selected on the left
3. Paste this URL into the URL field:

https://github.com/ARES-23247/virtual_robot.git

4. Leave the Directory field as the default, or choose your preferred location
5. Click Clone
6. If prompted “Trust this project?” — click Trust Project
7. Wait for Gradle to finish syncing — this can take several minutes the first time

4 Point Android Studio to Liberica JDK

1. Go to File → Project Structure
   Windows shortcut: Ctrl+Alt+Shift+S  |  Mac shortcut: Cmd+;
2. Click SDK Location on the left panel
3. Under JDK location, click the dropdown → Add JDK…
4. Navigate to the Liberica install folder:
   
   Windows: C:\Program Files\BellSoft\LibericaJDK-17-Full
   
   Mac: /Library/Java/JavaVirtualMachines/liberica-jdk-17-full.jdk/Contents/Home
5. Click OK — confirm the JDK location now shows the Liberica path
6. Click Apply → OK

5 Set the Run Configuration

1. Click the dropdown at the top toolbar — it may say app or No Configurations
2. Click Edit Configurations…
3. Click the + button → select Application
4. Fill in these three fields:

5. Click OK

6 Run the Emulator

1. Click Build → Rebuild Project and wait for it to finish with no errors
2. Click the green Run ▶ button, or press Shift+F10
3. The Virtual Robot window opens on your screen
4. In the Configurations dropdown — select Programming Board
5. In the OpModes dropdown — select any available OpMode
6. Click INIT then START

7 Where Students Write Their Code

Students only ever work inside the TeamCode module. Never touch Controller/ or virtual_robot/.

8 Creating a New OpMode

1. In the Project panel, expand TeamCode → src → org → firstinspires → ftc → teamcode
2. Right-click the teamcode folder → New → Java Class
3. Name your class (e.g. LJCh06)
4. Add @TeleOp(name="...") directly above the class declaration
5. Add extends OpMode to the class declaration
6. Click Build → Rebuild Project
7. Your new OpMode now appears in the emulator’s OpModes dropdown

! Troubleshooting