Frontend settings reference

login and refresh return gameSettings. The remote gaming server (RGS) resolves profiles and overrides before sending these settings.

The TypeScript interface declares many required properties. Actual replies can omit properties or contain null values. Validate the reply. Resolve missing values through the agreed integration profile. Do not treat a missing permission as permission to enable a feature.

Apply settings to every input path, including keyboard shortcuts and Operator Interface events. Reapply settings after refresh. A local preference cannot enable an operator-disabled function.

Bets and gameplay

Setting	Frontend requirement
minStake, maxStake	Validate the selected base stake. Use effective reply amounts. See stake precedence.
customStakes	Replace the default ladder when nonempty. Apply independent legal and player limits.
defaultStakeIndex	Select a valid index in the final displayed ladder.
forceDefaultStake	Ignore the saved stake at a new session. Preserve the stake of an open round.
maxExposure	Display the configured cap where required. Honor capped results and early round closure.
packageBuyEnabled	Gate slot bonus purchases. Other verticals need an agreed mapping for table selection.
maxPackageStake	Check purchase limits. Current handlers compare the base stake; the frontend must also check the complete cost.
gambleEnabled	Gate elective slot gambles. Keep collection available when the engine offers it. Do not hide mandatory bonus choices.
partialCollectEnabled	Gate banking part of a win. Explain that banking can leave the money inside the round.
autoplayEnabled	Gate the autoplay menu and every automatic paid-start path.
autoplayLossLimitRequired	Require a valid loss limit before autoplay starts. Stop when the limit is reached.
autoplayShowTotalStake	Show stake × selected round count in the autoplay confirmation.
turboEnabled	Gate faster presentation. Disabled turbo also applies to wrapper requests and stored preferences.
stopEnabled	Gate early stopping of presentation. Never change the outcome or bypass timing.
minSpinTime	Enforce milliseconds between accepted cycle starts. See timing.
dynamicMinSpinTime	Select the approved timing policy. Do not infer an averaging algorithm from this boolean.
multipleInstancesAllowed	Prevent your frontend from offering simultaneous games when false. Coordinate session enforcement with the operator.
reportAnimationEnd	Report completed presentation to the RGS. Await success before another action.

Loading, rules, and amounts

Setting	Frontend requirement
loadMsg	Display the supplied loading message as text.
minLoadTime	Minimum visible loading interval in milliseconds. Start it when the required message appears.
displayPaytableOnEnterGame	Show the rules or paytable before play.
displayRTP	Show the configured return-to-player (RTP) percentage in the rules.
showExactRTP	Preserve supplied precision. Do not invent missing decimal places.
displayXRTP	Show experienced RTP only for games with an approved definition and source. It is not theoretical config.rtp.
displayWinOdds	Display requested maxWin and/or maxPayout odds. Verify availability and correctness before release.
displayJackpotOdds	Display approved jackpot odds. Do not substitute a progression meter for probability.
skipWinsEqualToOrLessThanStake	Suppress win celebrations for a return no greater than the total amount staked. Still display the result.
displayCoins	Legacy coin display. It must not replace a required currency amount.
displayCurrency	Control the configured currency display. A legal requirement takes precedence over a cosmetic setting.
currencyToDisplay	Use the agreed display label. Do not change amounts or currency sent to the server.
abbreviateAmounts	Abbreviate only where the integration permits it, normally social mode. Keep exact amounts accessible.
isSocial	Apply social presentation. Do not infer it from a zero balance or demo tickets.
hideDemoBalance	Hide the demo balance when requested. Keep stake and result controls understandable.
hideCompanyLogo	Hide the provider logo where configured. Preserve required attribution and regulatory information.
translateErrors	Map recognized error codes to approved local text. Preserve operator-supplied messages and actions.

Sessions and responsible gambling

Setting	Frontend requirement
jurisdiction	Select the tested jurisdiction configuration. This is not a country code or proof of certification.
rcEnabled	Enable the agreed reality-check flow. Do not start a second reminder system when the operator owns it.
rcInterval	Reality-check interval in milliseconds. The SDK's seconds comment is incorrect.
rcDisplayWinLoss	Include confirmed session win/loss values in the reminder.
displayClock	Display the current clock. This differs from elapsed session time.
displaySessionTimer	Display elapsed session time. The SDK type also permits a string. The platform sends only a boolean. Treat a string as an operator-specific extension.
displayNetPosition	Display session winnings minus stakes. Exclude deposits and withdrawals.
sessionTimeoutInSeconds	Inactivity limit in seconds. A zero value disables this timeout where the profile permits it.
operatorHandlesErrors	Forward errors through Operator Interface. Keep play blocked until the integration resolves them.

A true rcEnabled without a usable interval requires integration configuration. Do not silently omit the reminder. login() does not return gameVariables.rcElapsed, so agree the owner of the elapsed time with the operator. See what login() does not return.

Navigation

Setting	Frontend requirement
homeEnabled	Show the home control only when allowed.
homeURL	Fallback destination for the lobby. Prefer the wrapper action where required.
historyURL	Destination for account or game history.
topupURL	Destination for deposits. Do not change balances locally after navigation.
lossLimitURL	Destination for responsible-gambling limits.
redirectTarget	Use self, parent, or top as configured.
preventRedirect	Prevent automatic navigation. Use the operator's control or an explicit player action as agreed.
refreshDisabled	Gate the game's reload controls and operator-requested refresh flow.
launcherType	Distinguish reelLink and online launch behavior. Read the ReelLink adapter.

Preferences and device behavior

Setting	Frontend requirement
forceOrientation	SDK values: 0 none, 1 landscape, 2 portrait. Hizi configuration also uses corresponding strings. Normalize the received value.
disableFullScreenMobile	Prevent automatic mobile fullscreen.
doNotStoreSettings	Do not persist listed preferences. The platform currently defines autoplay.
turboDefaultEnabled	Additional platform field. Start turbo only when turboEnabled also permits it.
performanceMode	Additional platform field: enabled, landscape, or portrait. Reduce costly animation in the selected mode. Preserve outcome information.
progressionAnimations	Additional platform field. Gate progression animations while preserving counter values and awards.

The last three fields exist in Hizi configuration but lack explicit SDK properties. Access them through the settings index signature. Check types at runtime.

There is no standard loadingScreens or mute setting in this interface. Build loading screens locally. Use Operator Interface audio events and player preferences for mute state.

Apply defaults deliberately

Use strict boolean checks after normalization. The string "false" is truthy in JavaScript. Do not use Boolean(value) on unvalidated settings.

Resolve an absent restrictive setting from a reviewed integration profile. Keep paid play disabled if required limits or legal behavior remain unknown. Include the resulting settings object in acceptance fixtures, with credentials removed.

The contract audit identifies source versions and implementation gaps. The release checks define the cases to exercise.