# How to connect to a match 

## With an existing match (recommended) 

1 - In-game create a Match or join an existing one 

2 - The creator of the match must enter `!mp addref <username of the bot>`

3 - Now the bot is allowed to connect to the match. To do so you have two solutions:

- Note that you will need the match id you can get it by accessing the match history that can be found in the match chat by typing `!mp settings` 
- Then you can either: 
    - Send a pm to the bot with the command `!join <match ID>`
    - Enter the `match ID` then click join from the **Bot** section of the client 
    
    
## With a new match 

**The bot can create a match for you and send you an invite when it is ready
Those matches are tournament matches, meaning that you can only create 5 of them and they will continue to live event after all players left until you or the bot close them. 
(The bot will always close an empty match if nobody joins it for 30 sec)**

1 - Send a pm to the bot with the command `!createroom <your match name>`

2 - You will receive an invite from the bot, click on it and start playing

### Related documentation
- [Bot commands](./commands.md)