# Emote Wheel (Free Version)

Welcome to the free version of the "Emote Wheel" key binds. For the free version we have set it to be powered by the CMDs/CMD Groups - Please make sure that you have an adequate understanding of how to configure your CMDs and CMD Groups before starting your work on your "Emote Wheel". Should you need to review the documentation for them then please [<span style="text-decoration: underline; color: rgb(35, 111, 161);">**Click Here.**</span>](https://docs.veretech.systems/books/veretech-rce-bot/chapter/command-groups-cmds)

##### Emote Wheel Configuration (Binding)

To get started with your emote wheel binding, please ensure that you have your all the CMD Group names on which you want to bind to the Emote Wheel.

To get started we will need the command <span style="text-decoration: underline;"><span style="color: rgb(35, 111, 161); text-decoration: underline;">**/bind**</span><span style="color: rgb(35, 111, 161); text-decoration: underline;"> **add.**</span></span> You will now have a total of "7" options to choose from, "4"of which are mandatory. The options are as follows;  
  
<span style="text-decoration: underline;">**Mandatory -**</span>

**gameserver**: Please select the GameServer which you wish to create this bind for.

**command-group:** Please select the Command Group which you are going to be binding.

**emote:** This will be a selection for your emotes, you have 8 to choose from

**channel:** Because we have "Team", "Local" and "Server" selections in game when using the emotes, each one can be programmed for its own bind, giving you a total of "24" possible keybinds on the free version! If you don't want to select this option then choose the bind that will apply to "All"

<span style="text-decoration: underline;">**Optional -** </span>

**auth-group:** You can select which group can claim the kit, leave blank for all or choose from one of the following; VIP, Moderator, Admin &amp; Owner. *(You cannot have more than one auth group per bind)*

**server-cooldown:** How long the whole gameserver will have to wait between uses, as soon as one player redeems it, it is then unavailable to everyone until the cooldown has expired.

**player-cooldown:** How long each player must wait between each emote - If one player uses it, the cooldown only applies to that player.

**cooldown-message:** What to say when a player tries to use the emote with a cooldown still active. (*Profanity filters will apply*)

**Require Discord-Role:** You now have the option of requiring a user to have a discord role in order to be able to claim a bind. In order for this to work a player will need to be linked to their gamertag using /link and have the role in discord that you have set.

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-07/scaled-1680-/r9WZBmqxcZRK3A77-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-07/r9WZBmqxcZRK3A77-image.png)

Once a successful bind has been configured you will receive a confirmation message with your binding information, Please see the example below;

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/9fmAb0qatBxuTOMM-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/9fmAb0qatBxuTOMM-image.png)

Now all your players will have to do is select the "Emote" from the "Emote Wheel" in-game, for delivery of that set bind. Please ensure that players know which chat channel it is bound to, "Team", "Local" or "Server" as this will effect delivery. As mentioned earlier, if you do not choose "channel" then the bind will apply to "All" so this issue will not apply.

##### Editing a Bind

Should you wish to edit your current binds, change of kit, change of cooldown, change of message - Whatever it may be... We have enabled an editing command for this. <span style="text-decoration: underline; color: rgb(35, 111, 161);">**/bind edit**</span> will allow you to choose a bind to edit;

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/ZQWdjESOe9VRvKdB-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/ZQWdjESOe9VRvKdB-image.png)

You will have "8" options, of which "2" are mandatory and "6" are optional these are;  
  
<span style="text-decoration: underline;">**Mandatory -**</span>  
  
**gameserver** - Please select the GameServer you wish to change the keybind to.

**bind** - Please select the bind you wish to edit.

<span style="text-decoration: underline;">**Optional -**</span>

**command-group** - Please select the Command Group you wish to change to

**emote** - Please select the emote you wish to change to

**channel** - Please select the chat channel you wish to change to

**server-cooldown** - Please select this option to change the server cooldown timer.

**player-cooldown** - Please select this option to change the player cooldown timer.

**cooldown-message** - Please select this option to change the cooldown message displayed on screen.

<p class="callout info">(THIS REQUIRE DISCORD ROLE OPTION IS PREMIUM ONLY)</p>

**Require Discord-Role:** You now have the option of requiring a user to have a discord role in order to be able to claim a bind. In order for this to work a player will need to be linked to their gamertag using /link and have the role in discord that you have set.

