Iris
Add to Discord
Docs

VoiceMaster

Join-to-create temporary voice channels, owned and controlled by the member who opened them.

Configure VoiceMaster in the dashboard →

Overview#

VoiceMaster replaces a wall of half-empty voice channels with one. A member joins the Join to Create channel, Iris makes them a channel of their own and moves them into it, and deletes it again the moment the last person leaves.

Whoever created the channel owns it. They can rename it, cap it, lock it, hide it, and let specific people in or keep them out, either from the interface panel Iris posts or with .vcmaster commands. Nobody has to ask a moderator to make a channel.

If the owner leaves and other people are still in the channel, anyone left can claim it and take over.

Setup#

Set VoiceMaster up from the dashboard or from chat. Either way one action creates everything it needs.

  1. Open the VoiceMaster page in the dashboard and press Create channels, or run .vcmaster setup. Iris creates a category, an interface text channel, and the Join to Create voice channel. Pass an existing category (.vcmaster setup #Voice or .vcmaster setup Voice Channels) to build them there instead of making a new one.

  2. Join the new channel to check a temporary channel is created and you are moved into it.

  3. Set what new channels start with on the Settings tab: name, member limit, bitrate, region, and whether they start locked or hidden.

  4. On the Access section, pick which roles may create a channel and which role members hold while they are in one.

  5. On the Interface tab, design the panel embed and its buttons, then post it.

  6. Press Reset (or run .vcmaster reset) to remove the whole setup and every temporary channel if you want to start again.

Settings#

Server defaults live on the dashboard, and the staff commands below cover the same ground from chat. They apply to every temporary channel created afterwards.

SettingTypeDefaultWhat it does
Join to Create channelChannelCreated by setupJoining it creates a channel. Made by .vcmaster setup.
CategoryChannelCreated by setupWhere new temporary channels are placed. Change it with .vcmaster category.
Default nameText{user}'s channelThe name a new channel starts with. {user} becomes the creator name.
Default bitrateNumber64Audio quality in kbps for new channels. Your server boost tier caps how high this can go.
Default regionChoiceAutomaticVoice region for new channels. Automatic lets Discord pick.
Default member limitNumber0How many people fit in a new channel. 0 means no limit. Dashboard only.
Start locked / start hiddenToggleOffNew channels open locked or invisible to everyone but their owner. Dashboard only.
Allowed rolesRolesEveryoneOnly these roles may create a channel. Empty means everyone can. Dashboard only.
Blocked rolesRolesNoneMembers with these roles are disconnected from the lobby instead of getting a channel. Wins over allowed roles. Dashboard only.
Delete empty channels afterNumber2 secondsGrace period before an emptied channel is removed. Dashboard only.
Interface panelEmbedBuilt-in panelThe panel embed and the label, emoji, colour and order of every control button. Dashboard only.
Join roleRoleNoneGranted while a member is in a temporary channel, removed when they leave.

Commands#

VoiceMaster is prefix only. It has no slash form, so .vcmaster is how every one of these is run, with your server prefix in place of the . if you changed it.

Staff#

  • .vcmaster help The full command list, in Discord. Anyone
  • .vcmaster setup [category] Create the interface and the Join to Create channel. Manage Server
  • .vcmaster reset Remove the setup and every temporary channel. Manage Server
  • .vcmaster category <category> Route new temporary channels to a category. Manage Server
  • .vcmaster defaultname <name> Set the name new channels start with. Manage Server
  • .vcmaster defaultbitrate <kbps> Set the bitrate new channels start with. Manage Server
  • .vcmaster defaultregion <region> Set the voice region new channels start with. Manage Server
  • .vcmaster joinrole [role] Role held while a member is in a temporary channel. Omit the role to clear it. Manage Server

Channel owners#

  • .vcmaster rename <name> Rename your channel. Anyone
  • .vcmaster limit <0-99> Cap how many people can join. 0 is no limit. Anyone
  • .vcmaster lock Stop new members joining. Anyone
  • .vcmaster unlock Let members join again. Anyone
  • .vcmaster ghost Hide the channel from the channel list. Anyone
  • .vcmaster unghost Make it visible again. Anyone
  • .vcmaster permit <member|role> Let someone in while it is locked. Anyone
  • .vcmaster reject <member|role> Remove someone and keep them out. Anyone
  • .vcmaster claim Take ownership of a channel whose owner left. Anyone
  • .vcmaster transfer <member> Hand ownership to someone else. Anyone
  • .vcmaster status Show your channel settings. Anyone

Permissions#

PermissionWhy Iris needs it
Manage ChannelsCreates and deletes the temporary channels.
Move MembersMoves the creator out of Join to Create and into their channel.
Manage RolesWrites the overrides behind lock, ghost, permit and reject.
View ChannelsSees the interface channel and the category.
Send MessagesPosts the interface panel.
Embed LinksThe panel is an embed.

What it looks like#

I
Iris APP Today at 11:22 PM
VoiceMaster Interface

Join the Join to Create channel to get your own voice channel, then control it with the buttons below.

Lock / Unlock: Control who can join.
Ghost / Unghost: Hide or reveal your channel.
Claim: Take over a channel whose owner left.
Info: View your channel settings.
Limit + / Limit -: Adjust the member limit.
Iris HQ•Today at 11:22 PM
Lock Unlock Ghost Unghost Claim Info Limit + Limit -
The interface panel in the channel setup creates.

Tips and gotchas#

Joining the channel does nothing.

Iris is missing Manage Channels or Move Members, or it cannot see the category. Run .vcmaster setup again to have it report what is missing.

Someone else is in my channel and I cannot remove them.

Use .vcmaster reject <member>. It removes them and keeps them out until you permit them again.

The owner left and nobody can rename the channel.

Anyone still in it can run .vcmaster claim to take ownership.

Is there a dashboard page?

Yes. It covers setup, the defaults, role access, the interface panel design and a live list of every temporary channel. Anything per channel still belongs to its owner.