160 lines
4.4 KiB
Markdown
160 lines
4.4 KiB
Markdown
|
# 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)
|
||
|
|
```bash
|
||
|
|
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)
|
||
|
|
```bash
|
||
|
|
sudo dnf install gcc-c++ cmake qt6-qtbase-devel qt6-qttools-devel \
|
||
|
|
qt6-qtimageformats qt6-qtnetworkauth-devel zlib-devel mesa-libGL-devel
|
||
|
|
```
|
||
|
|
|
||
|
|
### macOS
|
||
|
|
```bash
|
||
|
|
# 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)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 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)
|
||
|
|
```batch
|
||
|
|
scripts\build-windows-portable.bat
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Linux/macOS
|
||
|
|
```bash
|
||
|
|
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):**
|
||
|
|
```powershell
|
||
|
|
cd release\Racked.ru-PrismLauncher-Windows-Portable
|
||
|
|
Compress-Archive -Path * -DestinationPath ..\racked-prismlauncher-windows-portable.zip
|
||
|
|
```
|
||
|
|
|
||
|
|
**Linux:**
|
||
|
|
```bash
|
||
|
|
cd release/Racked.ru-PrismLauncher-Linux-Portable
|
||
|
|
tar czf ../racked-prismlauncher-linux-portable.tar.gz .
|
||
|
|
```
|
||
|
|
|
||
|
|
**macOS:**
|
||
|
|
```bash
|
||
|
|
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:
|
||
|
|
```bash
|
||
|
|
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:
|
||
|
|
```bash
|
||
|
|
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
|