VM Setup

Run Effigy inside a virtual machine (VM) so it stays separate from the rest of your PC. This guide uses Hyper-V, which is built into Windows, and shares part of your graphics card with the VM so the game runs smoothly.

1-click setup

Effigy VM Setup does the steps of this guide for you. It checks the requirements, turns on Hyper-V (after the one restart this needs, it continues by itself), creates the VM from the Quick Create image or your own Windows ISO, shares your graphics card and copies its driver into the VM, and puts Effigy's setup file on the VM's desktop.

It shows everything it will change and asks before changing anything. Windows asks for administrator permission once.

Sign in to download Create account

Prefer to do it yourself? The manual steps follow below.

Manual setup

Sharing a graphics card is recommended, not required. Effigy can run without one using its built-in software rendering, so a VM without GPU partitioning still works; it is just slower and uses more CPU. To skip it, leave out steps 5 and 6.

It takes about an hour, most of it downloading and setting up Windows inside the VM. Run every command in PowerShell as administrator on your main PC (the host) unless a step says otherwise.

1. Check the requirements

2. Turn on Hyper-V

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Restart your PC when asked. Then check that your graphics card can be shared:

# Windows 11
Get-VMHostPartitionableGpu | Select-Object Name
# Windows 10
Get-VMPartitionableGpu | Select-Object Name

If nothing is listed, your graphics card or driver does not support sharing. Update the driver and try again; some laptop graphics chips are not supported.

3. Create the VM

Quick Create (recommended)

  1. Open Hyper-V Manager from the Start menu.
  2. In the Actions pane, choose Quick Create….
  3. Pick the Windows 11 image from the list, then choose Create Virtual Machine. Hyper-V downloads the image and creates the VM; this can take a while.

Quick Create makes a Generation 2 VM, which graphics card sharing needs. Keep in mind:

The commands in this guide use the VM name Effigy. Rename your new VM to match:

Rename-VM -Name "Windows 11 dev environment" -NewName "Effigy"   # use the name Hyper-V Manager shows

Alternative: use your own Windows ISO

Use a Windows installation ISO from Microsoft's Windows download page, the same Windows version as your PC, and a valid licence for it. In Quick Create you can choose Local installation source and select the ISO, or create the VM with PowerShell. Save the ISO as C:\ISO\Windows11.iso (or change the path below):

$vm = "Effigy"
New-Item -ItemType Directory -Force C:\VMs | Out-Null
New-VM -Name $vm -Generation 2 -MemoryStartupBytes 8GB -NewVHDPath "C:\VMs\$vm.vhdx" -NewVHDSizeBytes 80GB -SwitchName "Default Switch"
Set-VMKeyProtector -VMName $vm -NewLocalKeyProtector
Enable-VMTPM -VMName $vm
Add-VMDvdDrive -VMName $vm -Path "C:\ISO\Windows11.iso"
Set-VMFirmware -VMName $vm -FirstBootDevice (Get-VMDvdDrive -VMName $vm)

The TPM lines are needed for Windows 11.

Then, for either path

Give the VM 4 processors and 8 GB of fixed memory (it is shut down first):

$vm = "Effigy"
Stop-VM -Name $vm
Set-VMProcessor -VMName $vm -Count 4
Set-VMMemory -VMName $vm -DynamicMemoryEnabled $false -StartupBytes 8GB

4. Finish Windows setup in the VM

In Hyper-V Manager, double-click the Effigy VM and choose Start. A Quick Create image starts straight into Windows setup; with your own ISO, press a key when asked to boot from the DVD and install Windows as you would on a new PC.

When the Windows desktop appears, install Windows updates inside the VM, then shut the VM down from its Start menu.

Do not install the NVIDIA, AMD or Intel graphics driver inside the VM. The VM uses your PC's driver, which you copy in step 6.

5. Share your graphics card with the VM (recommended)

With the VM shut down, add a GPU partition and give it the memory it needs. Checkpoints and saved state do not work with a shared graphics card, so they are turned off here too:

$vm = "Effigy"
Stop-VM -Name $vm
Set-VM -Name $vm -CheckpointType Disabled -AutomaticCheckpointsEnabled $false -AutomaticStopAction ShutDown
Add-VMGpuPartitionAdapter -VMName $vm
Set-VMGpuPartitionAdapter -VMName $vm -MinPartitionVRAM 80000000 -MaxPartitionVRAM 100000000 -OptimalPartitionVRAM 100000000 -MinPartitionEncode 80000000 -MaxPartitionEncode 100000000 -OptimalPartitionEncode 100000000 -MinPartitionDecode 80000000 -MaxPartitionDecode 100000000 -OptimalPartitionDecode 100000000 -MinPartitionCompute 80000000 -MaxPartitionCompute 100000000 -OptimalPartitionCompute 100000000
Set-VM -Name $vm -GuestControlledCacheTypes $true -LowMemoryMappedIoSpace 1GB -HighMemoryMappedIoSpace 32GB

