| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:windows [2026/01/18 18:21] – wine:toolbox crcerror | systems:windows [2026/01/22 10:28] (current) – Document Wine configuration options with FIXME badges ssokolow |
|---|
| This ''<game name>.wine'' folder is called the wineprefix. | This ''<game name>.wine'' folder is called the wineprefix. |
| |
| ==== Use the WINE.toolbox for setup (v43) and a clean structures ==== | ===== Use the WINE.toolbox for setup (v43) and a clean structures ===== |
| |
| Please read and understand the text written above as this reflects the basics how to setup WINE games. Since **v43** the process of creating the ''autorun.cmd'', managing prefixes, compressing games, extraction of games is made with more convenience. | Please read and understand the text written above as this reflects the basics how to setup WINE games. Since **v43** the process of creating the ''autorun.cmd'', managing prefixes, compressing games, extraction of games is made with more convenience. |
| * If you symlink a wine runner you can use ''win32-<wine runner>'' the word ''win32-'' will enable the build of 32bit prefixes if this runner is selected. This also helps to keep things tidy and separated. | * If you symlink a wine runner you can use ''win32-<wine runner>'' the word ''win32-'' will enable the build of 32bit prefixes if this runner is selected. This also helps to keep things tidy and separated. |
| </WRAP> | </WRAP> |
| |
| | |
| |
| ===== Emulators ===== | ===== Emulators ===== |
| | **VIRTUAL DESKTOP ''windows.virtual_desktop''** | Define the resolution and a new dedicated window.\\ => Off ''0'', On ''1''. | | | **VIRTUAL DESKTOP ''windows.virtual_desktop''** | Define the resolution and a new dedicated window.\\ => Off ''0'', On ''1''. | |
| | **ENABLE MOUSE ''windows.force_mouse''** | Show the cursor.\\ => Off ''0'', On ''1''. | | | **ENABLE MOUSE ''windows.force_mouse''** | Show the cursor.\\ => Off ''0'', On ''1''. | |
| | **ENABLE XIM ''windows.allow_xim''** | Enable XIM support. (FIXME what's XIM?)\\ => Off ''0'', On ''1''. | | | **ENABLE XIM ''windows.allow_xim''** | Enable [[https://en.wikipedia.org/wiki/X_Input_Method|XIM]] support. => Off ''0'', On ''1''. | |
| | **NO WRITE WATCH ''windows.no_write_watch''** | Disable support for memory write watches in ntdll. (FIXME what is this used for?)\\ => Off ''0'', On ''1''. | | | **NO WRITE WATCH ''windows.no_write_watch''** | Disable support for memory write watches in ntdll. (Dangerous speed hack. Only for specific game engines which don't need them [[https://github.com/Valloric/proton-ge-custom?tab=readme-ov-file#modification|such as CoreRT]].)\\ => Off ''0'', On ''1''. | |
| | **FORCE LARGE ADDRESS ''windows.force_large_adress''** | Force WINE to run games with large address. (FIXME what is this used for?)\\ => Off ''0'', On ''1''. | | | **FORCE LARGE ADDRESS ''windows.force_large_adress''** | Pretend that 32-bit .exe files have their Large Address Aware flag set. (Grants non-LAA 32-bit games access to as much as 4GiB of RAM instead of 2GiB. May fix OOM crashes or improve performance but could also cause crashes if the game has certain kinds of signed/unsigned sloppiness in its memory handling. Note that upstream Proton considers it safe to have this enabled by default.)\\ => Off ''0'', On ''1''. | |
| | **HEAP DELAY FREE ''windows.heap_delay_free''** | Delay freeing some memory. (FIXME what is this used for?)\\ => Off ''0'', On ''1''. | | | **HEAP DELAY FREE ''windows.heap_delay_free''** | Delay freeing some memory. (Workaround for games with use-after-free bugs (eg. [[https://www.joelonsoftware.com/2000/05/24/strategy-letter-ii-chicken-and-egg-problems/|SimCity for Windows 3.x]]) which would be applied automatically by Windows's bundled AppCompat database.)\\ => Off ''0'', On ''1''. | |
| | **HIDE NVIDIA GPU ''windows.hide_nvidia_gpu''** | Force Nvidia GPUs to always be reported as AMD GPUs. (FIXME what is this used for?)\\ => Off ''0'', On ''1''. | | | **HIDE NVIDIA GPU ''windows.hide_nvidia_gpu''** | Force Nvidia GPUs to always be reported as AMD GPUs. (For games which would otherwise expect nVidia features too new for the Wine/driver/etc. version Batocera uses.)\\ => Off ''0'', On ''1''. | |
| | **ENABLE DEBUG ''windows.wine_debug''** | Enable wine debug. (FIXME be more descriptive)\\ => Off ''0'', On ''1''. | | | **ENABLE DEBUG ''windows.wine_debug''** | Enable wine's debug logging. (Useful for identifying what compatibility settings or winetricks need to be applied or for filing Wine/Proton bug reports.)\\ => Off ''0'', On ''1''. | |
| |
| Advanced options will only be applied on the first launch of the game. Adjusting these values later will not do anything. | Advanced options will only be applied on the first launch of the game. Adjusting these values later will not do anything. |
| A list of WINEtricks commands and more detail about using WINEtricks with Batocera is available [[emulators:winetricks|right here]]. | A list of WINEtricks commands and more detail about using WINEtricks with Batocera is available [[emulators:winetricks|right here]]. |
| |
| If a game needs several tricks you can add as many trick commands as you like (since v43(, so you don't need to call the command every time | If a game needs several tricks you can add as many trick commands as you like (since v43), so you don't need to call the command every time |
| |
| batocera-wine windows tricks /userdata/roms/windows/aok.wine directplay vb5run vb6run | batocera-wine windows tricks /userdata/roms/windows/aok.wine directplay vb5run vb6run |