Skip to main content
The Enhancements tab provides advanced options to optimize game performance, enable special features, and manage game sessions.

​
Game Sessions

Game sessions allow you to maintain multiple independent game configurations and switch between them.

​
Creating Sessions

  1. Open Preferences → Enhancements → Game
  2. Enter session name in the text field
  3. Click Add button
  4. Session is created with current Wine prefix snapshot
​
sessions
object
Game sessions stored in ~/.local/share/anime-game-launcher/game/sessions/.Each session contains a complete Wine prefix backup allowing you to maintain separate configurations, mods, or settings.

​
Switching Sessions

  1. Click on desired session in the list
  2. Session Wine prefix is applied to game
  3. Current session is marked with radio button

​
Managing Sessions

​
sessions.update
action
Update Session: Click refresh icon to save current Wine prefix state to session
​
sessions.delete
action
Delete Session: Click trash icon to remove session and its data
Sessions consume disk space (each contains full Wine prefix ~1-2 GB). Use sessions for significantly different configurations, not minor changes.

​
Sandbox Settings

The launcher can sandbox the game using bubblewrap for enhanced security and isolation.

​
Enabling Sandbox

​
sandbox.enabled
boolean
default:"false"
Enable game sandboxing using bubblewrap.Requires bubblewrap package installed on your system.
​
sandbox.isolate_home
boolean
default:"false"
Hide home directory from game process.Game will not have access to files in your home directory outside its own folders.

​
Sandbox Configuration

​
sandbox.hostname
string
Custom hostname visible to sandboxed game.Leave empty to use system hostname.
​
sandbox.args
string
Additional bubblewrap command-line arguments.See bwrap documentation for available options.

​
Private Directories

​
sandbox.private
array
Directories to make private (empty) within sandbox.Game will see these directories as empty, even if they contain files on your system.
To add private directory:
  1. Enter directory path (e.g., /home/user/Documents)
  2. Click Add button
  3. Directory will be hidden from game

​
Shared Directories

​
sandbox.mounts.bind
object
Directories to share (mount) into sandbox with read-write access.
​
sandbox.mounts.read_only
object
Directories to share into sandbox with read-only access.
To share directory:
  1. Original Path: Source directory on your system
  2. New Path: Target path within sandbox
  3. Read Only: Toggle for read-only access
  4. Click Add button
Example: Share ~/Screenshots as /data/screenshots (read-only)
​
sandbox.mounts.symlinks
object
Symbolic links to create within sandbox.
To create symlink:
  1. Original Path: Link target
  2. New Path: Link path within sandbox
  3. Click Add
Sandboxing is an advanced feature. Incorrect configuration may prevent game from launching. Start with minimal restrictions and add more as needed.

​
Environment Variables

Custom environment variables can be set for the game process.

​
Adding Environment Variables

  1. Open Preferences → Enhancements → Environment
  2. Name: Variable name (e.g., DXVK_HUD)
  3. Value: Variable value (e.g., fps)
  4. Click Add button
​
game.environment
object
Key-value pairs of environment variables passed to game.

​
Common Environment Variables

DXVK Configuration: 
DXVK_HUD=fps,memory,gpuload
DXVK_LOG_LEVEL=info
DXVK_STATE_CACHE_PATH=/path/to/cache
Mesa/Vulkan: 
MESA_SHADER_CACHE_DIR=/path/to/cache
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/nvidia_icd.json
Wine: 
WINEDEBUG=-all
WINEDLLOVERRIDES=dxgi=n,b
Environment variables can significantly affect game behavior. Only add variables if you understand their purpose.

​
Game Command

​
game.command
string
Custom command wrapper for launching game.Use %command% placeholder for the game executable. The launcher will replace this with actual launch command.
Example commands: 
# Run with custom environment
env CUSTOM_VAR=value %command%

# Launch with debugger
gdb -ex run --args %command%

# Use custom Wine build
/path/to/custom/wine %command%

# Add command-line arguments
%command% --custom-arg
Game command is an advanced feature for debugging or using custom launchers. Incorrect command will prevent game from starting.

​
HUD Overlays

​
game.enhancements.hud
enum
default:"None"
On-screen performance overlay:
  • None: No overlay
  • DXVK: Built-in DXVK statistics (FPS, frame time, memory)
  • MangoHud: Advanced monitoring (requires mangohud package)

​
DXVK HUD

Minimal overlay showing:
  • FPS (frames per second)
  • Frame time
  • GPU/CPU load
  • Memory usage
