Appearance
Appendix C - game settings parameters
Definitions
This appendix lists all game settings. You use these settings when you launch a game. The settings control the features of that game. You can pass game settings in two ways. Use a predefined set of settings, called a profile, with the profile parameter of the getGameURL call. Or pass a valid JSON structure with the options parameter of this call.
List of available game settings
| Setting | Type | Default value | Notes |
| autoplayEnabled | boolean | true | |
| autoplayLossLimitRequired | boolean | false | |
| displayCoins | boolean | true | |
| displayJackpotOdds | boolean | false | |
| displayRTP | boolean | false | |
| displayXRTP | boolean | false | |
| displayClock | boolean | true | If false, the game does not show a clock |
| forceOrientation | none landscape portrait | none | Use one of the allowed values |
| gambleEnabled | boolean | true | |
| historyURL | string | not set | |
| homeURL | string | not set | |
| loadMsg | string | not set | |
| maxExposure | number | not set | Maximum exposure, in 1/100 of base currency (see note below) |
| maxStake | number | not set | Maximum stake, in 1/100 of base currency (see note below) |
| minStake | number | not set | Minimum stake, in 1/100 of base currency (see note below) |
| minLoadTime | number | not set | in milliseconds |
| minSpinTime | number | not set | in milliseconds |
| multipleInstancesAllowed | boolean | false | |
| rcDisplayWinLoss | boolean | false | |
| rcEnabled | boolean | false | |
| rcInterval | number | not set | in milliseconds |
| stopEnabled | boolean | true | |
| topupURL | string | not set | |
| turboEnabled | boolean | true | |
| homeEnabled | boolean | true | If false, the game does not display a home button |
| redirectTarget | 'self' | 'parent' | 'top' | top | Redirect target for the “Home” and “History” buttons |
| dynamicMinSpinTime | boolean | false | For the German jurisdiction, this setting makes spin time dynamic. It activates the average spin time. |
| defaultStakeIndex | number | Not set | Index for default stake (starts with 0) |
| operatorHandlesErrors | boolean | false | If true, the game does not generate popups for errors. The game sends all errors to the frame with postMessage. |
| customStakes | Array of numbers | Not set | An array of custom stakes available in the game, in 1/100 units of the game currency. The system does not apply a further multiplier to these values. Contact hizi.io support to activate this option for your operator account. Sample: [10000, 20000, 100000, 200000] |
| abbreviateAmounts | boolean | true | Used for social casinos. It abbreviates large amounts in the balance or stake display, for example 1M instead of 1,000,000. Use this setting only for social casinos. |
| showExactRTP | boolean | false | If true, the game shows the exact RTP (not rounded) in the frontend rules |
| packageBuyEnabled | boolean | true | If true, the game allows feature package buy (if the game supports it). If false, the game session does not offer feature package buy. |
| displaySessionTimer | boolean | false | This setting tells the game to display a session timer (for example, for UKGC) |
| skipWinsEqualToOrLessThanStake | boolean | false | If true, the game does not celebrate small wins (for example, for UKGC) |
| reportAnimationEnd | boolean | false | If true, the game sends the reportAnimationEnd call |
| launcherType | boolean | Not set | Used for special integrations. Contact hizi.io support before you use this setting. |
| autoplayShowTotalStake | boolean | false | Shows the total stake in the autoplay popup. Used for Brazilian legislation. |
| translateErrors | boolean | false | Uses a standard translation for unexpected errors. Used for Brazilian legislation. |
| currencyToDisplay | string | Not set | Use this string to display the currency. Mostly used for custom currencies or sweep stakes. |
maxExposure, maxStake, minStake and the currency multiplier
You always specify these three values as integers in 1/100 of the base currency (no fractions). When a game launches in another currency, the system multiplies the value by that currency's multiplier. The system applies this multiplied value to standard or custom stakes. (By contrast, you give customStakes in 1/100 of the game currency. The system does not apply a multiplier to customStakes.)
Jurisdiction profiles
Default profiles contain the settings that each jurisdiction requires. Use these profiles to comply with regulatory requirements.
| Profile name | Contained settings | value |
| jurisdiction-mga | Settings to comply with MGA (Malta) | |
| autoplayLossLimitRequired | true | |
| rcEnabled | true | |
| rcDisplayWinLoss | true | |
| jurisdiction-ukgc | Settings to comply with UKGC (2020), UK market | |
| autoplayLossLimitRequired | true | |
| rcEnabled | true | |
| minSpinTime | 2500 | |
| turboEnabled | false | |
| autoplayEnabled | false | |
| stopEnabled | false | |
| maxStake | 5000 | |
| multipleInstancesAllowed | false | |
| packageBuyEnabled | false | |
| displayNetPosition | true | |
| jurisdiction-agcc | Settings to comply with AGCC (Alderney) | |
| autoplayLossLimitRequired | true | |
| rcEnabled | true | |
| minSpinTime | 3000 | |
| turboEnabled | false | |
| autoplayEnabled | false | |
| stopEnabled | false | |
| maxStake | 5000 | |
| multipleInstancesAllowed | false | |
| jurisdiction-de | Settings for German market | |
| minSpinTime | 5000 | |
| turboEnabled | false | |
| autoplayEnabled | false | |
| stopEnabled | false | |
| maxStake | 100 | |
| multipleInstancesAllowed | false | |
| displayCoins | false | |
| displayJackpotOdds | true | |
| displayRTP | true | |
| displayXRTP | true | |
| dynamicMinSpinTime | true | |
| packageBuyEnabled | false | |
| jurisdiction-gr | Settings for Greek market | |
| minSpinTime | 3000 | |
| maxStake | 2000 | |
| maxPackageStake | 2000 | |
| maxExposure | 14000000 | |
| stopEnabled | false | |
| jurisdiction-bg | Settings for Bulgarian market | |
| minSpinTime | 3000 | |
| stopEnabled | false | |
| jurisdiction-nl | Settings for Dutch market | |
| autoplayEnabled | false | |
| turboEnabled | false | |
| packageBuyEnabled | false | |
| forceDefaultStake | true | |
| defaultStakeIndex | 0 | |
| jurisdiction-se | Settings for Swedish market | |
| autoplayEnabled | false | |
| turboEnabled | false | |
| stopEnabled | false | |
| minSpinTime | 3000 | |
| jurisdiction-lt | Settings for Lithuanian market | |
| stopEnabled | false | |
| gambleEnabled | false | |
| minSpinTime | 1000 | |
| jurisdiction-br | Settings for Brazilian market | |
| displayPaytableOnEnterGame | true | |
| gambleEnabled | false | |
| doNotStoreSettings | ['autoplay'] | |
| sessionTimeoutInSeconds | 1800 | |
| hideDemoBalance | true | |
| jurisdiction-caon | Settings for Canadian / Ontario market | |
| autoplayEnabled | false | |
| turboEnabled | false | |
| stopEnabled | false | |
| minSpinTime | 2500 | |
| sessionTimeoutInSeconds | 1200 | |
| displayNetPosition | true |
List of available game variables
Game variables are settings that the system forwards to the game client. The system passes only known variables. If you pass another variable in the variables parameter of getGameURL, the API throws an invalid parameter error.
| Setting | Type | Notes |
| rcElapsed | number | Time elapsed for games with reality check enabled |