Temporary voice channels

A voice channel that's made the moment somebody wants one, and deleted the moment nobody does.

Module: tempvoice. Off until a bot owner runs /moduleadmin enable module: Temporary voice channels. See Modules.

Why this exists

A server with a permanent "General 1", "General 2", "AFK" ends up with rooms that are either empty or overcrowded, and nobody in charge of either.

Temporary voice channels are made on demand, one per person who wants one, and the person who makes a channel runs it: renames it, caps it, locks or hides it, decides who's welcome. When the last person leaves, it's gone. Nothing sits around empty, and nobody has to tidy up after it.

Getting one

Join a creator channel and you're moved straight into a new voice channel made just for you. Leave once everyone else has too, and it's deleted, settings and all.

Join the same creator again while you still own a channel from it, and you're moved back to the one you already have. It doesn't make you a second one.

Made a channel, left, and want another right away? There's a short cooldown between channels. Rejoin the creator too fast and the bot disconnects you rather than making another one on top of the last.

The controls

Join your channel and a controls message somewhere in the server gives you buttons for it, laid out in three rows of five:

Row	Buttons
1	Name, Limit, Privacy, Waiting room, Chat
2	Trust, Untrust, Block, Unblock, Invite
3	Kick, Region, Claim, Transfer, Delete

Button	What it does
Name	Renames your channel. Leave it blank to go back to the default.
Limit	Caps how many people can join. 0 removes the cap.
Privacy	Switches between public, locked and hidden.
Waiting room	Opens a second channel people can wait in and ask to join from.
Chat	Opens a private text thread for everyone in your channel.
Trust	Lets somebody in even when the channel is locked or hidden.
Untrust	Takes somebody off your trusted list.
Block	Keeps somebody out entirely.
Unblock	Lets a blocked person back in.
Invite	Sends somebody a direct message with a link to your channel.
Kick	Disconnects somebody from your channel right now.
Region	Changes the voice region, if the connection is poor.
Claim	Takes over a channel whose owner has left.
Transfer	Hands your channel to somebody who's in it.
Delete	Deletes your channel now, even with people still in it.

Trust, Block, Invite and Kick let you pick several people at once. The matching /voice commands each take one.

Every button is also a /voice command, for when you'd rather type than click:

/voice name name: Late night lobby

A few things only exist as commands, with no button: /voice bitrate, /voice password, /voice join, /voice info and /voice reset.

Only the channel's owner can use any of this, on their own channel. A voice moderator can use it on any temporary channel, not just their own. See the server-wide settings.

A server can switch individual controls off for a creator. If a button is missing or a command refuses you with "switched off for this creator," that's why.

note

Kicking somebody from a public channel with no limit doesn't keep them out. They can just walk back in. Block them, or lock the channel, if you want it to stick.

Privacy

Three states:

• Public. Anyone who can see the channel can join.
• Locked. Anyone can see it, but only people you trust can join.
• Hidden. Only people you trust can even see it.

/voice privacy or the Privacy button switches between them.

Two lists back this up: trusted and blocked, 25 people each. Blocking beats trusting. If somebody's on both lists, they're kept out.

A moderator, meaning anyone holding ban, kick or timeout permission in the server, can never be blocked or kicked from a temporary channel. A channel owner can lock out other members, not the people the server has already put in charge of it.

Claiming and handing over

Once the owner leaves, anyone still in the channel can press Claim (or run /voice claim) to take it over. While the owner is still there, only a voice moderator can claim it out from under them.

The new owner's own saved settings come with them, if the creator remembers owner settings: their name, limit, privacy, and trusted and blocked lists, picked up from the last channel they owned there, not left over from whoever had it before.

Transfer does the same thing on purpose: hand your channel to somebody who's in it right now, rather than leaving and hoping they claim it.

Waiting room

/voice waiting, or the Waiting room button, opens a second, empty voice channel next to yours that anyone can join and wait in.

When somebody joins it, a message appears in your channel's chat with two buttons: Let them in and Turn them away. Letting them in trusts them and, if they're still connected, moves them straight into your channel.

Run it again to close the waiting room.

note