Configured via DXVK_HUD environment variable.

​
MangoHud

Advanced overlay with:
  • Detailed frame timing graphs
  • CPU/GPU temperature
  • Per-core CPU usage
  • VRAM usage
  • Customizable layout
Configure in ~/.config/MangoHud/MangoHud.conf

​
FidelityFX Super Resolution (FSR)

AMD FSR upscaling technology for improved performance.
​
game.enhancements.fsr.enabled
boolean
default:"false"
Enable FSR upscaling.Game renders at lower resolution and FSR upscales to target resolution, improving performance with minimal quality loss.
​
game.enhancements.fsr.quality
enum
default:"Balanced"
FSR quality mode:
  • Ultra Quality: 1.3x upscaling (77% render resolution)
  • Quality: 1.5x upscaling (67% render resolution)
  • Balanced: 1.7x upscaling (59% render resolution)
  • Performance: 2.0x upscaling (50% render resolution)
FSR works best at higher display resolutions (1440p, 4K). At 1080p, quality differences are more noticeable.

​
GameMode

​
game.enhancements.gamemode
boolean
default:"false"
Enable Feral GameMode.Optimizes CPU governor, I/O priority, and scheduler for gaming. Requires gamemode package.
GameMode provides:
  • CPU frequency scaling optimization
  • Higher process priority
  • Disabled screen saver during gaming
  • GPU performance mode
Check if GameMode is active: 
gamemoded -s

​
Gamescope

Micro-compositor for game windows with advanced features.
​
game.enhancements.gamescope.enabled
boolean
default:"false"
Run game through Gamescope compositor.Requires gamescope package. Provides better resolution handling, upscaling, and frame pacing.

​
Gamescope Settings

Click the settings icon next to Gamescope toggle to configure:
​
game.enhancements.gamescope.window_mode
enum
default:"Default"
Window mode:
  • Default: Standard windowed mode
  • Borderless: Borderless fullscreen
  • Fullscreen: Exclusive fullscreen
  • Headless: No window (for testing)
​
game.enhancements.gamescope.game_window
object
Game render resolution (internal resolution).
  • Width: Game rendering width
  • Height: Game rendering height
​
game.enhancements.gamescope.gamescope_window
object
Output window resolution (display resolution).Gamescope upscales game_window to gamescope_window resolution.
​
game.enhancements.gamescope.framerate.focused
number
Frame rate limit when window is focused.
​
game.enhancements.gamescope.framerate.unfocused
number
Frame rate limit when window is not focused.

​
Gamescope Example Configuration

1080p to 4K upscaling:
  • Game Window: 1920x1080
  • Gamescope Window: 3840x2160
  • Framerate: 60 (focused), 30 (unfocused)
720p low-end system:
  • Game Window: 1280x720
  • Gamescope Window: 1920x1080
  • Framerate: 60

​
FPS Unlocker

Removes the game’s 60 FPS limit.
​
game.enhancements.fps_unlocker.enabled
boolean
default:"false"
Enable FPS unlocker.Allows game to run at higher frame rates for smoother gameplay.
​
game.enhancements.fps_unlocker.config.fps
number
default:"120"
Target FPS limit.Common values: 90, 120, 144, 165, 180, 240
​
game.enhancements.fps_unlocker.config.interval
number
default:"5000"
Check interval in milliseconds.How often the unlocker verifies FPS settings (1000-60000 ms recommended).
Important: Higher FPS requires more powerful hardware. Monitor temperatures and performance. Some users report FPS unlocking may violate game terms of service.

​
Performance Tips

​
Best Settings for Performance

  1. Wine Sync: FSync (requires modern kernel)
  2. DXVK: Latest recommended async version
  3. FSR: Balanced or Performance mode
  4. GameMode: Enabled
  5. FPS Unlocker: Match monitor refresh rate
  6. HUD: None or minimal DXVK HUD

​
Best Settings for Quality

  1. FSR: Ultra Quality or disabled
  2. FPS Unlocker: 60 FPS (game default)
  3. Wine: Latest Wine-GE
  4. Virtual Desktop: Disabled for native fullscreen

​
Troubleshooting Performance

If experiencing poor performance:
  1. Disable all enhancements
  2. Test game with defaults
  3. Enable enhancements one at a time
  4. Monitor with MangoHud to identify bottlenecks
  5. Check ~/.local/share/anime-game-launcher/debug.log for errors

Build docs developers (and LLMs) love

Get started for freeTalk to us