⚔ Varok — MC Modpack Manager

Self-hosted Minecraft modpack management platform with a native multi-platform desktop launcher.

---

📋 Overview

Varokm is a full-stack Minecraft modpack management solution built entirely in Go. It consists of two components:

Component	Description
Panel	Self-hosted Docker admin panel for managing modpacks, users, Java runtimes, and client updates
Client	Cross-platform native desktop launcher that connects to the panel, authenticates with Microsoft/Xbox, and launches Minecraft

Key Features

• 🎮 Microsoft Authentication — OAuth2 Authorization Code Flow with PKCE (browser-based login)
• 📦 Modpack Management — Upload, version, and distribute Technic/CurseForge-style modpacks
• ☕ Java Management — Auto-detect local Java or download from Adoptium API
• 🔄 Auto-Update — Client checks the panel for new versions and self-updates
• 🐳 Docker Deployment — Single container, single volume, zero external dependencies
• 🗄️ Embedded Database — Pure-Go SQLite (no CGo required)
• 👥 Role-Based Access — Admin and Manager roles in the panel
• 🖥️ Cross-Platform — Windows (amd64), macOS (arm64), Linux (amd64)

---

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                    Varok Panel                      │
│              (Docker / Go / chi / SQLite)            │
│                                                     │
│  ┌─────────┐  ┌──────────┐  ┌────────────────────┐  │
│  │ Web UI  │  │ REST API │  │ File Storage       │  │
│  │ (Admin) │  │ /api/v1/ │  │ modpacks/java/     │  │
│  └─────────┘  └──────────┘  │ clients/icons/     │  │
│                             └────────────────────┘  │
└──────────────────────┬──────────────────────────────┘
                       │ HTTP :8689
                       │
┌──────────────────────┴──────────────────────────────┐
│                  Varok Client                       │
│            (Fyne GUI / Native Desktop)               │
│                                                     │
│  ┌──────────┐  ┌───────────┐  ┌──────────────────┐  │
│  │ Modpack  │  │ Microsoft │  │ Minecraft        │  │
│  │ Browser  │  │ OAuth2    │  │ Launcher Engine  │  │
│  └──────────┘  └───────────┘  └──────────────────┘  │
└─────────────────────────────────────────────────────┘

---

🚀 Quick Start

Panel (Server)

Requirements: Docker & Docker Compose

cd panel

# Configure environment
cp .env.example .env
# Edit .env — set SECRET_KEY (min 32 chars) and adjust paths

# Start the panel
docker compose up -d

The panel will be available at http://localhost:8689.

On first launch, use the default admin credentials to log in, then change them in Settings.

Environment Variables

Variable	Default	Description
PORT	8689	HTTP server port
SECRET_KEY	—	JWT signing secret (min 32 chars)
DB_PATH	/data/alleria.db	SQLite database path
DATA_DIR	/data	Root data directory
CLIENT_VERSION	1.0.0	Current client version

Client (Desktop App)

Pre-built binaries are available on the Releases page for Windows, macOS, and Linux.

Building from source

Requirements: Go 1.22+, C compiler (for Fyne/OpenGL)

cd client

# Build for current platform
make build

# Or run directly
make run

Cross-compilation (requires Docker)

# Install fyne-cross
make install-tools

# Build for all platforms
make all

# Or build individually
make windows
make linux
make darwin

---

📦 Panel Features

Dashboard

Overview of modpacks, users, Java versions, and system status.

Modpack Management

• Create/edit/delete modpacks
• Upload client ZIP files with versioning
• Upload custom modpack icons
• Manage individual mods (name, version, author)
• Set Minecraft version, Forge/Fabric version, required Java
• Changelog and announcements per modpack
• Supports Technic and CurseForge modpack formats

User Management (Admin only)

• Create and delete users
• Assign roles: Admin or Manager

Java Runtime Management (Admin only)

• Upload Java runtimes for different platforms/architectures
• Served to clients that don't have Java installed

Client Version Management (Admin only)

• Upload client binaries per platform/architecture
• SHA-256 checksum verification
• Clients auto-update from here

---

🎮 Client Features

Microsoft Authentication

Browser-based OAuth2 login with PKCE — click "MC Account", pick your Microsoft account in the browser, done. No codes to copy.

Modpack Browser

Browse and install modpacks from the connected panel. One-click install and update.

Minecraft Launcher

Launch Minecraft with the selected modpack, custom JVM arguments, and memory settings.

Java Management

Auto-detects local Java installations. If none found, downloads the selected version from Adoptium directly.

Settings

• Panel URL configuration
• RAM allocation (min/max with 256MB steps)
• Custom JVM arguments
• Java version selection
• Window resolution
• Microsoft Client ID override

Auto-Update

On launch, the client checks the panel for a newer version and offers to update in-place.

---

🔌 REST API

The panel exposes a public API for the client:

Method	Endpoint	Description
GET	/api/v1/version	Latest client version info
GET	/api/v1/modpacks	List all modpacks
GET	/api/v1/modpacks/{id}	Modpack details
GET	/api/v1/modpacks/{id}/download	Download modpack ZIP
GET	/api/v1/modpacks/{id}/icon	Modpack icon
GET	/api/v1/java/{version}/{platform}/{arch}	Download Java runtime
GET	/api/v1/client/{platform}/{arch}	Download client binary

---

🛠️ Tech Stack

Panel

Technology	Purpose
	Backend language
	Lightweight HTTP router
	Embedded database (pure-Go, no CGo)
	Session authentication
	Containerized deployment

Client

Technology	Purpose
	Application language
	Cross-platform desktop UI
	Minecraft authentication
	Java runtime management

CI/CD

Technology	Purpose
	Automated builds & releases

---

📁 Project Structure

.
├── .github/workflows/
│   └── build.yml              # CI/CD — builds & releases on tag push
├── client/                    # Desktop launcher (Fyne GUI)
│   ├── cmd/alleria/           # Entry point
│   ├── internal/
│   │   ├── api/               # HTTP client for panel API
│   │   ├── auth/              # Microsoft OAuth2 → Xbox → MC auth
│   │   ├── config/            # User configuration
│   │   ├── gui/               # Fyne UI screens
│   │   ├── java/              # Java detection & Adoptium downloads
│   │   ├── launcher/          # MC launcher profiles
│   │   ├── minecraft/         # Version manifest & game launching
│   │   ├── modpack/           # Instance management
│   │   └── updater/           # Self-update mechanism
│   ├── Icon.png
│   └── Makefile
└── panel/                     # Admin panel (Docker)
    ├── cmd/panel/             # Entry point
    ├── internal/
    │   ├── auth/              # bcrypt + JWT
    │   ├── config/            # Environment configuration
    │   ├── database/          # SQLite setup & migrations
    │   ├── handlers/          # HTTP handlers (web + API)
    │   ├── middleware/        # Auth & role middleware
    │   └── models/            # Data models
    ├── web/
    │   ├── templates/         # HTML templates
    │   └── static/            # CSS & JS
    ├── Dockerfile
    └── docker-compose.yml

---

📄 License

This project is proprietary software. All rights reserved.

---

Built with ❤️ and Go