# Game commands #### :crown: **Admin only commands** #### :bulb: **General command for everyone** **Required** parameters will be in \[Square brackets] **Optional** parameters will be in (Curly brackets) *** ## :crown: Recreate LoL draft Link ``` /game create_draft [gameid] ``` A draft link using is automatically sent to the lobby for [**League of Legends**](https://docs.inhousequeue.xyz/docs/preset-games#league-of-legends). This enhances the competitive experience for players. You can use this command to create another draft link at any time! {% hint style="info" %} This command only works for [**League of Legends**](https://docs.inhousequeue.xyz/docs/preset-games#league-of-legends), and the game must be in progress. {% endhint %} *** ## :crown: Recreate/Select ongoing games category ``` /game ongoing_games_category [game] (existing_category) ``` After [setup](https://docs.inhousequeue.xyz/docs/quick-start), InHouseQueue automatically creates team voice channels and a lobby text channel within the [default category](https://docs.inhousequeue.xyz/docs/quick-start#categories). The ongoing games category are where Voice and Lobby channels are created when a game starts to keep everything organised. This command lets you switch to a different category or create a new one. If you don't specify `(existing_category)`, InHouseQueue will create a brand-new category. Currently, you can only have **one** Category per [**Game**](https://docs.inhousequeue.xyz/docs/preset-games). If you delete this category, InHouseQueue will automatically recreate it when a game starts. ## :crown: **Substitute** ``` /game sub [player_1] [player_2] [gameid] ``` If a player needs to leave during a match, you can substitute them with another player instead of cancelling or voiding the game. * Player 1 is the player you want to remove. * Player 2 is the player replacing them.

Taking out Adolin and bringing in Dalinar. Game must be in progress.

