Environments

Configure and manage deployment environments

Learn how to use environments to safely test and deploy your game builds across different stages.


What are Environments?

Environments are isolated deployment stages that allow you to test builds before releasing them to all players.

circle-info

Think of it as: Different "servers" or "channels" for your game, each serving a specific purpose in your deployment pipeline.


Default Environments

Default Environments

Every application comes with two pre-configured environments:

Production

  • Live environment accessible to all players. Stable, tested builds only.

Staging

  • Private testing environment for internal use only. Perfect for debugging and testing new features.


Creating Custom Environments

circle-check

Need more control? Create custom environments for specific purposes.

Example: "Closed Beta" hidden environment with Access Code

Creating closed beta environment
Environment with Access Code

Environment Switching in Launcher

circle-check

How Players Switch Environments

For public custom environments (like Beta), players can switch in the launcher:

Player switching environment in Launcher Desktop

Best Practices

Professional Pipeline

1. Development → Internal testing, rapid iteration

2. Staging → QA testing, performance checks

3. Beta (optional) → Community testing, feedback

4. Production → Stable release to all players


🎯 Do's

  • ✅ Always test in Dev before Staging

  • ✅ Use Staging for final QA

  • ✅ Keep Production stable

  • ✅ Document environment purpose

  • ✅ Use clear naming conventions

  • ✅ Monitor each environment separately


❌ Don'ts

  • ❌ Skip testing in Dev

  • ❌ Upload untested builds to Production

  • ❌ Mix environment purposes

  • ❌ Give Production access to everyone

  • ❌ Forget to update environment docs

  • ❌ Create too many environments (keep it simple)


Troubleshooting

Problem: Build uploaded but not showing in environment

Solutions:

  • ✅ Make sure the Build is "Completed"

  • ✅ Refresh the page

Problem: Players can't switch to Beta/Staging

Solutions:

  • ✅ Ensure environment is not Hidden

  • ✅ If the environment is Hidden, user needs to unlock the environment with the access code

Problem: Launcher downloads wrong build

Solutions:

  • ✅ Check launcher environment setting

  • ✅ Verify correct build is set as active

  • ✅ Click refresh button to fetch the latest changes

  • ✅ Restart launcher completely


Next Steps


circle-check

Last updated

Was this helpful?