Sets server-side information about the selected channel in the form of key-value pairs.

  1. The key to use.
    The key is case-insensitive, so if you use this action with key "bob", you can read it back or overwriting it by passing key "Bob" or "BOB".
    In Blue, the key is also simplified, so "Bób" and "BoB" will both match.
    Without removing the key-value pair, the key's casing will remain as whatever it was first set to.
  2. The new string value to store with that key.
    Setting the value to blank "" will remove the key=value pair.


This key-value pairing is also used by groups in the Ini object, so anyone familiar with Ini will find this easy to understand.

The data is called "local" because the channel data stored by the server (locally) is not passed to the (remote) clients in the channel.


This action is very useful for storing information such as game session information, channel state information, etc., but all the data is lost when the channel closes.

Since the closing rules differ based on auto-close setting:

  • In Relay Server, you'll have to work out whether the channel is closing during a Channel > On leave request or Connection > On disconnect event and checking whether the client is master and channel is set to auto-close, or if one of those is false but it's the last client leaving.
  • In Blue Server, there is an explicit Channel > On channel close event. When this event runs, it is the last chance to set or read local channel data.