Join to Create

Configure temporary voice channels that users can create on demand

Introduction

The Join to Create configuration file (join_to_create.json) allows you to set up voice channels that automatically create temporary, user-owned voice channels when joined. These temporary channels are deleted when empty.

---

Temporary Channels

Type: Array of Objects

Define which voice channels act as "join to create" triggers and where the temporary channels are created.

temporary_channels: [
    {
        voice_channel_id: "804354081711849492",
        category_id: "1196838574943907850",
        settings_id: "settings_1",
    },
]

voice_channel_id

Type: String

The ID of the voice channel that users join to create their temporary channel.

voice_channel_id: "804354081711849492"

When a user joins this channel, they are immediately moved to a new temporary channel created specifically for them.

---

category_id

Type: String

The Discord category ID where temporary voice channels will be created.

category_id: "1196838574943907850"

All temporary channels created from this join-to-create channel will appear in this category.

---

settings_id

Type: String

The ID of the settings configuration to apply to temporary channels. This references a settings object defined in the settings section below.

settings_id: "settings_1"

This allows you to have different configurations for different join-to-create channels.

---

Settings

Type: Object

Define different configuration sets for temporary voice channels. You can create multiple setting sets and reference them by ID.

settings: {
    "settings_1": {
        channel_name: "%user%'s call",
        user_limit: 4,
        locked: false,
        hidden: false,
        base_permission_role: "804354037662220289",
        blacklisted_roles: [],
    },
    "settings_2": {
        // Different configuration...
    },
}

---

channel_name

Type: String

The name format for created temporary voice channels.

channel_name: "%user%'s call"

Available Placeholder:

• %user% - Username of the channel creator

Examples:

• "%user%'s call" → "JohnDoe's call"

• "%user%'s Channel" → "JohnDoe's Channel"

• "Temp VC - %user%" → "Temp VC - JohnDoe"

---

user_limit

Type: Number (0-99)

Maximum number of users allowed in the temporary voice channel.

user_limit: 4

Values:

• 0 - No limit (unlimited users)

• 1-99 - Specific user limit

The channel creator can change this limit later using the /tempvoice command.

---

locked

Type: Boolean

Whether the temporary channel is locked by default (only the owner can join).

locked: false

When true:

• Only the channel owner can join initially

• Owner must manually allow others to join

• Useful for private channels

When false:

• Anyone with permissions can join

• More open for public use

The channel creator can toggle this later using the /tempvoice command.

---

hidden

Type: Boolean

Whether the temporary channel is hidden by default (only the owner can see it).

hidden: false

When true:

• Only the channel owner can see the channel

• Completely private until owner makes it visible

• Useful for private discussions

When false:

• Channel is visible to users with the base permission role

• More discoverable

The channel creator can toggle this later using the /tempvoice command.

---

base_permission_role

Type: String

The role ID that determines who can see and join temporary channels by default.

base_permission_role: "804354037662220289"

How it works:

• Users with this role (or higher in the role hierarchy) can see and join the channel

• Commonly set to a "Member" or "Verified" role to prevent unverified users from accessing

Tip: If your server has a verification system, set this to your verified member role to prevent unverified users from using temporary channels.

---

blacklisted_roles

Type: Array of Strings

List of role IDs that are not allowed to join temporary voice channels by default.

blacklisted_roles: [
    "123456789012345678",
    "234567890123456789",
]

Users with these roles cannot join temporary channels unless explicitly granted access by the channel owner.

Common use cases:

• Muted roles

• Banned from voice roles

• Restricted roles

---

Multiple Configurations Example

You can create different join-to-create channels with different settings:

{
    config: {
        temporary_channels: [
            {
                // Public temporary channels
                voice_channel_id: "804354081711849492",
                category_id: "1196838574943907850",
                settings_id: "public_settings",
            },
            {
                // Private temporary channels
                voice_channel_id: "123456789012345678",
                category_id: "234567890123456789",
                settings_id: "private_settings",
            },
            {
                // Gaming temporary channels
                voice_channel_id: "345678901234567890",
                category_id: "456789012345678901",
                settings_id: "gaming_settings",
            },
        ],

        settings: {
            "public_settings": {
                channel_name: "%user%'s Channel",
                user_limit: 0,
                locked: false,
                hidden: false,
                base_permission_role: "804354037662220289",
                blacklisted_roles: [],
            },
            "private_settings": {
                channel_name: "%user%'s Private Room",
                user_limit: 5,
                locked: true,
                hidden: true,
                base_permission_role: "804354037662220289",
                blacklisted_roles: [],
            },
            "gaming_settings": {
                channel_name: "%user%'s Gaming Session",
                user_limit: 10,
                locked: false,
                hidden: false,
                base_permission_role: "804354037662220289",
                blacklisted_roles: ["123456789012345678"],
            },
        }
    }
}

---

Complete Configuration Example

Here's a simple, production-ready configuration:

{
    config: {
        temporary_channels: [
            {
                voice_channel_id: "804354081711849492",
                category_id: "1196838574943907850",
                settings_id: "settings_1",
            },
        ],

        settings: {
            "settings_1": {
                channel_name: "%user%'s call",
                user_limit: 4,
                locked: false,
                hidden: false,
                base_permission_role: "804354037662220289",
                blacklisted_roles: [],
            },
        }
    }
}

How it works:

1. User joins the voice channel specified in voice_channel_id

2. Bot creates a new temporary channel in the specified category_id

3. User is moved to their new temporary channel

4. User becomes the owner and can manage the channel with /tempvoice

5. When all users leave, the channel is automatically deleted