@@ -10,8 +10,6 @@ description = "how2 reaction role"
10
10
11
11
{{< youtube IaTfJ4vqHhc >}}
12
12
13
- [ Tutorial Video] ( https://www.youtube.com/watch?v=IaTfJ4vqHhc )
14
-
15
13
## Role Commands
16
14
17
15
{{< callout context="caution" title="Warning: Required Bot Permissions" icon="outline/alert-triangle" >}}
@@ -47,19 +45,15 @@ the role you are assigning either, _unless_ you wish to prevent the user from re
47
45
48
46
## Role Groups
49
47
50
- {{< callout context="note" title="Note: Role Menu Configuration" icon="outline/info-circle" >}}
51
-
52
- Role groups are essential if you want to set up a role menu.
53
-
54
- {{< /callout >}}
55
-
56
48
Role groups are useful for applying restrictions on a group of roles such as only being able to have one or the other
57
49
role etc. They're also essential if you want to create a role menu. To create one, simply give the role group a name and
58
50
then select which mode you want the role group to use.
59
51
60
52
Every role group, even Ungrouped has the option to delete all roles inside that group, other groups will not be
61
53
affected. Be careful with that, it's permanent and can't be undone.
62
54
55
+ They're essential if you want to create a role menu.
56
+
63
57
![ Creation of a role command group] ( role_command_group_creation.png )
64
58
65
59
### The different modes
@@ -124,22 +118,18 @@ starting. Role menu will **not** work if you have not done so.
124
118
125
119
{{< /callout >}}
126
120
127
- The role menu makes it possible to have people assign roles by adding reactions to a message.
121
+ The role menu makes it possible to have people assign roles by adding reactions to a message. If you'd like to create a
122
+ message like in the example to create a rolemenu on, take a look at the [ Custom Embeds] ( /docs/reference/custom-embeds )
123
+ chapter.
128
124
129
125
![ Example of a role menu] ( rolemenu_example.png )
130
126
131
- {{< callout context="note" title="Note: Custom Embeds" icon="outline/info-circle" >}}
132
127
133
- If you'd like to create a message like the above to create a rolemenu on, take a look at the
134
- [ Custom Embeds] ( /docs/reference/custom-embeds ) chapter.
135
-
136
- {{< /callout >}}
137
-
138
- {{< callout context="caution" title="Warning: Message Reactions Limit" icon="outline/alert-triangle" >}}
128
+ {{< callout context="note" title="Note: Message Reactions Limit" icon="outline/info-circle" >}}
139
129
140
130
A role menu can only support up to 20 roles due to the reaction limit discord places on messages.
141
- If your role group has more then twenty you have to use finish sub-command and then add the rest of roles to a new
142
- message with -skip flag.
131
+ If your role group has more than twenty you have to use the ` rolemenu finish` sub-command and then add the rest of roles
132
+ to a new message using the ` -skip ` flag.
143
133
144
134
{{< /callout >}}
145
135
@@ -153,14 +143,10 @@ message, or add new role to your role menu, be sure to read until the end.
153
143
154
144
### Step by step tutorial
155
145
156
- {{< callout context="caution" title="Warning: Prerequisites" icon="outline/alert-triangle" >}}
157
-
158
146
Make sure you created your [ role commands] ( #role-commands ) and assigned them a [ role group] ( #role-groups ) before
159
147
starting. Role menu will ** not** work if you have not done so. All switches and flags (nodm, rr, etc...) start with
160
148
hyphen symbol ` - ` , not your prefix.
161
149
162
- {{< /callout >}}
163
-
164
150
Once you've made your role commands and assigned them to a role group, go to the channel in Discord where you want the
165
151
role menu to be created. Then type ` -rolemenu create (group name) ` ; applying our "Sports" role group example, we'd have
166
152
to send ` -rolemenu create Sports ` .
@@ -180,7 +166,7 @@ And similar for the final role, **Basketball:**
180
166
181
167
![ Third reaction on a rolemenu setup] ( rolemenu_react_3.png )
182
168
183
- And we're done --- people can start using the menu by clicking on the reaction associated with their desired role.
169
+ And we're done---people can start using the menu by clicking on the reaction associated with their desired role.
184
170
The setup message will be automatically deleted in a couple of minutes, but you can also delete it manually, if you so
185
171
desire.
186
172
@@ -197,15 +183,11 @@ If you do not want the bot to send you a DM when you are given or removed from a
197
183
` -rolemenu update (message id) -nodm ` .
198
184
199
185
After you have finish editing or creating your role menu, it will display whether DM notifications are enabled or not.
200
-
201
- ![ Rolemenu flags display] ( rolemenu_flags.png )
202
-
203
- {{< callout context="caution" title="Warning: Errors Cannot be Disabled" icon="outline/alert-triangle" >}}
204
-
205
186
Note that YAGPDB does not allow you to disable error messages such as cool-down messages with the ` nodm ` switch or any
206
187
other method.
207
188
208
- {{< /callout >}}
189
+ ![ Rolemenu flags display] ( rolemenu_flags.png )
190
+
209
191
210
192
### Remove roles on reaction remove
211
193
@@ -242,13 +224,10 @@ If you added a new role to your role group, you can update your role menu. Updat
242
224
243
225
## How to get a message ID (Desktop)
244
226
245
- {{< callout context="note" title="Note: Developer Mode" icon="outline/info-circle" >}}
246
-
247
- Make sure you have [ developer mode turned on in your discord settings.] ( https://support.discordapp.com/hc/en-us/articles/206346498 )
248
-
249
- {{< /callout >}}
227
+ Make sure you have enabled [ developer mode] ( https://support.discordapp.com/hc/en-us/articles/206346498 ) in your Discord
228
+ settings.
250
229
251
230
To get the ID of the message you want to set the custom role menu on, click on the three dots on the far right hand side
252
- of the message and click on ` Copy ID. `
231
+ of the message and click on ` Copy Message ID ` .
253
232
254
233
![ Copying a message ID] ( copy_message_id.png )
0 commit comments