A public channel can still be walked into directly, waiting room or not. If you want the waiting room to be the only way in, lock the channel first.

Password

/voice password sets one, up to 50 characters. Leave it blank to remove it.

Anyone can then run /voice join password: with the right password. A correct password trusts them, and if they're already connected to a voice channel, moves them straight into yours.

Chat

/voice chat opens a private text thread for your channel, in the server's controls channel or wherever the creator's chat channel is set. Everyone currently in the voice channel is added to it, and the thread is deleted along with the channel.

Your voice channel already has its own built-in text chat. The thread is for when you want a record that outlasts the moment, or want to add somebody who isn't in the channel yet.

Finding people

/voice find user: @Ada

Tells you which voice channel somebody's in, if you can see it. A locked or hidden channel is still named; you'll need the owner to trust you before you can actually join it.

Names

Discord allows two renames on any one channel every ten minutes. Hit that and the bot tells you how long to wait, rather than pretending the rename went through.

Censored words

A server admin can set a list of words that never appear in a temporary channel's name.

• A plain word, get, matches only the whole word. It leaves "Together" alone.
• * at the start or end matches part of a word, the same way Discord AutoMod does: *pet catches "Carpet", java* catches "JavaScript".

Wherever it matches, the whole word is blanked out with asterisks, so the name keeps its shape and you can tell which part got refused.

Building a name automatically

A creator's name format can use any of these. {NUMBER} and its variants always give the lowest number no other live channel from that creator is using, so a channel numbered 2 being deleted means the next one made is numbered 2 again, not 6.

Placeholder	Becomes
{CUSTOM}	Whatever the owner set with /voice name, or their nickname if they haven't
{PRIVACY}	An icon for the channel's privacy: public, locked or hidden
{RANDOM}	A random word from the creator's own word list
{OWNER_USERNAME}	The owner's Discord username
{OWNER_NICKNAME}	The owner's nickname in this server
{OWNER_MENTION}	An @mention of the owner (only useful in a greeting)
{OWNER_CREATED}	The day the owner's Discord account was made
{OWNER_JOINED}	The day the owner joined this server
{NUMBER}	1, 2, 3: the lowest free number from this creator
{NUMBER_ROMAN}	I, II, III
{NUMBER_ALPHA}	A, B, C
{NUMBER_DIGIT}	001, 002, 003
{NUMBER_EXPONENT}	¹, ², ³
{ROLE_HIGHEST}	The owner's highest role
{ROLE_HOIST}	The owner's highest role that's shown separately in the member list
{GUILD_ID}	This server's ID
{CHANNEL_ID}	The channel's own ID (blank until it exists)
{ACTIVITY_NAME}	What the owner is playing
{ACTIVITY_MAJORITY_NAME}	What most people in the channel are playing
{ACTIVITY_DETAILS}	The details line of the owner's activity
{ACTIVITY_STATE}	The state line of the owner's activity
{ACTIVITY_EMOJI}	The emoji on the owner's custom status

Skipped people

Pick several people for one action and the ones nothing happened to are listed with why, rather than silently dropped.

Reason shown	When it happens
is you	You picked yourself.
is a bot	Bots can't be invited, trusted, blocked or handed a channel.
is a moderator	They hold ban, kick or timeout permission. See Privacy.
has not accepted the server's rules	Trust and invite only. They haven't got past Discord's rules screen.
has no access role	Trust and invite only, when the creator restricts who may even see the channel.
is not in this channel	Kick and transfer only. They have to be connected right now.
owns the channel	You can't block, kick or trust the person who currently owns it.
is already trusted / is already blocked	They're already on that list.
the list is full	Trusted and blocked both cap at 25.

For admins

/voiceadmin setup
/voiceadmin creator add channel: #new-voice name: Gaming
/voiceadmin creator remove channel: #new-voice
/voiceadmin creator list
/voiceadmin interface channel: #voice-controls
/voiceadmin channels
/voiceadmin delete channel: #someones-channel

/voiceadmin setup is the fast path: one command makes a category, a creator channel to join, and a controls channel with the buttons already posted in it.

