Skip to main content

Live config

Live config lets you push state directly to your game from the Talo dashboard without needing to release an update.

Getting the live config​

read:gameConfig

You can fetch the live config using Talo.game_config.get_live_config(). This must be called before querying the config.

Fetching the config will emit the Talo.game_config.live_config_loaded signal that returns the newly initialised config.

func _ready() -> void:
	Talo.game_config.live_config_loaded.connect(_on_live_config_loaded)
	# first fetch the config
	Talo.game_config.get_live_config()

func _on_live_config_loaded(config: TaloLiveConfig):
	# now you can query the config
	pass

You can fetch the game config any time to refresh the state.

Querying the live config​

You can query properties of the config using Talo.live_config.get_prop(), for example if you wanted to get a boolean value:

var halloween_event_enabled = bool(Talo.live_config.get_prop("halloween_event_enabled"));

live_config.get_prop() will return the value of the property as a string, so you will need to cast it to the correct type. This function also has a second argument which is the default value to return if the property is not found.

Offline cache​

If the player is offline (determined using await Talo.is_offline()), an offline copy of the live config will be returned instead. The cached version is updated after a successful online get_live_config() call. Note: the offline cache can be null if the live config hasn't been successfully queried before.

You can check when the offline config was last updated using Talo.live_config.get_offline_config_last_modified() which returns a Unix timestamp.

Listening for live config updates​

read:gameConfig

You can listen for live config updates by connecting to the Talo.game_config.live_config_updated signal:

func _ready() -> void:
	Talo.game_config.live_config_updated.connect(_on_live_config_updated)

func _on_live_config_updated(live_config: TaloLiveConfig) -> void:
	label.text = live_config.get_prop("live_string", "Not set!")

The live_config_updated signal is emitted via the Talo Socket whenever the live config is updated from the Talo dashboard.