Economy Game Overrides with Cloud Code

Learn how to use Game Overrides with Cloud Code to personalize your in-game Economy for specific player groups.

Read time 2 minutes

Last updated a day ago

With Game Overrides you can personalize your in-game Economy. For example, providing seasonal sales that only exist for a short time, or giving veteran players more rewards in a purchase.

How Game Overrides and config caching work with Economy

Please read Config caching for more information on how to use Config assignment hash with Cloud code and the Economy SDK. For Economy to know which Overrides to apply for a player, it has to know which Overrides are on the client device. Economy returns

configAssignmentHash

as part of the configuration. Passing the

configAssignmentHash

to Economy ensures that Economy uses the same configuration that’s on the device and provides a consistent user experience for the player. Economy SDK 2.0.0 and above passes

configAssignmentHash

to Economy automatically when interacting with the Economy API. To learn how to use Game Overrides in the Economy SDK, see the Economy SDK guide’s Game Overrides. Economy SDK 1.0.0 and Economy SDK in Cloud Code do not pass

configAssignmentHash

to Economy automatically. If Economy does not receive a

configAssignmentHash

as a parameter, it has a way to ensure consistency with the client device configuration, but in some unusual cases, this configuration can be inconsistent with what is on the client device.

Using Economy Game Overrides with Cloud Code

Another way to use Cloud Code to move your game logic away from the client device is to use it to interact with your game economy. When interacting with Economy from Cloud Code, you need to pass

configAssignmentHash

to your Cloud Code script and then pass it onto Economy. The SDK has a method of getting

configAssignmentHash

on the client device. The full steps are as follows:

Cloud Code setup

Set up Cloud Code script with
```
configAssignmentHash
```
as a parameter.

Add a script calling Economy in Cloud Code with Economy SDK 2.2 or later.


/* *  -------- Example Cloud Code Script -------- * *  Ensure consistency when using Game Overrides with Economy * * -------------------------------------------- */const { CurrenciesApi } = require("@unity-services/economy-2.2");/* * CommonJS wrapper for the script. It receives a single argument, which can be destructured into: *  - params: Object containing the parameters provided to the script, accessible as object properties *  - context: Object containing the projectId, environmentId, environmentName, playerId and accessToken properties. *  - logger: Logging client for the script. Provides debug(), info(), warning() and error() log levels. */module.exports = async ({ params, context, logger }) => {  // Log an info message with the parameters provided to the script and the invocation context  logger.info("Script parameters: " + JSON.stringify(params));  logger.info("Authenticated within the following context: " + JSON.stringify(context));  const { projectId, playerId, accessToken } = context;  const { currencyId, configAssignmentHash } = params;  const currencies = new CurrenciesApi({ accessToken });  const increment = await currencies.incrementPlayerCurrencyBalance({ projectId, playerId, currencyId, configAssignmentHash, currencyModifyBalanceRequest: { currencyId, amount: 10 } });  logger.info("Increment data result: " + JSON.stringify(increment.data));  // Return the JSON result to the client  return {    newBalance: increment.data.balance,  };};

Editor setup

Get a configuration from Economy SDK 2.0.0 or above.


string currencyID = "GOLD";CurrencyDefinition goldCurrencyDefinition = EconomyService.Instance.Configuration.GetCurrency(currencyID);

Call:


EconomyService.Instance.Configuration.GetConfigAssignmentHash();

from the Economy SDK.

Pass

configAssignmentHash

from step 2 into Cloud Code.


await CloudCode.CallEndpointAsync<NewBalance>("AddCurrency", new IncrementBalanceParam(currencyId, configAssignmentHash));

Full example


public async Task<int> IncrementCurrency(){   var goldCurrencyId = "GOLD";   EconomyService.Instance.Configuration.GetCurrency(goldCurrencyId);    var configAssignemntHash = EconomyService.Instance.Configuration.GetConfigAssignmentHash();    var newBalance = await CallIncrementCurrencyEndpoint(goldCurrencyId, configAssignemntHash);     return newBalance;}public async Task<int> CallIncrementCurrencyEndpoint(string currencyId, string configAssignmentHash){   var newBalanceResult = await CloudCode.CallEndpointAsync<NewBalance>(                    "AddCurrency", new IncrementBalanceParam(currencyId, configAssignmentHash));   return newBalanceResult.newBalance;}public class NewBalance{   public int newBalance;}[Serializable]public class IncrementBalanceParam{    public string currencyId;   public string configAssignmentHash;   public IncrementBalanceParam(string currencyId, string configAssignmentHash)   {       this.currencyId = currencyId;       this.configAssignmentHash = configAssignmentHash;   }   public override string ToString()   {      return $"{{\"currencyId\": @currencyId, \"configAssignmentHash\": @configAssignmentHash }}";   }}

Pitfalls

See Config Caching Pitfalls

Documentation

Development

User Acquisition

Monetization

Industry