Windows Environment Setup for Tradecraft Garden and Crystal Palace

Windows Subsystem for Linux is an ideal environment for Tradecraft Garden projects and Crystal Palace. This document walks through how to setup a base environment that can run the Crystal Palace linker and compile Tradecraft Garden examples. It's pretty easy.

Step 1. Install Windows Subsystem for Linux

Open an elevated PowerShell (or command) prompt and type:

wsl --install

Tips

During this process, you will need to reboot your computer once. The install will automatically resume on reboot. And, at one point, it may hang at 0% for awhile. Leave it alone. It's not broken. It's just confusing.

If you're running Windows 10 or 11 from a Virtual Machine, make sure to enable nested virtualization (e.g., VT-x, AMD-v) for the VM.

Step 2. Setup Java and MinGW-w64 in your WSL environment

a. Open the "Ubuntu" application on Windows

b. Type:

sudo apt-get update
sudo apt-get install mingw-w64
sudo apt-get install make
sudo apt-get install openjdk-11-jdk

Type 'y' when prompted to confirm install each of the above. Congrats. You now have all the needed development tools.

Tips

• The Windows c:\ drive is available via /mnt/c
• You can run Windows executables from the WSL Ubuntu environment

Step 3. Install Windows Terminal

a. Visit the Microsoft App store

b. Search for Windows Terminal

c. Install it.

The above is optional, but it's a huge quality of life step. You now have a tabbed terminal that can run PowerShell, Linux, and the Windows command prompt side-by-side.

Step 4. Update Windows Defender settings

a. Open the Windows Defender settings

b. Disable Cloud protection

c. Disable automatic sample submission

d. Optional: add an exclusion for the folder where your Tradecraft Garden files will live (e.g., c:\tcg)

e. Optional: add an exclusion for the run.x86.exe and run.x64.exe process names