UnionCrax.Direct

A fast, standalone Electron desktop application for managing and launching games from the UnionCrax platform. Direct downloads with minimal overhead and full control over your gaming library.

Features

• Fast Downloads: Direct game downloads with pause/resume support
• Game Library: Browse and manage your installed games
• Updates: automatic launcher updates
• Settings: Customize download location and launch executables
• Search: Quick game search with intelligent filtering
• History: Track your recently played games
• Sync: In sync with the UC Website, browse your liked/wishlisted games and recently viewed directly inside the launcher.

System Requirements

• OS: Windows 10 or later (64-bit)
• RAM: 2GB minimum (4GB recommended)
• Storage: 500MB for app, plus space for game downloads

Installation

Windows Installation Options

Option 1: NSIS Installer (Recommended)

1. Go to Releases
2. Download UnionCrax.Direct.Setup.X.X.X.exe
3. Run the installer and choose installation directory
4. Create desktop/Start Menu shortcuts
5. Launch UnionCrax.Direct from Start Menu or desktop

Option 2: Portable Executable

1. Go to Releases
2. Download UnionCrax.Direct.X.X.X.exe
3. Run directly - no installation needed
4. Settings and data are stored alongside the executable

Option 3: ZIP Archive

1. Go to Releases
2. Download UnionCrax.Direct-X.X.X-win.zip
3. Extract to your preferred location
4. Run UnionCrax.Direct.exe from the extracted folder

Linux Installation

Run the one-line installer (downloads the latest AppImage and creates a desktop entry):

curl -sSL https://union-crax.xyz/linux-installer.sh | bash

This installs the AppImage to ~/.local/share/UnionCrax.Direct and adds a launcher in your applications menu.

Usage

Downloading Games

1. Browse the game library
2. Click Download
3. Wait for download to complete
4. Extraction begins automatically

Launching Games

1. Go to Library
2. Click the Play button on an installed game
3. Choose the game executable if prompted
4. Game launches directly

Managing Downloads

1. Go to Activity
2. View active, completed, and failed downloads
3. Pause/resume/cancel downloads as needed (currenlty the host rootz does not support download resume)

Settings

1. Click Settings (gear icon)
2. Change download location
3. View storage usage
4. Check for updates

Downloads fail?

• Check UnionCrax Status

Having issues?

• Report an Issue
• Join Discord

Development

Want to contribute? See CONTRIBUTING.md for setup instructions and development guidelines.

Quick Start (Developers)

# Clone repository
git clone https://github.com/Union-Crax/UnionCrax.Direct.git
cd UnionCrax.Direct

# Install dependencies
pnpm install
pnpm run setup

# Start development
pnpm dev

# Build installer
pnpm run pack

For detailed development information, see CONTRIBUTING.md.

Architecture

Technology Stack

• Frontend: React 18 + TypeScript + Vite
• Desktop: Electron 33 + Node.js
• Styling: Tailwind CSS v4
• Build: electron-builder (NSIS installer for Windows)

How It Works

1. Main Process: Electron handles file operations, downloads, and game launching
2. Renderer Process: React UI communicates with main process via IPC
3. Backend: API calls to UnionCrax for game metadata and download links

Project Structure

UnionCrax.Direct/
├── electron/          # Main Electron process
├── renderer/          # React UI (Vite)
│   ├── src/
│   │   ├── app/      # Pages and routes
│   │   ├── components/ # UI components
│   │   ├── lib/      # Utilities and helpers
│   │   └── context/  # React context
│   └── public/       # Static assets
├── scripts/          # Build and dev scripts
├── .github/workflows/# GitHub Actions CI/CD
└── assets/          # App icon

License

This project is licensed under the MIT License - see LICENSE for details.

Support

• GitHub Issues: Report bugs or suggest features
• Discord: Join UnionCrax Community
• Website: union-crax.xyz

Acknowledgments

Built with:

• Electron
• React
• Vite
• Tailwind CSS
• Radix UI
• Lucide Icons

---

Made with ❤️ by the UnionCrax Team