* Channel permissions will immediately be granted to Player 2 and removed for Player 1. * Player 2 may need to leave and rejoin the Voice lobby in order for the Permissions to sync again. * You cannot use the `/game sub` command to "swap" players **within** a game. For example, you cannot swap players from Red to Blue team. The player being subbed in **must** not be part of the game. See the below [switch](#crown-switch-players) command for swapping players. {% hint style="info" %} This command only works if a game is in progress, meaning there must be an active voice and lobby channel. {% endhint %} *** ## :crown: **Switch Players** ``` /game swap [player_1] [player_2] (game_id) ``` If you just want to swap two players then you can do so with this command. Please note this will only work if: 1. The players are both in the **same** game 2. The game exists and is in progress * Player 1 and Player 2 are the two players you want to switch. Order **does not matter**.

Switching the teams of Stormblessed and Henry. Game must be in progress.

Once successful, the following actions will occur: 1. Channel permissions will immediately be swapped for Player 1 and Player 2. 2. Both players are automatically moved to their new Team voice channels (If they are inside a voice channel). 3. All required embeds will update to show the new teams. {% hint style="info" %} This command only works if a game is in progress, meaning there must be an active voice and lobby channel. {% endhint %} *** ## :crown: **Change results of a Game** ``` /change_winner [game_id] [team] ``` Modify or correct the outcome of a completed game. ### How it works: 1. Find the GameId you'd like to change. You can find this in your #match-history channel. 2. Select the GameId and the correct winning team. 3. Confirm the wins/losses have been changed using `/rank` or `/leaderboard`. {% hint style="danger" %} Before running this, please confirm players have **not** played another game after the Incorrect results. If they have, then their last game will essentially be wiped from history because of the nature of this command. {% endhint %}

*** ## :bulb: Begin vote for a Winner ``` /win ``` This is the preferred way to end a game. It initiates a vote inside the lobby channel, where players in the match will vote for either Red or Blue. A majority vote is required for the game to end. For example, in a **5v5** game, **6** votes are needed for a team to win. ### How it works To allow InHouseQueue to reward players with wins, losses, and MMR adjustments, it needs to know which team won. The easiest way to determine this is through a vote. InHouseQueue does **not** connect to external APIs— it is purely a Discord Bot designed to streamline InHouse management. Therefore, it cannot automatically detect when your game ends. 1. One of the players runs the `/win` command. Only players who participated in the match can use this command.

2. InHouseQueue will mention every player in the game to notify them that a vote has started. Players will vote for the team they believe won. Once the required majority is reached, the game will close shortly after, and players will be rewarded with their Points. 3. All corresponding game resources (voice channels, text channels, and roles) are removed from the server.

If the wrong team was selected as the winner, you can correct the results of a finished match using [`/change_winner`](#crown-change-results-of-a-game). **Administrators** and members with **manage channels** permissions may also start a vote. {% hint style="info" %} This command only works inside a Lobby channel. Channels explained [here](https://docs.inhousequeue.xyz/docs/quick-start#channels-and-categories-explained) {% endhint %} *** ## :crown: **Force a winner** ``` /winner [team] (loss_reduction) ``` Declare a winner immediately. While players can vote on the winning team with `/win`, admins can end a game immediately if needed. ### How it works: 1. There must be an ongoing game. Lobbies indicate ongoing games and are text channels named `#lobby-[gameid]`. More information on channels is [here](https://docs.inhousequeue.xyz/docs/quick-start#channels-and-categories-explained). 2. Run `/winner` and specify the team for the GameId you'd like to end. * For example, `/winner @Red: a4f0dc05` 3. The selected team is declared the winner, ending the game. All corresponding game resources (voice channels, text channels, and roles) are removed from the server.

### Loss reduction In some games you can reduce how much MMR the losing team drops. For example, if a team had an AFK halfway through, it wouldn’t be fair for them to take the full MMR hit. When using the `/winner` command, you can set a **loss reduction percentage**. This controls how much less MMR the losing team loses. For example, if you pick 100%, the losing team won’t lose any MMR for that match.

The match history embed will be updated to ensure players know that loss reduction was confirmed.

This is also logged in your [Admin log channel](https://docs.inhousequeue.xyz/docs/server-commands#crown-admin-only-commands). *** ## :crown: **Cancel game**: ``` /cancel [member] ``` Cancel an ongoing game. Select any member participating in an ongoing game to cancel it. All corresponding game resources (voice channels, text channels, and roles) are removed from the server. *** ## :crown: **Void Game** ``` /void [gameid] ``` Abort an ongoing game and clear all traces of it. This is a more aggressive version of [`/cancel`](#crown-cancel-game-), purging all traces of the GameId. All corresponding game resources (voice channels, text channels, and roles) are removed from the server. *** ## :bulb: **Abandon Game** ``` /abandon ``` Cancel an ongoing game after a vote. Any participant of an ongoing game can start a vote to cancel a game. A majority vote is required for the game to end. For example, in a **5v5** game, **6** votes are needed for the cancellation to proceed. Once passed, all corresponding game resources (voice channels, text channels, and roles) are removed from the server.

*** ## :crown: **Force start a game** ``` /force_start [gameid] ``` Start a game during the ready-up phase. The `/force_start` command allows Admins or authorized users to start a game during the ready-up phase without waiting for all players to indicate readiness. This is useful when some players are unresponsive.

*** ## :crown: **Customised lobby information**: ``` /lobby add_info [title] [description] (queue_channel) /lobby remove_info (queue_channel) ``` You can use a command to provide important information for each game when it starts. This is great for giving instructions or reminding players of rules. For example, you might want to ban certain characters due to a bug or remind players that one person should create the game in the dedicated client and invite everyone. You can add this information with `/lobby add_info` and remove it later with `/lobby remove_info`. From our experience we think this is a great feature to have enabled in the early days of using InHouseQueue. You may find that members will still need some guidance, this is a great way to provide it. ### How it works; 1. **Add Information:**\ Run the command `/lobby add_info` and enter the information you want players to see. These fields support [Discord Markdown](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline)

2. **Preview and Adjust:**\ Press enter, and you'll see a preview of your message. If you're happy with it, you're done! If not, rerun the command until you're satisfied.\ **Pro Tip:** Press the UP ARROW on your keyboard to quickly rerun the last command with all its content.

3. **In-Game Display:**\ The embed will now be sent to every game lobby.

{% hint style="info" %} You can remove custom lobby info with `/lobby remove_info` {% endhint %} *** ## :crown: **Grant a Coach role** ``` /coach [role] ``` Assign a Discord Role as a "Coach." Players with this role are allowed to join Blue and Red team voice lobbies and can talk inside the Lobby channel. Channels explained [here](https://docs.inhousequeue.xyz/docs/quick-start#channels-and-categories-explained) Depending on your server, you may want to grant this role to trusted players for additional access. While the role is labeled as "Coach," it doesn’t have to be used specifically for coaching—it can also be assigned to other trusted members to help moderate voice channels or perform other tasks. ***