> For the complete documentation index, see [llms.txt](https://docs.rectorspace.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rectorspace.com/rector-bot-alert/bot-commands.md).

# Bot Commands

***

## GENERAL

### rec.help

Displays this help message.

<figure><img src="/files/dkHHsYeVWtrriFoYS7xI" alt=""><figcaption><p>Help Page</p></figcaption></figure>

{% hint style="info" %}
`rec.` is the bot prefix, everyone has a different prefix. Your bot will have a unique prefix upon request, a custom prefix for sure !
{% endhint %}

***

### rec.servers

Lists all servers the bot is connected to.

<figure><img src="/files/fWnzQnHtTiUU3ZMMQSqd" alt=""><figcaption><p>Servers List</p></figcaption></figure>

***

### rec.resource

Shows the bot's memory usage.

<figure><img src="/files/ccPNSviZxN8HKP4dFldA" alt=""><figcaption><p>Bot Resource Usage</p></figcaption></figure>

***

### rec.guildroles

Displays all available roles on a specific guild server (default = all servers).

<figure><img src="/files/6f4HUqfwheK69bb3t9O6" alt=""><figcaption><p>Guild Roles Help Page</p></figcaption></figure>

<details>

<summary>Unveil Guild Server Roles: Explore the Roster!</summary>

**Usage**

```
rec.guildroles <guild_id>
```

**Parameters**

* **`<guild_id>`** (required): The Guild ID can be found by right-clicking on the server icon in Discord and selecting **"Copy Server ID"**.

**Examples**

```
rec.guildroles 123412341234
```

</details>

<figure><img src="/files/RyGJvD507UftnaiNBQLY" alt=""><figcaption><p>Example Result</p></figcaption></figure>

This command is useful for finding the role ID of the server your bot is on, for 'rec.add' purposes

***

### rec.invite

Shows the bot's invite link.

<figure><img src="/files/Auvjw9eYflolnsYtQz57" alt=""><figcaption><p>Bot Returns Their Invite Link</p></figcaption></figure>

Your bot must be invited manually by the server / client owner, they will usually ask for an invite link and you just have to give the link to them.

***

### rec.leaveguild

Instructs the bot to leave a specified server.

<figure><img src="/files/l0iq4lrTeOmFzqpJ74dZ" alt=""><figcaption><p>Leave Guild Help Page</p></figcaption></figure>

<details>

<summary>Instruct the Bot to Leave a Server</summary>

**Usage**

```
rec.leaveguild <guild_id>
```

**Parameters**

* **`<guild_id>`** (required): The Guild ID can be found by right-clicking on the server icon in Discord and selecting **"Copy Server ID"**.

**Example**

```
rec.leaveguild 123412341234
```

</details>

***

## BROADCASTING & GROUP

### rec.recall

Deletes the last broadcasted message.

<figure><img src="/files/Oj8bQxpJ4g8a9dth7cm6" alt=""><figcaption><p>Recall Success Report</p></figcaption></figure>

when you realize there is an error in calls / broadcast messages that have been sent to all client servers, recall is the right solution to delete them all automatically.

{% hint style="warning" %}
Please note, the deleted messages will be in order from the last one you sent, if you do the `rec.recall` command 2x, then your 2 broadcasts will be deleted.
{% endhint %}

***

### rec.add \<subcommand> \[channel] \[role]

Adds a channel and role.

<figure><img src="/files/BBRZcInoAqCqCGjrmwbS" alt=""><figcaption><p>Add Help Page</p></figcaption></figure>

<details>

<summary>Add or Link a Client Channel to a Broadcast Group</summary>

**Usage**

```
rec.add <broadcast_group_name> <channel> [role]
```

**Parameters**

* **`<broadcast_group_name>`** (required): The specific broadcast group to add the channel to. Available groups: bc0, bc1, bc3 ... bc99.
* **`<channel>`** (required): The channel to link to the bot's configuration. You can mention the channel or provide its ID.
* **`[role]`** (optional): The role to associate with the channel. You can mention the role or provide its ID. If not provided, the role will be set to **@everyone**.

**Examples**

```
rec.add bc0 #announcements @MentionableRole
rec.add bc69 986153785342722208 987654321098765432
rec.add bc77 1067772861026152580 @Moderators
```

</details>

***

### **rec.setrole \<subcommand> \[channel] \[new\_role]**

Updates the role for a specific channel.

<figure><img src="/files/HL1jhnUAJS28SSWs706p" alt=""><figcaption><p>Setrole Help Page</p></figcaption></figure>

<details>

<summary>Change the Ping Role for a Registered Channel in a Broadcast Group</summary>

**Usage**

```
rec.setrole <broadcast_group_name> <channel> [new_role]
```

**Parameters**

* **`<broadcast_group_name>`** (required): The broadcast group where the channel is registered. Available groups: bc0, bc1, bc3 ... bc99.
* **`<channel>`** (required): The channel for which you want to change the role. You can mention the channel or provide its ID.
* **`[new_role]`** (optional): The new role to associate with the channel. You can mention the role or provide its ID. If not provided, the existing role will remain unchanged.

**Examples**

```
rec.setrole bc0 #announcements @MentionableRole
rec.setrole bc69 986153785342722208 987654321098765432
rec.setrole bc77 1067772861026152580 @Moderators
```

</details>

***

### r**ec.remove \<subcommand> \[channel]**

Removes a channel and role.

<figure><img src="/files/0v1mQlHL6k4kg8qXBGOz" alt=""><figcaption><p>Remove Help Page</p></figcaption></figure>

<details>

<summary>Remove a Channel from a Broadcast Group</summary>

**Usage**

```
rec.remove <broadcast_group_name> <channel>
```

**Parameters**

* **`<broadcast_group_name>`** (required): The broadcast group from which the channel will be removed. Available groups: bc0, bc1, bc3 ... bc99.
* **`<channel>`** (required): The channel to remove from the bot's configuration. You can mention the channel or provide its ID.

**Examples**

```
rec.remove bc0 #announcements
rec.remove bc69 986153785342722208
rec.remove bc77 1067772861026152580
```

</details>

***

### **rec.show \<subcommand>**

Displays information for a specific group.

<figure><img src="/files/P3KmBGn8aKMurxGlUDxd" alt=""><figcaption><p>Show Help Page</p></figcaption></figure>

<details>

<summary>Display All Channels Integrated with the Bot in a Broadcast Group</summary>

**Usage**

```
rec.show <broadcast_group_name>
```

**Parameters**

* **`<broadcast_group_name>`** (required): The broadcast group to display. Available groups: bc0, bc1, bc3 ... bc99.

**Examples**

```
rec.show bc0
rec.show bc1
rec.show bc69
rec.show bc77
```

</details>

<figure><img src="/files/JbpQ5gts39rvPXYFNjha" alt=""><figcaption><p>Show Report</p></figcaption></figure>

bot displays all channels affiliated with broadcast group 'bc1'

***

### **rec.addgroup**

Adds a new broadcast group.

<figure><img src="/files/Oq1fbcAmrMDT6sYhqVa2" alt=""><figcaption><p>Add Group Confirmation Page</p></figcaption></figure>

<figure><img src="/files/rZj6MuhRLNaA5ECCs5tI" alt=""><figcaption><p>Timeout Addition Report</p></figcaption></figure>

If you do not enter the CAPTCHA for 15 seconds then everything will return to normal, there is no need for you to take any steps.

{% hint style="danger" %}
It is highly not recommended to use this command if you do not understand, you should contact me to do it.
{% endhint %}

***

### **rec.removegroup**

Removes an existing broadcast group. If you have previously added a group and want to delete it, please use this command.

<figure><img src="/files/W6UOD7CHiv2oMr3YwAGD" alt=""><figcaption><p>Remove Group Confirmation page</p></figcaption></figure>

same as `addgroup`, If you do not enter the CAPTCHA for 15 seconds then everything will return to normal, there is no need for you to take any steps.

<figure><img src="/files/VILFb7rjPtvtBcD1VUex" alt=""><figcaption><p>Timeout Deletion Report</p></figcaption></figure>

***

### **rec.showgroup**

Shows your current broadcast groups. By default you get 2 broadcast groups, bc0 and bc1. bc0 is a group that is intended as a testing group and bc1 is intended for the real broadcast group. you can add broadcast groups as you wish.

<figure><img src="/files/Bdu4gH4xxYeSWABPSrxQ" alt=""><figcaption><p>Broadcast Group Report</p></figcaption></figure>

{% hint style="success" %}
As you can see here, I have 9 broadcast groups, each of which has its own purpose.
{% endhint %}

***

### **rec.setsource**

Sets up a source channel for each group. This command is intended to set the source channel, the channel that has been set as the source will be where you make calls / analysis, and then the bot will forward (broadcast) the message to all servers from the affiliated group.

{% hint style="danger" %}
It is not recommended to use this command, you should contact me to do the initial setup of your bot.
{% endhint %}

<figure><img src="/files/1yBGnn6qQgT0DaW0CLU4" alt=""><figcaption><p>Set Source Group Channel Help Page</p></figcaption></figure>

<details>

<summary>Change the Channel ID of the Current Source Channel</summary>

**Usage**

```
rec.setsource <broadcast_group_name> <type_of_message> <source_channel>
```

**Parameters**

* **`<broadcast_group_name>`** (required): The broadcast group to modify. Available groups: bc0, bc1, bc3 ... bc99.
* **`<type_of_message>`** (required): The type of message format to apply.
  * `enp`: Embed without Ping Role
  * `ep`: Embed with Ping Role
  * `np`: Normal with Ping Role
  * `nnp`: Normal without Ping Role
* **`<source_channel>`** (required): The source channel to add to the bot's configuration. You can either mention the channel or provide its ID.

**Examples**

```
rec.setsource bc0 ep #say-ep
rec.setsource bc69 enp 123456789012345678
rec.setsource bc77 nnp 123456789012345678
```

</details>

***

### rec.setlog

Sets up a log channel for all bot activities.

<figure><img src="/files/ppSfslJgN1T9qLjEs1pK" alt=""><figcaption><p>Set Bot Log Help Page</p></figcaption></figure>

<details>

<summary>Change the Channel ID for Log Information</summary>

**Usage**

```
rec.setlog <channel>
```

**Parameters**

* **`<channel>`** (required): The channel where the bot will send its log information. You can either mention the channel or provide its ID.

**Examples**

```
rec.setlog #bot-logs
rec.setlog 123456789012345678
```

</details>

***

## CUSTOMIZATION

### rec.setpfp

Changes the bot's profile picture.

<figure><img src="/files/xqp8LeJzdu8yRj0N1tRb" alt=""><figcaption><p>Set PFP Help Page</p></figcaption></figure>

{% hint style="info" %}
It is recommended to use .jpeg / .jpg / .png image files
{% endhint %}

<details>

<summary>Replace the Bot's Profile Picture (PFP)</summary>

**Usage**

```
rec.setpfp + Attach your image file!
```

**Instructions**

Simply use the `rec.setpfp` command and attach the image file you want to use as the new profile picture for the bot.

</details>

***

### rec.setgroupname

Renames a broadcast group. In order for the bot to respond to the changes you make, after using this command it is mandatory to run the `rec.reload` command so that the bot refreshes itself automatically and the name of your broadcast group changes.

<figure><img src="/files/UjBM5VzYPqEULLIJqtVx" alt=""><figcaption><p>Set Group Name Help Page</p></figcaption></figure>

<details>

<summary>Set a Custom Name for Your Broadcast Group</summary>

**Usage**

```
rec.setgroupname <group_number> <new_group_name>
```

**Parameters**

* **`<group_number>`** (required): The broadcast group number. Available group numbers: 0 to 6.
* **`<new_group_name>`** (required): The new name for the broadcast group. It is recommended to use **ALL CAPITAL LETTERS** for better visibility. If the group name has more than one word, enclose it in quotation marks.

**Examples**

```
rec.setgroupname bc0 CRYPTO
rec.setgroupname bc69 "CRYPTO CALLS"
rec.setgroupname bc77 "TEST CALLS"
```

</details>

***

### rec.setusername

Updates the bot's username. Your bot username will change according to what you give, use characters that are still acceptable by the rules that discord has.

<figure><img src="/files/rAJY4zE6Icmpn7ByhWPO" alt=""><figcaption><p>Set Usernane Help Page</p></figcaption></figure>

{% hint style="warning" %}
Attention: do not use this command often, because discord has a rule not to change your bot username often, if possible if you have changed your bot username today, give it 24 hours to change the next username.
{% endhint %}

<details>

<summary>Replace the Bot's Username</summary>

**Usage**

```
rec.setusername <new_bot_username>
```

**Parameters**

* **`<new_bot_username>`** (required): The new username for the bot. You can use special characters, and the more unique the better. Note that Discord only allows changing the username every 2 hours.

**Examples**

```
rec.setusername Thę Rēct◎r (GPA4.0🎓)
rec.setusername Crypto Alert
rec.setusername ANALYST
rec.setusername Callers
```

</details>

***

### **rec.setprefix**

Changes your personal command prefix. prefix is ​​a specific and special command prefix for your bot, each Rector Alert Bot user will have a different prefix from one another. It is recommended that the prefix is ​​no more than 4 characters.

{% hint style="warning" %}
Attention: after changing the prefix, immediately contact me to do a hard restart of your bot, because the new prefix will not work if you only do a reload code command such as using the `rec.reload` command.
{% endhint %}

<figure><img src="/files/w6C4wLexI34or991bS5M" alt=""><figcaption><p>Set Prefix Help Page</p></figcaption></figure>

<details>

<summary>Change Your Personal Command Prefix</summary>

**Usage**

```
rec.setprefix <new_prefix>
```

**Parameters**

* **`<new_prefix>`** (required): The new prefix for your commands. It is recommended not to use special characters. A prefix of 3 letters followed by a dot (.) is ideal.

**Examples**

```
rec.setprefix rec.
rec.setprefix crypto.
rec.setprefix ?
rec.setprefix -
rec.setprefix !
```

</details>

***

### **rec.setfooter**

Updates the footer text for the bot's embedded messages.

<figure><img src="/files/Vm8K0Lcd9g2gm47zI3Yj" alt=""><figcaption><p>Set Footer Help Page</p></figcaption></figure>

<details>

<summary>Replace the Footer Text of the Bot's Embedded Message</summary>

**Usage**

```
rec.setfooter <new_footer_text>
```

**Parameters**

* **`<new_footer_text>`** (required): The new footer text for the bot's embedded message. It is recommended to keep the character length to **30 characters or fewer**, including spaces.

**Examples**

```
rec.setfooter Powered By ★ RZMetaversity.com
rec.setfooter linktr.ee/rzmetaversity
```

</details>

***

### rec.setwebsite

Changes the website link in the bot's status message.

<figure><img src="/files/UaXG05MAhxdpcQlN4oTI" alt=""><figcaption><p>Set Website Help Page</p></figcaption></figure>

<details>

<summary>Replace the Website Text in the Bot's Status Message</summary>

**Usage**

```
rec.setwebsite <new_website>
```

**Parameters**

* **`<new_website>`** (required): The new website text for the bot's status message. The recommended character length is **25 characters or fewer**, including spaces.

**Examples**

```
rec.setwebsite RZMetaversity.com
rec.setwebsite linktr.ee/rzmetaversity
```

</details>

***

### rec.seticon

Updates the icon in the footer of the bot's embedded messages.

<figure><img src="/files/sYo5gKfnI85hk8xn8gy4" alt=""><figcaption><p>Set Icon Help Page</p></figcaption></figure>

<details>

<summary>Replace the Icon in the Footer of the Bot's Embedded Message</summary>

**Usage**

```
rec.seticon <new_icon_url> / + upload an image
```

**Parameters**

* **`<new_icon_url>`** (required): Make sure the URL you provide is a direct link to an image.

**Examples**

```
rec.seticon https://link_to_image.png
rec.seticon https://link_to_image.jpg
rec.seticon + Upload an Image
```

</details>

***

### rec.setembedcolor

Customizes the default embed color for messages.

<figure><img src="/files/fu88IiDEOmvqleuM2gsD" alt=""><figcaption><p>Set Embed Color Help Page</p></figcaption></figure>

<details>

<summary>Change the Embed Color of the Bot's Embedded Message</summary>

**Usage**

```
rec.setembedcolor <new_hex_color>
```

**Parameters**

* **`<new_hex_color>`** (required): The HEX color code (a 6-character combination) without the `#` sign. You can visit [color-hex.com](https://www.color-hex.com/) to find your desired color.

**Examples**

```
rec.setembedcolor fcb708
```

</details>

***

## MAINTENANCE

### rec.reload

Reloads the bot’s code.

<figure><img src="/files/M2J63vBfLYfNfdLzA9fN" alt=""><figcaption><p>Reload Success Report</p></figcaption></figure>

***

### rec.botstatus

Displays your current subscription status with RZ Alert Bot.

<figure><img src="/files/9GuoAkE29b9ZeKLLQ8wl" alt=""><figcaption><p>Bot Subscription Status Report</p></figcaption></figure>

***
