VoiceMaster

VoiceMaster gives every member their own voice channel. They join one channel, serenity creates a channel for them and moves them into it — and in there they're the owner: they can lock it, hide it, rename it, set a member limit and decide who gets in. When the last person leaves, the channel deletes itself.

Setting up VoiceMaster

One command builds everything:

// Syntax
[prefix]voicemaster setup

// Example
;voicemaster setup

Serenity creates a voicemaster category with two channels in it — a join to create voice channel and an #interface text channel holding the control panel.

How it works

1. A member joins join to create

   Serenity creates a voice channel for them in the same category.

2. They get moved into it

   They're the owner of that channel from that moment on.

3. They control it from #interface

   Buttons for lock, hide, rename, member limit and the rest.

4. The last person leaves

   The channel is deleted again. Nothing to clean up.

Naming the Channels

By default a new channel is called {user}'s channel. Change the pattern with:

// Syntax
[prefix]voicemaster channelname [name]

// Example
;voicemaster channelname {user}'s room

The Interface

The panel in #interface is what members actually use. Every button works on their own channel, so the same panel serves the whole server.

Letting People in and Throwing them out

The kick button opens both halves of the access control: Permit lets members into a locked or hidden channel, Kick disconnects them and blocks them from coming back. Both use a dropdown, and both take up to 5 members at once.

Building your own Interface

The default panel is fine, but you can write your own with [prefix]interface and an embed script. Buttons are just another parameter in that script.

// Syntax
[prefix]interface [code]

// Example
;interface {embed}{title: voicemaster}$v{description: control your voicemaster channel}$v{button: lock && emoji: 🔒}$v{button: unlock && emoji: 🔓 && style: green}$v{button: hide && emoji: 👻 && style: red}

A button takes an action first, then any of emoji, label and style, separated by &&:

Back to the Default Interface

Run [prefix]interface with no script and serenity posts the default panel again, into whichever channel you ran it in.

Controlling a Channel with Commands

Everything on the panel is a command too, and a few things are commands only. All of them need you to be the owner of the channel you're in.

// Syntax
[prefix]voice permit [member|role]

// Example
;voice permit @eivoran
;voice permit @Friends

Claiming a Channel

If the owner leaves and the channel is still alive, anyone in it can take it over with [prefix]voice claim. It only works while the owner is actually gone — as long as they're still sitting in the channel, it stays theirs.

Presets

A preset saves how a channel is set up so you don't have to rebuild it every time. It stores the name, the bitrate, the member limit and every permission you handed out — who's permitted, who's blocked.

// Syntax
[prefix]voice preset add [name]

// Example
;voice preset add friends

Using a Preset

// Syntax
[prefix]voice preset load [name]

// Example
;voice preset load friends

Loading a Preset Automatically

Rather than loading it by hand every time, mark one preset to apply the moment your channel is created.

// Syntax
[prefix]voice preset autoload [name]

// Example
;voice preset autoload friends

Managing your Presets

// Syntax
[prefix]voice preset list
[prefix]voice preset update [name]
[prefix]voice preset delete [name]

// Example
;voice preset list
;voice preset update friends
;voice preset delete friends

Removing VoiceMaster

// Syntax
[prefix]voicemaster unsetup

// Example
;voicemaster unsetup

Serenity asks what should happen to the channels first: