Create channel with master selected by ID
This action creates a channel at the server's request, with optionally a client picked as the channel master and sent a channel join message. The client is picked by their ID.
- The channel name.
- Whether the channel is hidden from channel listing (1) or not hidden (0).
- Whether the channel is set to auto-close when the master leaves (1) or to stay open (0).
- The client ID to be appointed as channel master.
If this is set to -1, and auto-close is disabled, the channel is created without a channel master.
The client and newly created channel are not selected by this action.
The channel will close under the normal circumstances a channel would close; if auto-close, when the master leaves, and if not auto-close, when the last client leaves.
If not created with a channel master, it will only close if you call the Channel > Close channel action on it, or if a client joins and leaves.
Attempting to create a channel when a similar name already exists will result in an error; so if you want a channel that always exists even without any clients, re-create it in response to to a Channel > On channel close event, but do so after a few milliseconds' delay, not in the close event itself.
This is for server-initiated channel creations, not client-initiated.
You should not use this action to create a channel "apples" in response to a Channel > On join request event for channel "apples". Behavior for that case is undefined, and may result in server instability.
It is safe to create a channel with a different name, but remember you can modify the channel name during a join request, so unless you want two channels created in response to one join request, this action is not what you want.
Instead, read more about how the channel join request is approved, and options for modifying a join request, under the Enable/disable conditions > On join channel request action.