teraclassicctl installs and launches TERA Europe Classic+ on Arch Linux with
system Wine. It creates an isolated Wine prefix, uses the official Windows
launcher, and does not bundle proprietary game files or use Lutris.
Install the Arch packaging tools if they are not already available:
sudo pacman -Syu --needed base-devel gitClone this repository, then build and install the local package:
git clone https://github.com/bnema/teraclassicctl.git
cd teraclassicctl
makepkg -simakepkg -si installs the required Wine packages (wine, wine-mono, and
wine-gecko), builds the CLI, installs its desktop entry and icon, and installs
the package. By default, teraclassicctl uses wine from PATH; Wine 11 or
newer is required for that default. An alternate executable selected through
TERA_CLASSIC_WINE requires Wine 10 or newer.
Set TERA_CLASSIC_WINE to an absolute path when using another Wine build. Its
sibling wineboot executable is used for the same prefix. Set it when running
install so the generated desktop entry retains the selection.
For CachyOS Wine:
TERA_CLASSIC_WINE=/opt/wine-cachyos/bin/wine teraclassicctl installteraclassicctl doctor
teraclassicctl installinstall creates a 64-bit Wine prefix at ~/Games/tera-classic, downloads the
official launcher installer, and opens its Windows setup UI. Finish that setup,
then launch TERA Europe Classic+ from your desktop environment's application
menu. The launcher downloads and manages the game files.
| Purpose | Default location |
|---|---|
| Wine prefix and game files | ~/Games/tera-classic |
| Wrapper data | ~/.local/share/teraclassicctl |
| Installer cache | ~/.cache/teraclassicctl |
Set TERA_CLASSIC_GAME_DIR to use another absolute location:
TERA_CLASSIC_GAME_DIR=/path/to/tera-classic teraclassicctl installThe official launcher uses Microsoft WebView2. On Wine, its DirectComposition
renderer can produce a blank white or black window. Before installing or
launching, teraclassicctl configures Windows 7 compatibility only for the
msedgewebview2.exe subprocess. The launcher and game remain at the prefix's
normal Windows version.
TERA uses Direct3D 9. DXVK can translate that renderer to Vulkan, but it remains
opt-in. Install a DXVK package that provides /usr/share/dxvk/x64/d3d9.dll,
then enable it while the launcher and game are closed:
teraclassicctl install --dxvkFor an existing installation, use the explicit DXVK commands:
teraclassicctl dxvk status
teraclassicctl dxvk enable
teraclassicctl dxvk disableEnabling DXVK backs up Wine's original 64-bit d3d9.dll and sets the d3d9
Wine override to native,builtin. Disabling restores that original DLL. Neither
operation downloads, patches, or removes TERA game files.
teraclassicctl doctor # Check Wine and launcher installation
teraclassicctl clean # Remove wrapper cache and metadata only
teraclassicctl clean --all # Remove the wrapper-owned prefix and game filesclean --all refuses to remove a prefix that was not created by
teraclassicctl.
Use teraclassicctl launch only when diagnosing a launcher problem. Provide
the same TERA_CLASSIC_WINE value, if configured, so terminal output comes
from the Wine build used by the desktop entry:
TERA_CLASSIC_WINE=/opt/wine-cachyos/bin/wine teraclassicctl launchmake test
make vet
make buildmake build produces build/teraclassicctl. Use makepkg -si for a complete
local installation with desktop integration.
- Official launcher: https://launcher.tera-europe.net/classicplus/TERA%20Europe%20Classic+%20Launcher_0.2.208_x64-setup.exe
- Official game site: https://tera-europe-classic.com/
MIT