/voiceadmin creator add turns any existing voice channel into a creator instead. /voiceadmin creator remove stops it being one; the voice channel itself is left alone, and channels it already made carry on until they empty. /voiceadmin creator list shows every creator this server has.

/voiceadmin interface posts the controls message in a channel of your choice, if you want it somewhere other than where setup put it.

/voiceadmin channels lists every temporary channel that exists right now, who owns each one and how many people are in it. /voiceadmin delete removes one outright, whoever owns it.

Admins only. Chancery needs Manage Channels, Move Members and Manage Roles to do any of this; /voiceadmin setup checks for them first and tells you which is missing rather than failing partway through.

Tuning a creator

Everything about how a creator behaves lives on its own row, on the dashboard's Creators list, because a server with a "Gaming" creator and a "Staff" creator wants them to behave differently. /voiceadmin creator add makes the row; the dashboard is where you shape it.

• Name format. What a fresh channel is called. See the placeholders above.
• Default limit and maximum limit. How many people fit to start with, and the most an owner is ever allowed to raise it to.
• Category and fallback category. Where channels are made. Once the category hits Discord's limit of 50 channels, new ones spill into the fallback if one is set. Without one, the creator stops making channels until the category has room again.
• Bitrate and position. The default audio quality, and whether a new channel sits directly below the creator or at the bottom of the category.
• Default privacy. Public, locked or hidden, for a channel nobody has customised yet.
• Access roles, and how they behave. Restrict who can even see or join without being individually trusted. The two modes are "cannot see them" at all, or "can see but not join."
• Where permissions are copied from. The category, the creator channel itself, or nowhere. Whatever the source says about @everyone seeing, joining or speaking is ignored either way. Privacy alone decides that part.
• Extra owner permissions. Manage the channel, move members, mute members, deafen members, priority speaker, manage messages in its chat. Manage Permissions is never offered, on purpose: an owner who could edit overwrites could undo their own lock or hide.
• Which features owners get. Which of the buttons and commands on this page are switched on at all for this creator's channels.
• Ownerless. Channels from this creator belong to nobody. No owner, no controls, no claiming, just a public room anybody can use.
• Remember owner settings. When somebody leaves their channel and later makes another one, should it come back the way they left it: name, limit, privacy, trusted and blocked lists?
• Greeting, and show the controls in chat. A message posted into a fresh channel, and whether the buttons panel is posted along with it.
• Voice role, and its mode. A role held while inside a temporary channel from this creator, given to everyone in the channel, or only its owner.
• Log channel. Overrides the server-wide voice log for this creator's channels specifically.
• Chat channel. Where /voice chat makes its thread, if not the server's default controls channel.
• Age-restricted chat. Marks the channel's built-in text chat as NSFW.
• Waiting room name. The name format for a waiting room, Waiting for {CUSTOM} unless you change it.
• Random words. The words {RANDOM} picks from.

The server-wide settings

Five things are the same for the whole server rather than per creator, set with /config set:

Setting	What it does
Voice moderator role	May rename, lock, empty or delete any temporary channel, and claim one whose owner is still in it. The admin role always counts; without this, the staff role does instead.
Voice log channel	Channels made, deleted, renamed, locked, handed over, and people blocked or disconnected. A creator can send its own record somewhere else instead.
Censored words	Replaced with asterisks in any channel name.
Cooldown between channels	How long somebody waits after making a channel before they can make another. Joining the creator sooner disconnects them.
Keep an empty channel for	How long a channel stays after the last person leaves before it's deleted. Zero deletes it at once.

See the full settings reference for the exact key and range on each.

It's not working

When you are stuck

"Temporary voice channels is not enabled here."

The module is off. Ask the bot owner to switch it on. See Modules.

Nothing happens when I join the creator channel

Chancery is missing Manage Channels, Move Members or Manage Roles. Grant them and try again.

"The category is full and there is no room in a fallback."

Discord allows 50 channels in a category. Set a fallback category on the creator, or clear some channels out.

A rename didn't change the name

Discord allows two renames on one channel every ten minutes. The bot tells you how long until the next one is allowed.

My channel vanished right after a connection drop

It emptied and nothing was set to keep it around for a moment. Ask an admin to set "Keep an empty channel for" to a short grace period.