Upon successful edit you will be greeted with the following message;

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/gVwRD6XzrS5YmOGo-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/gVwRD6XzrS5YmOGo-image.png)


##### Listing your Current Binds

Should you need to see all of your binds as a collective, you can do this on a per embed page bases, simple use the command <span style="text-decoration: underline; color: rgb(35, 111, 161);">**/bind list**</span> and select your game server. Upon sending this command you will be greeted with all of your "Emote Wheel" binds for that server.

<p class="callout warning">  
*Please Note: Because of character limits on embeds, these key binds are shown on pages.*</p>

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/1h5SfUpZE4d3pVLT-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/1h5SfUpZE4d3pVLT-image.png)

##### Deleting a Bind  


Should you wish to "Delete" your bind then we can do that also! Using the command <span style="text-decoration: underline; color: rgb(35, 111, 161);">**/bind delete**</span> we can delete your chosen bind. Simply select the gameserver you wish to remove a bind from, and then select the bind. Please see the example below;

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/Ywh9BJcmHFzcHITV-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/Ywh9BJcmHFzcHITV-image.png)  
  
Upon successful deletion you will receive a message of confirmation from the bot for its deletion. Shown below;

[![image.png](https://docs.veretech.systems/uploads/images/gallery/2024-05/scaled-1680-/q5GKdJt3MMR4CPw9-image.png)](https://docs.veretech.systems/uploads/images/gallery/2024-05/q5GKdJt3MMR4CPw9-image.png)

##### Placeholders for Use with Binds ONLY

<table border="1" id="bkmrk-type%3A-information-wi" style="border-collapse: collapse; width: 110.37%; height: 179.15px;"><colgroup><col style="width: 33.4981%;"></col><col style="width: 22.8677%;"></col><col style="width: 16.8109%;"></col><col style="width: 26.6996%;"></col></colgroup><tbody><tr style="height: 29.9167px;"><td style="height: 29.9167px;">To display Players Name  
</td><td style="height: 29.9167px;">GamerTag/PSN  
</td><td style="height: 29.9167px;">private\_wire  
</td><td style="height: 29.9167px;">{PlayerName}  
</td></tr><tr style="height: 29.9167px;"><td style="height: 29.9167px;">To display Players Console  
</td><td style="height: 29.9167px;">Which Console  
</td><td style="height: 29.9167px;">XBOX  
</td><td style="height: 29.9167px;">{GameConsole}  
</td></tr><tr style="height: 29.9167px;"><td style="height: 29.9167px;">To display cooldown as (DD:HH:MM:SS)  
</td><td style="height: 29.9167px;">Cooldown Timer  
</td><td style="height: 29.9167px;">1 Day, 12 Hours, 30 Minutes, 43 Seconds  
</td><td style="height: 29.9167px;">{Cooldown}  
</td></tr></tbody></table>

##### Steps to Bind A Kit

1. Create a command group using **/cmd group-add.** Name it anything you want, I normally use INEEDSTONE kitname servername.
2. Create the command using **/cmd add,** for the kit use position 0 Note you will need to replace the word kitname with the kit you have created on gportal. You will then input the command below into the command: box ```bash
    kit givetoplayer "kitname" "{PlayerName}"
    ```
3. If you want it to announce when a player receives a kit use **/cmd add** select position one and add the following, note you can customise the text to what you want  
    ```bash
    global.say {PlayerName} received a starterkit 
    ```
    
    4. Use /bind add as explained above

##### Steps to Bind A Teleport

1. Create a command group using **/cmd group-add.**
2. Create the command using **/cmd add,** for the teleport use position 0 Note you will need to replace the word (x,y,z) with your xyz you want them to teleport to. You will then input the command below into the command: box ```bash
    global.teleportpos (x,y,z) "{PlayerName}"
    ```
3. If you want it to announce when a player receives a kit use **/cmd add** select position one and add the following, note you can customise the text to what you want  
    ```bash
    global.say {PlayerName} teleported to outpost
    ```
    
    4. Use /bind add as explained above

##### Steps to Teleport and give a kit

1. Follow the steps above but place the cmds in the same command group. Use position 0 for the kit followed by position 1 for the teleport. If you want to announce it use position 3 and add the full message once.