# [Matchmaking - Team Up](https://team-up-website-sveltekit.vercel.app/matchmaking/tutorials)

Looking for a simple way to help your Discord members connect with each other and host lobbies? With our easy-to-use button interface, your members can easily host and join lobbies with just a click. Plus, our bot automatically creates private voice channels for your lobby when it starts, ensuring a seamless and uninterrupted gaming experience. Add the Matchmaking bot to your server today!

## CREATE MATCHMAKING CHANNEL
### /create_matchmaking_channel
To create a matchmaking channel, you'll need to use the /create_matchmaking_channel command. This command will create an embed message in the channel you run it in. This message will have a button that allows users to host a match. It is recommended that you create a channel category with two text channels. One channel for the command to be run in that will show open lobbies. Another channel that show the in progress matches. Team Up should be the only member allowed to send messages in these channels.

#### team_size
The team_size parameter is the number of players that are on each team.

#### min_teams_required
The min_teams_required parameter is the minimum number of teams that are required before a host can start the match.

#### in_progress_match_channel
The in_progress_match_channel parameter is the channel that the in progress matches will be posted in. This channel should be a text channel that only Team Up can send messages to. If voice channels are created for the match then the voice channels will be posted in this channel.

#### host_option_*
The host_option_* parameters are the options that the host can choose from when creating a match. The host can choose one of these options when creating a match. If multiple options are provided then there will be a dropdown menu for the host to choose from. If only one option is provided then there will be a button for the host to click.

#### max_teams_allowed
The max_teams_allowed parameter is the maximum number of teams that are allowed to be created for a match. This is useful for games that allow a range of team sizes. For example, if you want to allow matches with 2-4 players then you would set team_size to 1 and min_teams_required to 2. Then you would set max_teams_allowed to 4. If this parameter is not provided then min_teams_required will be used as the default value.

#### create_voice_channels
The create_voice_channels parameter determines if voice channels will be created when a match starts. It has three options. Shared Voice Channel will create a single voice channel for all players in the match. Team Voice Channels will create a voice channel for each team in the match. Disabled will not create any voice channels,

## CREATE HEADLESS MATCHMAKING CHANNEL
### /headless_matchmaking_channel
The /headless_matchmaking_channel command creates a matchmaking channel with a join button instead of a host button. This can simplify the matchmaking process for some games.

#### title
The title parameter is the title of the embed message that is created when the command is run.

#### description
The description parameter is the description of the embed message that is created when the command is run.


#### team_size
The team_size parameter is the number of players that are on each team. Use 1 for free for all matches


#### teams_required
The teams_required parameter is the number of teams that are required to start a match.


#### lobby_notification_channel
The lobby_notification_channel parameter is the channel that the bot will post a message in when a lobby is created. This should be different from the channel that the command is run in so that the "join queue" button doesn't get buried.


#### create_voice_channels
The create_voice_channels parameter determines if voice channels will be created when a match starts. It has three options. Shared Voice Channel will create a single voice channel for all players in the match. Team Voice Channels will create a voice channel for each team in the match. Disabled will not create any voice channels,


#### max_elo_diff
The max_elo_diff parameter is the maximum difference in Elo rating that players can have to be matched together. This is useful for preventing high elo players from playing with low elo players.


#### leaderboard
The leaderboard parameter is the name of the leaderboard that players will be matched based on.


#### rating_type
The rating_type parameter is the type of rating that players will be matched based on


#### lobby_delete_minutes
The lobby_delete_minutes parameter is the number of minutes that a lobby will be open for before it is deleted. This is useful for preventing lobbies from staying open forever.

Matchmaking - Team Up

Looking for a simple way to help your Discord members connect with each other? Add the Matchmaking bot to your server today!

Voting for Matchmaking - Team Up

Do you want to support us?