Temp Voice System

1. Feature Brief

The Temp Voice plugin provides on-demand, private voice channels for your members. Joining a designated “Join to Create” channel instantly spawns a personal voice channel, moves the member into it, and sends an interactive 4-row control panel into the channel’s text chat. Channels are cleaned up automatically when empty.

1. Instant auto-creation - joining the creator channel spawns a personal channel in your configured category using your custom name template
2. In-channel control panel - a persistent embed with 15 control buttons is posted into the voice channel’s built-in text chat immediately upon creation
3. Lock & visibility - one-click buttons to lock connections or hide the channel completely from non-whitelisted members
4. Host permissions & delegation - channel owners can transfer host status, invite trusted co-hosts, or kick disruptive occupants
5. Block & unblock members - hosts can block specific members from entering without locking the entire room
6. Chat slowmode control - toggle built-in text slowmode directly from the in-channel panel
7. Persistent audit logging - staff can run /vc log to review recent kicks, locks, transfers, and moderation events
8. Crash-resilient dispatcher - channel buttons and events survive bot restarts and rapid join/leave cycles without duplicating channels

Who can use this?

Any member can create a temp channel by entering the creator channel. Configuring the system with /vc setup or viewing audit logs with /vc log requires Manage Channels permission.

---

2. Sub-Systems

Control Panel

The control panel is posted to the voice channel’s text chat upon creation. The buttons remain active for the entire duration of the channel and survive bot restarts.

Row 1: Status & Visibility

Button	Behaviour
🔓 Unlocked / 🔒 Locked	Toggles Connect permission for @everyone or your configured role
👁️ Visible / 🙈 Hidden	Toggles ViewChannel permission for non-whitelisted members
🌐 Region	Dropdown to choose from 15 voice server regions or Automatic
ℹ️ Info	Ephemeral overview showing owner, member count, bitrate, and status

Row 2: Customization

Button	Behaviour
✏️ Rename	Opens a modal to set a custom channel name (up to 100 characters)
👥 User Limit	Opens a modal to set max capacity (0 to 99, 0 = unlimited)
🔊 Bitrate	Select audio quality (64, 96, or 128 kbps)
🔨 Kick User	Dropdown listing non-owner occupants to disconnect immediately

Row 3: Ownership & Session

Button	Behaviour
👑 Claim Ownership	Lets any current occupant claim host rights if the original owner has left

Row 4: Advanced Host Controls

Button	Behaviour
🚫 Block User	Select a member to permanently deny Connect permissions for this session
🔓 Unblock User	Restores connect permissions for a previously blocked member
👑 Transfer Ownership	Hands complete channel host control to another occupant in the channel
🤝 Trusted Users	Designates friend co-hosts who bypass channel lock restrictions
⏱️ Chat Slowmode	Sets text message cooldown inside the channel text chat

Audit Logging

Staff can inspect channel activity and moderation actions at any time using the /vc log command.

• Command: /vc log count:<1-50> (default: 15 entries)
• Tracked events:
  • Channel creation and auto-deletion
  • Lock, unlock, hide, and unhide actions
  • User kicks and user blocks
  • Ownership claims and transfers
  • Co-host trust grants and revocations

All actions record the acting member, target user, channel ID, and timestamp.

Channel Lifecycle

Creation & Anti-Duplication:

• When a user joins the creator channel, Utilara applies an internal creation mutex to prevent duplicate channels during rapid joins
• The member is created as the channel owner and granted manage permissions inside their personal room
• Default bitrate is 64 kbps, with customizable default user limits

Auto-Deletion:

• When the last member leaves the voice channel, Utilara waits 3 seconds before deleting the channel
• If someone rejoins during the grace period, the deletion is cancelled automatically

---

3. Setup Guide

1. Open the setup GUI - run /vc setup in any staff channel.

2. Select category & creator channel - choose which category will hold temp voice channels. Utilara will automatically create a Join to Create voice channel.

3. Configure default options - customize the default channel name template (use {user} for the member name), target role for locks, and bitrate defaults directly in the GUI.

4. Start using temp voice - members join the creator channel to receive their private room and control panel instantly.

Temp Voice Commands

Command	Permission	Description
/vc setup	Manage Channels	Opens the interactive Temp Voice setup and configuration GUI
/vc log	Manage Channels	Displays the persistent audit log of recent temp voice actions