Upload Builds

Upload and manage game builds to distribute updates to your players

Upload your game builds to distribute updates to players through your launcher. Supports files up to 50 GB with automatic patching. 🎮

---

Upload Methods

Dashboard (Web)

🌐 Web Dashboard Upload

Perfect for small to medium builds (~5 GB)

Advantages:

• ✅ User-friendly interface

• ✅ Drag and drop support

• ✅ No additional tools needed

• ✅ Visual progress tracking

Best for:

• Quick updates

• Small game builds

• Manual releases

• Teams without CI/CD

Recommended for files under 5 GB. For larger files, use the CLI.

CLI (Command Line)

---

Dashboard Upload Guide

Step 1: Navigate to Your Application

1

Access Dashboard

Log in to your Game Launcher Cloud account

2

Select Application

Go to Applications → Click on your app

3

Open Builds Tab

Click on the Builds tab in your application page

---

Step 2: Prepare Your Build

Before uploading, ensure your game build meets these requirements:

Requirement	Details	Notes
Format	ZIP compressed file	Must be a .zip file
Size	Up to 5 GB (Dashboard) Up to 50 GB (CLI)	Use CLI for larger files
Platform	Windows, macOS, or Linux	Separate builds per platform

Important: Do not include unnecessary files like source code, .git folders, or development tools to keep build size minimal.

---

Step 3: Upload Your Build

Upload Interface

1. Drag & Drop or Browse: Select your .zip file

2. Add Build Notes (optional): Describe changes, bug fixes, new features

3. Click "Upload Your Build": File upload begins immediately

4. Wait for Processing: Monitor the build status until it completes

---

Step 4: Build Processing

After upload, the system processes your build:

Processing Stages:

1. ⬆️ Uploading - File upload to cloud storage

2. ⬇️ Downloading - Server retrieves the file

3. 📦 Unzipping - Extracting build contents

4. 🔧 Creating Patch - Generating delta patches

5. ✅ Completed - Build is ready for distribution

Processing Time:

• Small builds (<1 GB): 2-5 minutes

• Medium builds (1-5 GB): 5-15 minutes

• Large builds (5-50 GB): 15-60 minutes

Real-time Status:

You can monitor the build status in real-time:

• Green indicator: Processing successfully

• Red indicator: Error occurred (check error message)

• Progress bar: Shows current stage

---

Step 5: Set Active Build

Once your build is processed, you need to activate it so players can download it:

1

Navigate to Builds Tab

Go to your application → Builds tab

2

Find Your Build

Locate the newly uploaded build in the builds list (status should be Completed)

3

Set as Active

Click the "Set as Active" button next to your build

4

Confirm Activation

Confirm the action. This build will now be distributed to players through the launcher

Active Build: Only ONE build per platform and environment can be active at a time. When you set a new build as active, it replaces the previous one.

Players Update: Once a build is set as active, players will automatically receive the update next time they open the launcher.

---

Build File Structure

Recommended Structure

Your ZIP file should contain a clean game structure:

MyGame.zip
├── MyGame.exe              (Windows)
├── assets/
│   ├── textures/
│   ├── sounds/
│   └── models/
├── data/
│   ├── config.json
│   └── settings.ini
└── README.txt

Platform-Specific Examples

Windows

MyGame_Windows.zip
├── MyGame.exe           ← Main executable
├── MyGame_Data/         ← Unity/Unreal data
├── MonoBleedingEdge/    ← Unity runtime
├── UnityCrashHandler64.exe
└── UnityPlayer.dll

macOS

Linux

---

Delta Patching

Game Launcher Cloud automatically generates delta patches between builds:

How It Works

Benefits:

• 🚀 90% smaller downloads on average

• ⚡ Faster updates for players

• 💰 Lower bandwidth costs

• 🔄 Automatic - no configuration needed

Example: If you change 100 MB in a 5 GB game, players only download 100 MB instead of the full 5 GB!

---

Build Notes Best Practices

Good build notes help players understand what's new:

✅ Good Example

**Version 1.2.0 - November 2024**

🎮 New Features:
- Added multiplayer co-op mode
- New character customization options
- 5 new maps in rotation

🐛 Bug Fixes:
- Fixed crash when loading large maps
- Improved FPS on low-end systems
- Fixed audio sync issues

⚖️ Balance Changes:
- Reduced weapon damage by 10%
- Increased player movement speed

❌ Poor Example

update

Tip: Use markdown formatting for better readability. Players see this in the launcher before downloading.

---

Troubleshooting

Common issues and solutions:

Issue	Cause	Solution
Stuck at "Enqueued"	Build waiting in processing queue	Should process after a few minutes. If it continues stuck, contact support immediately with Build ID.
Stuck at "Processing"	Large file being processed	Wait 15-60 minutes for large builds. Check status regularly.
Build shows "Failed"	Corrupt ZIP or invalid structure	Re-compress the file, ensure no corrupted files inside
Upload very slow	Network connection	Use CLI for better upload performance, check internet speed
Can't find build after upload	Wrong environment selected	Check all environments (Dev/Prod/Custom)

Need Help? Join Discord or email [email protected]

---

Best Practices

🎯 Optimize Build Size

• Remove unnecessary files (source code, temp files)

• Compress textures and audio appropriately

• Use game engine's compression settings

• Test build locally before uploading

🔄 Version Control

• Upload to Development environment first

• Test thoroughly before promoting to Production

• Keep build notes detailed and organized

• Archive old builds periodically

📊 Monitor Performance

• Check download analytics after release

• Monitor player feedback on updates

• Track build sizes over time

• Use delta patching effectively

🚀 Deployment Strategy

• Development: Immediate testing and iteration

• Staging/Beta: Limited player testing

• Production: Stable releases only

• Schedule updates during off-peak hours

---

Next Steps

⚡ CLI Upload

Upload large builds via command line

📰 News & Updates

Create news posts to engage your players

🚀 Create Launcher

Build launcher to distribute your game

📊 Analytics

Track downloads and player engagement

---

🎉 Ready to upload? Start with a Development build to test the process before going to Production!