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 large files (depending your plan) with automatic patching. 🎮
Upload Methods
🌐 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.
⚡ Command Line Interface
Perfect for large builds and automation
Advantages:
✅ Upload large files (depending your plan)
✅ Faster for large files
✅ CI/CD integration
✅ Scriptable and automated
✅ Direct to Cloudflare R2
Best for:
Large game builds
Automated workflows
CI/CD pipelines
Team collaboration
Dashboard Upload Guide
Step 1: Navigate to Your Application
Access Dashboard
Log in to your Game Launcher Cloud account
Select Application
Go to Applications → Click on your app
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:
Format
ZIP compressed file
Must be a .zip file
Size
Up to 5 GB (Dashboard) Or large files with 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
Drag & Drop or Browse: Select your .zip file
Add Build Notes (optional): Describe changes, bug fixes, new features
Click "Upload Your Build": File upload begins immediately
Wait for Processing: Monitor the build status until it completes
Step 4: Build Processing
After upload, the system processes your build:
Processing Stages:
⬆️ Uploading - File upload to cloud storage
⬇️ Downloading - Server retrieves the file
📦 Unzipping - Extracting build contents
🔧 Creating Patch - Generating delta patches
✅ Completed - Build is ready for distribution
Processing Time:
Small builds (<1 GB): 5-30 seconds
Medium builds (1-5 GB): 3-5 minutes
Large builds (5-50 GB): 5-25 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:
Navigate to Builds Tab
Go to your application → Builds tab
Find Your Build
Locate the newly uploaded build in the builds list (status should be Completed)
Set as Active
Click the "Set as Active" button next to your build
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:
Platform-Specific Examples
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!
Smart Bundles Technology
NEW: Revolutionary Smart Bundles system for dramatically faster downloads, especially for games with many small files!
What are Smart Bundles?
Smart Bundles automatically group small files into optimized packages during patch generation, reducing download overhead and dramatically improving update speeds.
Example Impact:
A 1.16 GB game with 309 files becomes 1.07 GB with only 5 files
Result: Significantly faster downloads for players
How It Works
Process:
Analysis - System identifies small files (< 5 MB)
Bundling - Groups related files into optimized packages
Compression - Applies efficient compression
Distribution - Launcher downloads and extracts bundles seamlessly
Benefits
Dramatically Faster - Reduced overhead for games with many small assets
Automatic - No configuration or changes needed on your part
Efficient - Better compression and organization
Adaptive - Intelligently bundles based on file size and patterns
Availability: Smart Bundles are available for newer builds. Older builds continue using standard patching without issues.
Performance Impact
For Developers:
~20% additional storage during patch generation for bundle optimization
Significantly faster end-user downloads
For Players:
Much faster update downloads, especially for games with thousands of small files
Seamless experience - bundles are extracted automatically
xxHash64 - Faster File Verification
MAJOR UPGRADE: xxHash64 is now the primary hashing method, providing 10-20x faster performance than MD5!
What Changed?
The platform now uses xxHash64 for all file verification and integrity checks, replacing the slower MD5 algorithm.
Speed Comparison:
MD5: Traditional speed
xxHash64: 10-20x faster ⚡
Impact
For Build Creation:
✅ Much faster patch generation (both local and server-side)
✅ Faster file verification during downloads
✅ Reduced CPU usage during processing
✅ Quicker build processing on the server
For Players:
✅ Shorter verification times during updates
✅ Faster integrity checks
✅ Improved download performance
Compatibility
✅ Fully Backward Compatible - Old patches using MD5 continue working
✅ Automatic Detection - System detects which algorithm each patch uses
✅ Seamless Transition - No action needed from you or your players
Server Transition: For 2 weeks, server-side builds generate patches with both MD5 and xxHash64. After this period, only xxHash64 will be used for maximum performance.
Build Notes Best Practices
Good build notes help players understand what's new:
✅ Good Example
❌ Poor Example
Tip: Use markdown formatting for better readability. Players see this in the launcher before downloading.
Troubleshooting
Common issues and solutions:
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
📊 Analytics
Track downloads and player engagement
🎉 Ready to upload? Start with a Development build to test the process before going to Production!
Last updated
Was this helpful?