Application Settings
Configure and customize your application settings
Customize your application behavior, appearance, and integrations. ⚙️
Overview
Application Settings give you full control over how your game behaves across all platforms and environments.
Access Settings: Go to your application → Click Settings tab
General Settings
Basic Information
Application Name
Display name shown in dashboard and launcher
Description
Brief game description (supports markdown)
"Epic fantasy adventure with multiplayer"
Application ID
Unique identifier (auto-generated, read-only)
Application Icon
Upload a custom icon for your application:
Requirements:
✅ Format: PNG, JPG, or ICO
✅ Size: 512x512 pixels (recommended)
✅ Max file size: 5MB
✅ Transparent background supported
Upload Steps:
Click on the icon placeholder
Select image file
Adjust crop if needed
Click Save
Tip: Use a square image with transparent background for best results!
Control Panel
App Status Control
Manage your app's availability and communicate status to players.
Settings:
Enable App
Enable or disable the app completely
✅ true
Maintenance Mode
Put app in maintenance mode
❌ false
Alert Message
Display custom message to all users
Empty
How It Works:
Enabled (Enable App: enabled) - App appears normally in launcher, players can download and play
Maintenance Mode (Maintenance Mode: enabled) - App visible but shows maintenance notice, download disabled
Disabled (Enable App: disabled) - App hidden from launcher completely
Alert Message - Custom message displayed on app card (works with any status)
Use Cases:
Maintenance Mode - Display "Server maintenance in progress" during updates
Alert Message - Announce "New DLC available!" or "Double XP Weekend!"
Disabled State - Completely hide unreleased or deprecated games
Example Alert Messages:
Visibility: Alert messages appear as banner on the app card in the launcher. Keep them short and actionable.
Live Status
A small reading next to the Play button: how many players are connected, whether your servers are up, or a short label of your own. You configure it in the Launcher Builder, under Buttons, and it updates without republishing the launcher.
Choosing a source
Off
Nothing
Nothing. This is the default
Our analytics
A live count from Game Launcher Cloud
Nothing, just pick a metric
Feed
Whatever your own JSON endpoint reports
An endpoint that answers with JSON
Fixed text
A short label you type
Nothing, and no network calls
Our analytics
The platform already counts live sessions, so this mode needs no endpoint of your own. Pick one metric:
Players with this app open - people with your app selected in the launcher.
Players in game right now - people who launched the game and have not closed it.
Everyone with the launcher open - across every app in the launcher.
Turning this mode on is also what makes the number public. While the app is in any other mode, the endpoint that serves it answers 404, exactly like an app that does not exist.
Feed
Point the launcher at a JSON endpoint you host. It reads the well-known keys first, so an endpoint like this works with no extra configuration:
The keys it looks for are online, players, count, value and text. If your endpoint has a different shape, give it a dotted path instead:
Value field:
data.stats.playerCountOnline field:
data.status.up
The URL accepts {environment}, {environmentId} and {appId}, substituted before every request, so one URL can serve every environment:
Limits. The launcher polls between 15 and 3600 seconds, gives each request 5 seconds, and reads at most 64 KB. Only http and https addresses are accepted.
Text, color and errors
Both live sources share the same presentation:
Online template: supports
{value}, for example{value} online. Leave it empty and the launcher shows its own translated "Online".Offline template: used when the feed reports the service as down.
Colors: one for online, one for offline. The dot follows the text color.
If the read fails: Hide the indicator, show a text you choose, or keep the last reading on screen.
Where it appears
Auto (default) - in the ENVIRONMENT row when the environment selector is visible, and on its own line above the Play button when it is not.
Environment row, Above Play or On Play button to force one.
The indicator survives hiding the environment selector. That is the point of Auto: the reading never disappears just because you turned the dropdown off.
A tooltip of your own can be shown on hover, for example "Players connected right now".
Platform Settings
Configure platform-specific options for Windows, macOS, and Linux.
Windows Platform
Basic Settings:
Enable App
Enable Windows platform for this app
✅ true
Link Only Mode
Launch button opens URL instead of game
❌ false
Link URL
URL to open when "Link Only" is enabled
Empty
Maintenance Mode
Platform-specific maintenance
❌ false
Link Only Mode:
When enabled, the "Play" button opens a website instead of launching the game.
Use Cases:
Web-based games
Browser-hosted games
Redirect to external launchers (Steam, Epic)
Early access/wishlist pages
Example:
Primary Executable Configuration:
Executable Name
Name of the .exe file
Empty
Display Name
Display name for primary button
Empty
Abbreviated Name
Short name for UI
Empty
Enable Custom Launch Arguments
Enable custom launch arguments
❌ false
Launch Arguments
Command-line parameters
Empty
Secondary Executable Configuration:
Enable Secondary Executable
Enable second executable option
❌ false
Secondary Executable Name
Name of secondary .exe file
Empty
Secondary Display Name
Display name for secondary button
Empty
Secondary Abbreviated Name
Short name for secondary
Empty
Enable Secondary Launch Arguments
Enable arguments for secondary
❌ false
Secondary Launch Arguments
Command-line parameters for secondary
Empty
Allow Simultaneous Execution
Allow both executables to run at once
❌ false
Play Button Display Mode
How to show options (Dropdown/TwoButtons)
0 (Dropdown)
Display Modes:
0 = Dropdown - Single button with dropdown to select executable
1 = Two Buttons - Two separate launch buttons side by side
Common Use Cases:
🎮 Graphics API Selection - DirectX vs OpenGL vs Vulkan
💻 Architecture Options - 32-bit vs 64-bit executables
🎨 Build Variants - Stable vs Experimental versions
⚙️ Performance Modes - Standard vs Low-Spec optimized
Player Experience:
Player sees both options in launcher
Selects preferred executable
Launcher remembers their choice
Can switch anytime
User Preference: The launcher automatically remembers each player's last selection for convenience.
macOS Platform
Enable App
Enable macOS platform
❌ false
Executable Name
Name of the .app bundle
Empty
Launch Arguments
Command-line parameters
Empty
Link Only Mode
Button opens URL instead
❌ false
Link URL
URL for link mode
Empty
Maintenance Mode
Platform maintenance
❌ false
Linux Platform
Enable App
Enable Linux platform
❌ false
Executable Name
Binary file name
Empty
Launch Arguments
Command-line parameters
Empty
Link Only Mode
Button opens URL instead
❌ false
Link URL
URL for link mode
Empty
Maintenance Mode
Platform maintenance
❌ false
Platform Maintenance: Use this to temporarily disable a specific platform (e.g., Windows only) while keeping others active.
Admin Rights: Only enable "Run as Admin" if absolutely necessary. Players will see UAC prompts.
macOS-Specific Settings
App Bundle
Name of the .app
Launch Arguments
Command-line parameters
--fullscreen
Code Signing
Verify app signature
Notarization
Apple notarization check
✅ Required for macOS 10.15+
Example Configuration:
macOS Catalina+: Apps must be notarized to run without warnings.
Linux-Specific Settings
Executable
Binary file name
Launch Arguments
Command-line parameters
--fullscreen
Working Directory
Directory to run from
Dependencies
Required packages
libgl1, libasound2
Example Configuration:
Dependencies: Document required libraries in your README. Players may need to install them manually.
Launch Configuration
Launch Arguments
Customize how your game starts:
Common Arguments:
--fullscreen
Start in fullscreen mode
--fullscreen
--windowed
Start in windowed mode
--windowed
--resolution
Set window resolution
--resolution=1920x1080
--quality
Graphics quality preset
--quality=high
--language
Override game language
--language=es
--debug
Enable debug mode
--debug
Custom Arguments:
Variable Replacement: Use {player_name}, {player_id} to inject player data into arguments!
Advanced Settings
Directory Configuration
Root Directory Name
Name of the app's root directory
Apps
How It Works:
The rootName defines the folder structure where your app is installed:
Custom Root Names:
You can customize this to match your branding:
Coordination: This should match the mainAppSubdirectoryName setting in your launcher's advanced settings for consistency.
Auto-Update Settings
Update Behavior
Configuration Options:
Fully Automatic Updates
✅ Check on every launch
✅ Download automatically in background
✅ Install before launching
⚡ Players always have latest version
Best for:
Multiplayer games (version consistency)
Frequent updates
Critical bug fixes
Ask Before Updating
✅ Check on launch
❓ Ask player before downloading
⏸️ Player can postpone
🎮 Can play old version
Best for:
Single-player games
Large updates (>1GB)
Player preference
Manual Updates Only
⏸️ No automatic checks
🔍 Player must click "Check for Updates"
🎮 Full player control
Best for:
Beta versions
Development builds
Special circumstances
Update Schedule
Control when updates are checked:
Every Launch
Check on every launcher start
Hourly
Check once per hour
Moderate
Daily
Check once per day
Manual
Only when player clicks
Never automatic
File Verification
Integrity Checking
Ensure game files are not corrupted:
Verification Options:
None
No verification
Quick Check
Verify critical files only
⚡ Fast, basic protection
Full Verification
Check all files
On Demand
Only when player requests
⚡ Fast, manual control
Recommended: Use "Quick Check" for most games. Full verification for multiplayer/competitive games.
Advanced Settings
Custom Installation Paths
Options:
Default:
{appname}/(recommended)Custom: Any valid folder name (no special characters)
Example:
Prerequisites
Specify required software that must be installed:
.NET Framework
.NET 6.0, 7.0, 8.0
Visual C++ Redistributable
2015-2022 versions
✅ Yes
DirectX
DirectX 11/12 runtime
Custom Prerequisites
Add download URL
❌ Manual
Integrations
Discord Rich Presence
Show game activity on Discord:
Configuration:
Application ID: Your Discord App ID
Large Image: Game icon/logo
Small Image: Status icon
Details: Custom status text
Example:
Get Discord App ID: Create an app at Discord Developer Portal
Webhooks
Receive notifications about events:
Supported Events:
📥 Build uploaded
🚀 Build published
👥 New player registered
💥 Crash reported
📊 Milestone reached (downloads, etc.)
Webhook URL:
Control Panel
Maintenance Mode
Temporarily disable access to your game:
Use Cases:
🔧 Server maintenance
🐛 Critical bug discovered
🔄 Major update deployment
📊 Database migration
Configuration:
Enable/Disable: Toggle maintenance mode
Custom Message: Explain why game is offline
Estimated Time: When will it be back
Example Message:
Archive Application
Archiving is the reversible alternative to deleting. Use it when you're finished with an app for now but want to keep the option to bring it back later.
Archive vs Delete: Archiving keeps the record and can be undone. Deleting is permanent.
What archiving does
Frees your app slot: the app no longer counts toward your plan limit, so you can create new apps.
Deletes the app's Cloudflare builds to free storage (your icon, logo, and settings are kept).
Unlinks the app from every launcher.
Hides it from your app list and sidebar, while keeping the record.
How to archive
Go to your application → Settings → Advanced → Archive, then type the app name to confirm.
Restore (unarchive)
Open Launchers → Archived (or the archived app's Settings → Advanced) and click Restore. Restoring counts the app toward your quota again; if you're at your limit, buy an extra app slot or upgrade your plan first. Previously deleted builds are not restored, so upload a new build afterwards.
Archiving is available to the app owner (and platform admins).
Danger Zone
Destructive Actions
Warning: These actions are permanent and cannot be undone!
Want it back later? Use Archive instead of Delete. Archiving frees your slot and storage but keeps the record so you can restore it.
⚠️ Delete Application
Permanently delete this application, all builds, analytics, and settings. This cannot be recovered.
Before Deleting:
✅ Download any important data
✅ Export analytics reports
✅ Backup builds if needed
✅ Notify team members
✅ Remove from active launchers
Best Practices
✅ Recommendations
🎯 Launch Settings
Test launch arguments on all platforms before releasing
🔄 Auto-Update
Enable automatic updates for multiplayer games
🛡️ Verification
Use file verification for competitive/online games
🔔 Notifications
Set up webhooks to monitor important events
Next Steps
Questions? Contact support@gamelauncher.cloud or join our Discord community!
Last updated
Was this helpful?