# 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>

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rectorspace.com/rector-bot-alert/bot-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
