Skip to main content
The An Anime Game Launcher uses Wine and DXVK to run the Windows game client on Linux. This page covers configuration of these critical compatibility components.

Accessing Components Settings

  1. Open launcher preferences
  2. Navigate to General tab
  3. 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

game.wine.selected
string
Currently active Wine version. The launcher includes multiple Wine builds optimized for gaming.
To change Wine version:
  1. Open Components settings
  2. Download desired Wine version from available list
  3. Select version from Selected Version dropdown
  4. 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
Recommended versions are highlighted in the list. The launcher shows up to 6 recommended versions per Wine group.

Wine Download Location

Wine builds are downloaded to:
~/.local/share/anime-game-launcher/game/wine/

Wine Prefix

The Wine prefix (Windows environment) is located at:
~/.local/share/anime-game-launcher/game/wine-prefix/
Do not manually modify the Wine prefix unless you understand Wine architecture. Incorrect changes can break game functionality.

Wine Options

Shared Libraries

game.wine.shared_libraries.wine
boolean
default:"false"
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.
game.wine.shared_libraries.gstreamer
boolean
default:"false"
Use system GStreamer libraries for multimedia support.Useful if your system has GStreamer with additional codec support.

Drive Mapping

game.wine.drives.drive_c
boolean
default:"false"
Map Wine’s virtual C: drive to a custom location.Advanced option for users who want to customize Wine filesystem structure.
game.wine.drives.game_folder
string
default:"G:"
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

game.dxvk.selected
string
Currently active DXVK version.
To change DXVK version:
  1. Open Components settings
  2. Scroll to DXVK section
  3. Download desired DXVK version
  4. Select version from dropdown
  5. DXVK will be installed to Wine prefix automatically

DXVK Installation Location

DXVK builds are stored in:
~/.local/share/anime-game-launcher/game/dxvk/
When selected, DXVK DLLs are installed into the Wine prefix:
~/.local/share/anime-game-launcher/game/wine-prefix/drive_c/windows/system32/

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

By default, the components list shows only recommended versions (up to 6 per group). This filter can be disabled to view all available versions:
  1. In Components settings, locate Recommended Only toggle
  2. Disable to see complete version history
  3. 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

  1. Browse available Wine or DXVK versions
  2. Click download icon next to desired version
  3. Download progress shown in component row
  4. Downloaded components appear in selection dropdown

Deleting Components

  1. Locate downloaded component in list
  2. Click delete (trash) icon
  3. Component files removed from disk
  4. 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:
game.wine.sync
enum
default:"FSync"
  • None: Standard Wine synchronization (lowest performance)
  • ESync: Event-based synchronization (good performance, wide compatibility)
  • FSync: Futex-based synchronization (best performance, requires kernel 5.16+)
Recommendation: Use FSync if your kernel supports it (most modern distributions). Fall back to ESync on older kernels.

Virtual Desktop Mode

game.wine.virtual_desktop.enabled
boolean
default:"false"
Run game in Wine virtual desktop (separate Wine-managed window).
game.wine.virtual_desktop.width
number
default:"1920"
Virtual desktop width in pixels.
game.wine.virtual_desktop.height
number
default:"1080"
Virtual desktop height in pixels.
Common presets: 1920x1080, 2560x1440, 3840x2160 When to use virtual desktop:
  • 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:
  1. Close launcher completely
  2. Backup Wine prefix: cp -r ~/.local/share/anime-game-launcher/game/wine-prefix ~/.local/share/anime-game-launcher/game/wine-prefix.backup
  3. Delete Wine prefix: rm -rf ~/.local/share/anime-game-launcher/game/wine-prefix
  4. Restart launcher - new prefix will be created
  5. Reselect Wine version

DXVK Installation Failed

If DXVK installation fails:
  1. Check Wine prefix is healthy
  2. Try reselecting current Wine version to refresh prefix
  3. Download different DXVK version
  4. Check launcher debug log at ~/.local/share/anime-game-launcher/debug.log

Game Won’t Start After Component Update

  1. Revert to previous Wine/DXVK version
  2. Check game file integrity (General → Repair Game)
  3. Review launcher logs for error messages
  4. Ensure Wine prefix has write permissions
Always keep at least two Wine versions installed for fallback options in case of issues.

Build docs developers (and LLMs) love