Skip to main content
The An Anime Game Launcher provides extensive configuration options to customize your gaming experience. Settings are organized into two main categories: General and Enhancements.

Configuration Location

All launcher settings are stored in:
~/.local/share/anime-game-launcher/
The configuration file is automatically saved when you close the preferences window.
Changes to settings are applied immediately, but some options (like Wine version changes) may require the launcher to be restarted.

General Settings

The General tab contains core launcher configuration:

Appearance

launcher.style
enum
default:"Modern"
Choose between Modern or Classic launcher styles. Classic style includes a custom background image.
  • Modern: Clean, minimal interface with system theme integration
  • Classic: Traditional launcher with custom background artwork
launcher.language
string
Launcher interface language. Supports multiple languages including English, Chinese, Japanese, Korean, and more.

Game Configuration

launcher.edition
enum
default:"Global"
Game edition to launch:
  • Global: International version (Hoyoverse)
  • China: Chinese mainland version
launcher.environment
enum
default:"PC"
Game environment type:
  • Hoyoverse: PC client
  • Google Play: Android client emulation
game.voices
array
Installed voice-over packages. Supports:
  • English (en-us)
  • Japanese (ja-jp)
  • Korean (ko-kr)
  • Chinese (zh-cn)

Launcher Behavior

launcher.behavior
enum
default:"Nothing"
Action when launching the game:
  • Nothing: Keep launcher window open
  • Hide: Minimize launcher to system tray
  • Close: Exit launcher completely

Components

Access the Components page to manage Wine and DXVK versions. See Wine and DXVK Configuration for details.

Wine Tools

Quick access to Wine utilities:
  • Command Line (wineconsole): Wine console terminal
  • Registry Editor (regedit): Windows registry editor
  • Explorer (explorer): File browser
  • Task Manager (taskmgr): Process manager
  • Configuration (winecfg): Wine settings
  • Debugger (winedbg): Wine debugger

Enhancements Settings

The Enhancements tab provides advanced game optimization options:

Wine Configuration

game.wine.sync
enum
default:"FSync"
Synchronization method for improved performance:
  • None: No special synchronization
  • ESync: Event-based synchronization
  • FSync: Futex-based synchronization (best performance)
game.wine.language
enum
default:"System"
Wine environment language. Can be set independently from launcher language.
game.wine.borderless
boolean
default:"false"
Enable borderless window mode for the game.
game.wine.virtual_desktop.enabled
boolean
default:"false"
Run game in a virtual desktop. Useful for multi-monitor setups.

Game Enhancements

game.enhancements.hud
enum
default:"None"
On-screen display overlay:
  • None: No overlay
  • DXVK: DXVK performance statistics
  • MangoHud: Advanced performance monitoring
game.enhancements.fsr.enabled
boolean
default:"false"
Enable AMD FidelityFX Super Resolution upscaling for improved performance.
game.enhancements.fsr.quality
enum
default:"Balanced"
FSR quality preset:
  • Ultra Quality: Best image quality
  • Quality: Balanced quality
  • Balanced: Performance/quality balance
  • Performance: Best performance
game.enhancements.gamemode
boolean
default:"false"
Enable Feral GameMode for optimized CPU scheduling. Requires gamemode package.
game.enhancements.gamescope.enabled
boolean
default:"false"
Run game through Gamescope compositor. Requires gamescope package.

FPS Unlocker

game.enhancements.fps_unlocker.enabled
boolean
default:"false"
Unlock game framerate beyond default 60 FPS limit.
game.enhancements.fps_unlocker.config.fps
number
default:"120"
Target framerate. Common values: 90, 120, 144, 165, 180, 240.
Using the FPS unlocker may increase resource usage. Ensure your system can handle the target framerate.

Advanced Settings

For advanced configuration options, see:

Repairing Game Files

The launcher includes a game repair utility accessible from the General settings:
  1. Open Preferences → General
  2. Click Repair Game button
  3. Launcher will verify and repair corrupted game files
Game repair requires downloading files and may take significant time depending on the extent of corruption.

Build docs developers (and LLMs) love