If your PC has more than one graphics card (for example Intel integrated graphics and an NVIDIA card), choose which one to share on Windows 11 by using its Name from step 2:

Add-VMGpuPartitionAdapter -VMName Effigy -InstancePath "<Name from Get-VMHostPartitionableGpu>"

6. Copy your graphics driver into the VM

The VM needs the same driver files your PC uses, placed in C:\Windows\System32\HostDriverStore inside the VM. First list your graphics cards to get the exact name:

Get-CimInstance Win32_VideoController | Select-Object Name

Then collect the driver files into C:\GpuDriverCopy. Put your card's name on the first line:

$GpuName = "NVIDIA GeForce RTX 3060"   # replace with your GPU's name, exactly as listed
$Out = "C:\GpuDriverCopy"
$driver = Get-CimInstance Win32_PnPSignedDriver | Where-Object DeviceName -eq $GpuName | Select-Object -First 1
$files = Get-CimAssociatedInstance -InputObject $driver -Association Win32_PnPSignedDriverCIMDataFile
foreach ($file in $files) {
  $path = $file.Name
  if ($path -like "*\DriverStore\FileRepository\*") {
    $folder = ($path -split "\\DriverStore\\FileRepository\\")[1].Split("\")[0]
    $target = "$Out\Windows\System32\HostDriverStore\FileRepository\$folder"
    if (-not (Test-Path $target)) {
      New-Item -ItemType Directory -Force (Split-Path $target) | Out-Null
      Copy-Item "C:\Windows\System32\DriverStore\FileRepository\$folder" $target -Recurse
    }
  } else {
    $target = Join-Path $Out $path.Substring(3)
    New-Item -ItemType Directory -Force (Split-Path $target) | Out-Null
    Copy-Item $path $target -Force
  }
}

The driver folder it copies is named after your card's maker:

Check that C:\GpuDriverCopy\Windows\System32\HostDriverStore\FileRepository contains that folder. With the VM still shut down, copy everything into the VM's disk:

$vhd = (Get-VMHardDiskDrive -VMName "Effigy" | Select-Object -First 1).Path
$letter = (Mount-VHD -Path $vhd -Passthru | Get-Disk | Get-Partition | Where-Object Type -eq "Basic" | Select-Object -First 1).DriveLetter
Copy-Item "C:\GpuDriverCopy\*" "$($letter):\" -Recurse -Force
Dismount-VHD -Path $vhd

Start the VM. In the VM's Device Manager, your graphics card should appear under Display adapters with no warning icon.

7. VM settings

Set-VMHost -EnableEnhancedSessionMode $true

Enhanced session connects through Remote Desktop. For the game to use the graphics card in that session, open gpedit.msc inside the VM, go to Computer Configuration → Administrative Templates → Windows Components → Remote Desktop Services → Remote Desktop Session Host → Remote Session Environment, set Use hardware graphics adapters for all Remote Desktop Services sessions to Enabled, then restart the VM.

8. Install Effigy in the VM

  1. Inside the VM, open a browser and go to effigybot.com/download.
  2. Sign in, download the setup file, run it and accept the Windows prompt.
  3. Open Effigy from the Start menu and choose Sign in to Effigy.

Troubleshooting

Code 43 on the graphics card in the VM's Device Manager
The driver files in the VM do not match your PC's driver. Shut the VM down, delete C:\GpuDriverCopy, and repeat step 6. Also check that the VM runs the same Windows version as your PC and that you did not install a graphics driver inside the VM; if you did, uninstall it in the VM and repeat step 6.
Black screen in the VM window
Wait a minute after start-up, then choose View and turn Enhanced session off to use the basic view. If the screen stays black, shut the VM down from Hyper-V Manager, check that you ran the Set-VM … -LowMemoryMappedIoSpace line in step 5, and start it again.
The game is slow or uses the CPU only
Check that the graphics card shows in the VM's Task Manager under Performance. In an enhanced session, make sure the Remote Desktop setting in step 7 is enabled.
The VM will not start after adding the GPU
Make sure checkpoints are off and Dynamic Memory is off, then try again. If it still fails, remove the partition with Remove-VMGpuPartitionAdapter -VMName Effigy and repeat step 5.
After you update your graphics driver
Each driver update on your PC needs a fresh copy in the VM. Shut the VM down, delete C:\GpuDriverCopy, and repeat step 6. Before copying, you can delete the old driver folder from C:\Windows\System32\HostDriverStore\FileRepository inside the VM.