s8n/minecraft-launcher
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
minecraft-launcher/BUILD_GUIDE.md

4.4 KiB
Raw Blame History

Racked.ru PrismLauncher - Build Guide

Minimal, custom-themed PrismLauncher build with racked.ru branding and portable mode support.

Features

  • Minimal theme: Black and red racked.ru theme
  • Portable mode: USB-friendly, no installation required
  • Stripped resources: Removed unused themes to reduce size
  • Cross-platform: Windows, macOS, and Linux support
  • Custom background: racked_ru catpack background

Prerequisites

Windows

  • Visual Studio 2022 (Community Edition or higher)
  • Qt 6.5.3 or later (MSVC 2019 64-bit)
  • CMake 3.25 or later
  • Git

Install Qt using the online installer:

1. Download Qt Online Installer from qt.io
2. Install Qt 6.5.3 -> MSVC 2019 64-bit
3. Make sure to include Qt Network Authentication and Qt SVG modules

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install build-essential cmake qt6-base-dev qt6-tools-dev \
    qt6-image-formats-plugins qt6-networkauth-dev zlib1g-dev libgl1-mesa-dev

Linux (Fedora)

sudo dnf install gcc-c++ cmake qt6-qtbase-devel qt6-qttools-devel \
    qt6-qtimageformats qt6-qtnetworkauth-devel zlib-devel mesa-libGL-devel

macOS

# Install Xcode Command Line Tools
xcode-select --install

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install cmake qt6

Building

Quick Build (Current Platform)

# Clone the repository
git clone <your-repo-url>
cd prismlauncher-racked

# Run the build script
bash scripts/build-all-platforms.sh

Platform-Specific Builds

Windows (Run in Developer Command Prompt or PowerShell)

scripts\build-windows-portable.bat

Linux/macOS

chmod +x scripts/build-linux-portable.sh  # Linux only
chmod +x scripts/build-macos-portable.sh  # macOS only
bash scripts/build-linux-portable.sh      # Linux
bash scripts/build-macos-portable.sh      # macOS

Output

Builds are placed in the release/ directory:

  • release/Racked.ru-PrismLauncher-Windows-Portable/ - Windows portable
  • release/Racked.ru-PrismLauncher-Linux-Portable/ - Linux portable
  • release/Racked.ru-PrismLauncher-macOS-Portable/ - macOS portable

Creating Distribution Archives

Windows (PowerShell):

cd release\Racked.ru-PrismLauncher-Windows-Portable
Compress-Archive -Path * -DestinationPath ..\racked-prismlauncher-windows-portable.zip

Linux:

cd release/Racked.ru-PrismLauncher-Linux-Portable
tar czf ../racked-prismlauncher-linux-portable.tar.gz .

macOS:

cd release/Racked.ru-PrismLauncher-macOS-Portable
tar czf ../racked-prismlauncher-macos-portable.tar.gz PrismLauncher.app run.sh

Portable Mode

The launcher includes portable.txt which enables portable mode. This makes the launcher store all data (instances, settings, etc.) in the same directory as the executable, making it perfect for USB drives.

To disable portable mode, simply delete portable.txt from the installation directory.

Custom Theme

The launcher uses a custom racked.ru theme with:

  • Black background (#000000)
  • White text (#ffffff)
  • Red accents (#ff0000, #CD001F)
  • Minimal UI elements
  • Custom catpack background (racked_ru.png)

Stripped Components

To minimize size, the following have been removed:

  • All default icon themes (except flat_white)
  • All default application themes (except Fusion/system defaults)
  • Unnecessary Qt plugins

Troubleshooting

Windows: "Qt6Core.dll not found"

Ensure Qt6 bin directory is in your PATH or copy all required Qt DLLs to the output directory (the build script does this automatically).

Linux: "Qt6 not found"

Install Qt6 development packages via your package manager. Ensure qmake6 or qt6-cmake is in your PATH.

macOS: "App cannot be opened because the developer cannot be verified"

Right-click the app, select "Open", then click "Open" again in the security dialog. Or codesign the app:

codesign --deep --force --sign "-" release/Racked.ru-PrismLauncher-macOS-Portable/PrismLauncher.app

Build fails with "CMake error"

Ensure CMake version is 3.25 or higher:

cmake --version

License

This project is based on PrismLauncher and follows the same licensing terms (GPL-3.0-only).

Credits

  • Original Project: PrismLauncher
  • Upstream fork: Diegiwg
  • Custom Theme: racked.ru
  • Build System: Custom portable build scripts