Documentation

Getting Started

GenovaLauncher is a graphical launcher for Minecraft: Bedrock Edition on Linux. It wraps the mcpelauncher project in a modern PySide6 (Qt6) interface, making it easy to install, manage and play multiple versions of Minecraft Bedrock.

To start, download the latest release and run ./GenovaLauncher.sh. On first launch, the launcher will detect your installation and scan for available versions.

Installation

Portable Release

$wget https://github.com/Ars-byte/GenovaLauncher-launcher/releases/latest/download/GenovaLauncher-v1.0.0.tar.gz

$tar xzf GenovaLauncher-v1.0.0.tar.gz && cd GenovaLauncher-v1.0.0

$./GenovaLauncher.sh

From Source

$git clone https://github.com/Ars-byte/GenovaLauncher-launcher.git

$cd GenovaLauncher-launcher

$python3 -m venv venv && source venv/bin/activate

$pip install -r requirements.txt && ./run.sh

Void Linux (xbps)

$xbps-rindex -a genovalauncher-1.0.0_1.x86_64.xbps

$doas xbps-install -R $PWD genovalauncher

Debian/Ubuntu (.deb)

$sudo dpkg -i genovalauncher-1.1.1-amd64.deb

$sudo apt install -f

NixOS

# flake.nix

inputs.genovalauncher.url = "github:Ars-byte/GenovaLauncher-launcher";

# configuration.nix

environment.systemPackages = [ inputs.genovalauncher.packages.${system}.default ];

$sudo nixos-rebuild switch

Configuration

Go to Settings to configure binary paths. The launcher automatically detects mcpelauncher binaries in common locations. If not found, it will download them automatically.

Configure your Appearance (theme, colors, background, opacity, sticker/watermark) and Launch options (GameMode, Zink, custom environment variables).

Managing Versions

Use the Tools tab to install new Minecraft Bedrock versions from APK files or Google Play. Each version appears in the Play tab where you can launch it, create shortcuts, or manage its icon.

Versions installed from Google Play may require the DRM mod. The launcher will prompt you to install it automatically.

Resources & Mods

The Resource Manager lets you manage resource packs (RP), behavior packs (BP), skins, and worlds. Import .mcpack files or folders, enable/disable packs per version, and create skin packs.

Mods from the official mcpelauncher-moddb repository can be browsed and installed directly from the launcher.

Profiles

Create independent profiles to keep worlds, settings, and data separate. Profiles use symbolic links for efficient storage. Switch profiles from the Play tab.

Performance

GenovaLauncher automatically applies Mesa optimizations:

`mesa_glthread=true`	Multi-threaded GL dispatch
`MESA_SHADER_CACHE`	Persistent shader cache
`MESA_NO_ERROR=1`	Skip GL error checks
`ANV_SPARSE=1`	Sparse memory for Intel

Enable Zink (OpenGL over Vulkan) in Settings > Compatibility for additional performance gains on modern GPUs.

Troubleshooting

Microsoft Login Error (0x80070057)

This error occurs when Qt6 WebEngine is missing. Install the required packages:

# Void Linux

$doas xbps-install -y qt6-webengine qt6-declarative qt6-webchannel qt6-position

# Debian/Ubuntu

$sudo apt install qt6-webengine-dev qt6-declarative-dev libqt6webchannel6

# Arch

$sudo pacman -S qt6-webengine qt6-declarative qt6-webchannel

Game won't launch

Ensure mcpelauncher binaries are present and the correct paths are configured in Settings. Check that the APK version matches your architecture (x86_64).

Poor performance

Enable Zink mode in Settings > Compatibility. Ensure your GPU drivers are up to date. Check that mesa_glthread=true is active in the launch log.