Configs

For more information about Configurations, visit the Configurations Guide.

var gamebeastConfigs = GamebeastSdk.Configs;

Values are addressed by dot-path where the first segment is the configuration alias: "MyConfig.PlayerSpeed" reads the PlayerSpeed key of the MyConfig configuration. Paths can reach deeper ("MyConfig.UI.ButtonColor") and index arrays ("MyConfig.Levels.0"). A bare alias ("MyConfig") returns the whole configuration document.

Configurations are evaluated for the local user: if the user is enrolled in an active experiment, the values returned already include the assigned group's changes.

Configurations load on demand. The first access through any of these methods fetches the configuration automatically. Declaring configurations in GamebeastSettings.Configurations additionally preloads them at startup and lets OnReady await them. Configurations are cached on-device, so values are available instantly on launch and offline.

Get<TValue>(configPath)Copy Anchor Link

→TValuereturn type

This method retrieves a configuration value from Gamebeast, converted to TValue. Returns default(TValue) when the path is missing or the configuration has not loaded yet. Prefer Observe when the value may still be loading.

UsageCopy Anchor Link

var playerSpeed = gamebeastConfigs.Get<float>("MyConfig.PlayerSpeed");

// Whole configuration document into a class
public class MyConfigData
{
    public float PlayerSpeed;
}

var myConfig = gamebeastConfigs.Get<MyConfigData>("MyConfig");

Get<TValue>(configPath, defaultValue)Copy Anchor Link

→TValuereturn type

This method retrieves a configuration value from Gamebeast, falling back to defaultValue when the path is missing or conversion fails.

UsageCopy Anchor Link

var playerSpeed = gamebeastConfigs.Get("MyConfig.PlayerSpeed", 16f);

TryGet<TValue>(configPath, out value)Copy Anchor Link

→boolreturn type

This method attempts to retrieve a configuration value from Gamebeast. Returns false when the path is missing or conversion fails.

UsageCopy Anchor Link

if (gamebeastConfigs.TryGet<float>("MyConfig.PlayerSpeed", out var playerSpeed))
{
    // Value was available, do something.
}

IsReadyCopy Anchor Link

→boolreturn type

This property indicates whether all configurations declared in GamebeastSettings.Configurations have been loaded and are ready to be accessed.

UsageCopy Anchor Link

if (gamebeastConfigs.IsReady)
{
    // Configurations are ready to be accessed, do something.
}

OnReady(callback)Copy Anchor Link

→IDisposablereturn type

This callback is triggered when the configurations declared in GamebeastSettings.Configurations are fully loaded and ready to be accessed. If the configurations are already loaded, the callback will be invoked immediately upon subscription.

UsageCopy Anchor Link

gamebeastConfigs.OnReady(() =>
{
    // Configurations are ready to be accessed, do something.
});

OnChanged(configPath, callback)Copy Anchor Link

→IDisposablereturn type

This callback is triggered whenever the value at a specific configuration path changes. It does not fire for the initial load; use Observe for that.

UsageCopy Anchor Link

gamebeastConfigs.OnChanged("MyConfig.PlayerSpeed", () =>
{
    var newValue = gamebeastConfigs.Get<float>("MyConfig.PlayerSpeed");
    Debug.Log($"Config 'MyConfig.PlayerSpeed' changed! New value: {newValue}");
});

Observe<TValue>(configPath, callback)Copy Anchor Link

→IDisposablereturn type

Similar to OnChanged, this callback fires with the current value as soon as it is available, and again with the new value each time it changes. This is the best fit for values that may still be loading.

UsageCopy Anchor Link

gamebeastConfigs.Observe<float>("MyConfig.PlayerSpeed", playerSpeed =>
{
    Debug.Log($"Player speed is now {playerSpeed}");
});

RefreshAsync()Copy Anchor Link

→Taskreturn type

This method forces a refresh of all known configurations now, in addition to the automatic background refresh.

UsageCopy Anchor Link

await gamebeastConfigs.RefreshAsync();