Accessing Components Settings
- Open launcher preferences
- Navigate to General tab
- Click Components to open the components management page
Wine Configuration
Wine (Wine Is Not an Emulator) provides Windows API compatibility on Linux.Selecting Wine Version
Currently active Wine version. The launcher includes multiple Wine builds optimized for gaming.
- Open Components settings
- Download desired Wine version from available list
- Select version from Selected Version dropdown
- Launcher will update the Wine prefix automatically
Changing Wine versions will update your Wine prefix. This process may take a few moments as the new Wine environment is initialized.
Available Wine Builds
The launcher provides access to multiple Wine variants:- Wine-GE: GloriousEggroll’s gaming-optimized Wine builds (recommended)
- Proton-GE: Valve’s Proton with community enhancements
- Lutris Wine: Lutris project’s gaming-focused builds
- Vanilla Wine: Official Wine releases
Wine Download Location
Wine builds are downloaded to:Wine Prefix
The Wine prefix (Windows environment) is located at:Do not manually modify the Wine prefix unless you understand Wine architecture. Incorrect changes can break game functionality.
Wine Options
Shared Libraries
Use system-installed Wine shared libraries instead of bundled libraries.Enable this if you have optimized Wine libraries installed system-wide. May improve compatibility or performance on some systems.
Use system GStreamer libraries for multimedia support.Useful if your system has GStreamer with additional codec support.
Drive Mapping
Map Wine’s virtual C: drive to a custom location.Advanced option for users who want to customize Wine filesystem structure.
Map game installation folder to a specific drive letter (A: through Z:).Default is G: drive. This affects how the game sees its installation path within Wine.
DXVK Configuration
DXVK translates DirectX 9/10/11 calls to Vulkan for better performance on Linux.Selecting DXVK Version
Currently active DXVK version.
- Open Components settings
- Scroll to DXVK section
- Download desired DXVK version
- Select version from dropdown
- DXVK will be installed to Wine prefix automatically
DXVK Installation Location
DXVK builds are stored in:Available DXVK Builds
- DXVK: Official DXVK releases
- DXVK-async: Async patch for reduced stuttering (community build)
- DXVK-GPlAsync: Additional async optimizations
Async DXVK variants can reduce shader compilation stuttering but are not officially supported by DXVK developers.
Filtering Component Versions
Show Recommended Only
By default, the components list shows only recommended versions (up to 6 per group). This filter can be disabled to view all available versions:- In Components settings, locate Recommended Only toggle
- Disable to see complete version history
- Enable to show only tested, stable releases
Using non-recommended versions may cause compatibility issues. Only use older or experimental versions if troubleshooting specific problems.
Managing Downloaded Components
Downloading Components
- Browse available Wine or DXVK versions
- Click download icon next to desired version
- Download progress shown in component row
- Downloaded components appear in selection dropdown
Deleting Components
- Locate downloaded component in list
- Click delete (trash) icon
- Component files removed from disk
- Cannot delete currently selected component
Deleting components frees disk space. An Anime Game requires significant Wine/DXVK storage (2-5 GB per Wine build).
Wine Synchronization
Configured in Enhancements → Wine section:- None: Standard Wine synchronization (lowest performance)
- ESync: Event-based synchronization (good performance, wide compatibility)
- FSync: Futex-based synchronization (best performance, requires kernel 5.16+)
Virtual Desktop Mode
Run game in Wine virtual desktop (separate Wine-managed window).
Virtual desktop width in pixels.
Virtual desktop height in pixels.
- Multi-monitor setups with focus issues
- Games that don’t properly handle fullscreen
- Need to constrain game to specific resolution
Troubleshooting
Wine Prefix Won’t Update
If Wine prefix update fails when changing versions:- Close launcher completely
- Backup Wine prefix:
cp -r ~/.local/share/anime-game-launcher/game/wine-prefix ~/.local/share/anime-game-launcher/game/wine-prefix.backup - Delete Wine prefix:
rm -rf ~/.local/share/anime-game-launcher/game/wine-prefix - Restart launcher - new prefix will be created
- Reselect Wine version
DXVK Installation Failed
If DXVK installation fails:- Check Wine prefix is healthy
- Try reselecting current Wine version to refresh prefix
- Download different DXVK version
- Check launcher debug log at
~/.local/share/anime-game-launcher/debug.log
Game Won’t Start After Component Update
- Revert to previous Wine/DXVK version
- Check game file integrity (General → Repair Game)
- Review launcher logs for error messages
- Ensure Wine prefix has write permissions
Always keep at least two Wine versions installed for fallback options in case of issues.