TempVoice (Red-DiscordBot Cog)

Join-to-create temporary voice channels for Red-DiscordBot.

Features

• Per-guild configuration (no hardcoded global channel IDs)
• Auto-create temporary voice channel when user joins a configured start channel
• Auto-move user to their own temporary channel
• Reuse existing temporary channel for the same owner if it still exists
• Auto-delete temporary channel when it becomes empty
• Owner command to set channel user limit (0-99)
• Admin commands for setup and cleanup
• i18n-ready runtime messages (English + Polish translation file)

Requirements

• Red-DiscordBot >= 3.5.0
• Python >= 3.8

Install

1. Put this cog folder in your custom cogs path.
2. In Discord:

[p]load tempvoice

Initial Setup (per server)

Use these commands on each guild:

[p]tempvoice setstart <voice_channel>
[p]tempvoice setcategory <category>

Check settings:

[p]tempvoice settings

Commands

Admin (manage_guild or admin)

• [p]tempvoice settings - show config and current state
• [p]tempvoice setstart <voice_channel> - set join-to-create channel
• [p]tempvoice setcategory <category> - set target category for temp channels
• [p]tempvoice cleanup - remove stale mappings and delete empty temp channels

User (channel owner)

• [p]tempvoice setlimit <0-99> - set user limit on your own temp channel
• [p]setlimit <0-99> - hidden backward-compatible alias

How It Works

1. User joins the configured start voice channel.
2. Cog creates (or reuses) an owner-mapped temporary voice channel in configured category.
3. User is moved to that channel.
4. When temporary channel is empty, it is deleted automatically.

Data Stored

Per guild:

• start_channel_id
• target_category_id
• channel_owners (mapping: temporary channel ID -> owner user ID)
• schema_version

Localization

• Runtime messages are localized via Red i18n.
• Included translation file: locales/pl-PL.po.
• Fallback language is English.

Troubleshooting

• If setup commands succeed but still print command errors, check bot logs and reload cog:

[p]reload tempvoice

• Ensure bot has:

  • Guild permission: Move Members
  • Category/channel permissions: View Channel, Connect, Manage Channels

• If state looks inconsistent:

[p]tempvoice cleanup