Skip to content

Deploy

Whenever you change a Template or a Document in Balancy, it's saved on our servers to be available for your end users. You can compare all the changes you make in Balancy with commits in GIT, the only difference being that other Balancy users can see your commits.

When you are ready to publish (like Push in git) your changes for the end users, open the Deploy section in Balancy and click Deploy button. The process takes a few seconds and once it's completed you can launch your game in Unity and get all the updated data.

Bear in mind that you are Deploying only to the active Environment. If you want to Deploy the changes to the Stage or Production environments, please read the Environment page to know more about Data Migration.

Versions

Before you deploy the new data you can set a minimum version for your game and data:

Screenshot

If your game version (Unity ► Player Settings ► Version) is lower than any of those versions, the new data will NOT be downloaded.

Min version to Launch Game

This version usually lets your players know about a new game update available. It's up to the developer to implement all the logic, Balancy will only return an error in Init Method. This is how you can check if the game version is outdated (after you init Balancy):

private bool IsVersionOutdated()
{
    var errors = Controller.GetErrors();
    foreach (var err in errors)
    {
        switch (err.Error.Code)
        {
            case Errors.GameVersion:
                return true;
        }
    }

    return false;
}

Min version to Update Data

This version is usually used when Templates in Balancy are dramatically changed. Thus, old clients won't be able to parse the new structure correctly.

Redirections

Sometimes you need to make a production build but use staging balance. For example, during store review or for partial rollout. Until we have branches functionality (like in Git), you can use redirections to point the game build to download balance from another environment.

Screenshot

Game build with a specific version will download data from specified environment, ignoring Environment argument to Balancy Init method on the C# side.

  • Build with version 3.0.0 will download balance from dev environment.
  • Build with version 4.0.0 will download balance from dev environment.

During the deploy, if you change min version, the popup will appear and ask you if you want to delete unnecessary redirections.

Screenshot

The same for migration. With auto-deploy flag enabled you will be asked if you want to delete unnecessary redirections.

Screenshot

Offline Games

If your game is offline, you might assume that the game could be launched for the first time without access to the internet. In such a situation, you can't rely on the game balance will be delivered to the build.

  1. Open editor window Tools ► Balancy ► Config
  2. Click on Download Data
  3. All the latest game data from Balancy will be downloaded and put into /Assets/Balancy/Resources
  4. If your game is launched without internet access, it'll use the data from the resources
  5. Once the internet is available, the data will be automatically updated if necessary