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
- Windows' own first-start screens inside the VM (region, keyboard, account) are not done for you; complete them when the VM starts.
- To only see what it would change, run
EffigyVMSetup.exe --dry-run. To delete the VM it created, runEffigyVMSetup.exe --remove. - Running it again is safe: it only does what is still missing, for example copying the driver again after a graphics driver update.
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
- Windows 10 or 11 Pro, Enterprise or Education (Windows 10 version 2004 or later). Windows Home does not include Hyper-V. Check under Settings → System → About.
- Virtualization turned on in your BIOS/UEFI. It is called Intel VT-x (Intel Virtualization Technology) or AMD-V / SVM Mode. In Task Manager, open Performance → CPU and look for Virtualization: Enabled.
- A supported graphics card with a recent driver:
- NVIDIA: GeForce GTX 10 series or newer, with a current Game Ready or Studio driver.
- AMD: Radeon RX 5000 series or newer works best, with a current Adrenalin driver.
- Intel: Intel UHD or Iris Xe integrated graphics, with a current Intel graphics driver.
- At least 16 GB of RAM on your PC (the VM uses 8 GB) and about 80 GB of free disk space.
- Windows for the VM: Hyper-V Quick Create can download a Windows 11 image for you, or you can use your own Windows ISO. Use the same Windows version as your PC (Windows 11 on a Windows 11 PC).
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)
- Open Hyper-V Manager from the Start menu.
- In the Actions pane, choose Quick Create….
- 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 gallery image may be an evaluation or developer edition of Windows that expires. Before it does, activate it with a valid Windows licence or replace the VM.
- Which images the gallery offers can vary and change over time. If there is no Windows 11 image, use your own ISO below.
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:
- NVIDIA: starts with
nv_dispi.inf_amd64_(laptops:nvlti.inf_amd64_or similar). - AMD: starts with
u0, for exampleu0398271.inf_amd64_. - Intel: starts with
iigd_dch.inf_amd64_.
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
- Memory: keep it fixed (Dynamic Memory off). 8 GB is enough for one or two clients; add about 2 GB for each extra client in Settings → Memory while the VM is shut down.
- Checkpoints: keep them off. A VM with a shared graphics card cannot take checkpoints or save its state; shut it down instead of pausing it.
- Enhanced session: lets you resize the VM window, use the clipboard and copy files in. Turn it on for your PC, then choose View → Enhanced session in the VM window:
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
- Inside the VM, open a browser and go to effigybot.com/download.
- Sign in, download the setup file, run it and accept the Windows prompt.
- 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 … -LowMemoryMappedIoSpaceline 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 Effigyand 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 fromC:\Windows\System32\HostDriverStore\FileRepositoryinside the VM.