RustPlusBot is a Rust+ Team Chat Discord ✔verified Bot that unlocks the full power of the Rust+ companion.
With RustPlusBot you can: receive notifications about in-game events, control Smart Switches, find vending machine items, and more... entirely in team chat! You can also use the bot's Discord commands to control Smart Switches and get useful team information in Discord.
The bot connects to a server in the same manner as the Rust+ mobile app, but intelligently handles team chat to process commands.
Display the items from recycling a paired Storage Monitor container contents
Promote yourself or a team member to team leader (when the bot is the team leader or the player has previously paired with the bot and server)
Lookup a player's online status using BattleMetrics
Track a player's joined or left status on the server using BattleMetrics
Display the server time, and when is the next night or day cycle
Display the server population including queue information
Display a team member's Steam reputation using Steamrep
Display all AFK team members and for how long
Locate team members and display their coordinates
Locate the team leader and leader map note, and show their coordinates
Display all nearby team members and their distance from you
Find vending machine items and related information
Find monuments and display their coordinates
Display a monument's radiation and minimum armor required
Be notified when a vending item becomes available using item name or item price
Be notified when a vending machine's contents change and show the difference
Be notified when a paired Storage Monitor's contents change and show the recyled items
Be notified when a paired Storage Monitor's contents contains an item quantity if it was recycled
Search for items in a Storage Monitored container
Display the contents of a Storage Monitored container
Display the upkeep for all paired Storage Monitored TCs
Track a vending item in a specific location on the map
Lookup the history of a specific vending item on the map
Lookup the top 5 most common vending items on the map
Lookup the RustLabs durability of items or building blocks
Lookup the RustLabs decay time for a building block
Lookup the RustLabs despawn time for an item
Lookup the RustLabs crafting cost and time for an item quantity
Lookup the RustLabs repair costs for an item or building block
Replace your timed water setup for farming with Smart Switch auto-toggling
Replace your Solar Panel activated night lights with a night-triggered Smart Switch
Automatically turn on your SAM site switch with a team offline status-triggered Smart Switch
Measure any length of time using the Stopwatch commands
Set reminders to be alerted in the future
List the latest Rustafied news entries
Mirror all or only mentions in team chat messages
Create useful trackers that automatically update their content
Control Smart Switches from a tracker
Control Smart Switches and get information from Smart Devices
Display server or device pairing, smart alarm, and player death alerts
Display a tracked player's joined or left status on the server using BattleMetrics
Display an alert when a team member comes online
Display the team roster including their coordinates
Display the most recent game events
Display the server information and map
Find vending machine items and related information
Start, stop, and restart the bot
Configure the bot's settings and permissions
Configure what game events the bot will announce
Configure aliases for the bot's commands and responses
Configure post-action team chat commands for: Server Connect, Player Death, Device On/Off, and Device Inactive
Configure your player tracking list and see the player tracker history
Manage your paired Smart Devices and unpair all or inactive only
Control Smart Switches and get real-time information from Smart Devices
Display the container contents of a paired Storage Monitor device
Get direct links to externally control Smart Devices using IFTTT
See the server's map and all markers / team members, and interact with it (including vending item searching / team chat display)
Install official plugins to expand the functionality of the bot
Create your own plugins for the bot in the Plugin Studio
Frequently Asked Questions (FAQ)
Quickly find answers to the most common questions about RustPlusBot:
Question: How many players can use the bot in the same Discord?
Answer: There is no limit to how many players can use the bot's commands, however, only one player can pair to the bot at a time (see Update Token).
Question: I've invited the bot to my Discord but nothing happened, now what?
Answer: Make sure RustPlusBot has the required permissions (see Inviting the Bot). If you can see the bot in the channel you are in, then type command: rp!config
Question: Is this cheating or some kind of exploit?
Answer: The bot talks to a server the same way the Rust+ mobile app does and therefore is not an exploit or cheat. Many server admins already allow its use and Facepunch has said they are ok with it.
Question: What servers has the bot been tested on or approved to use with?
Answer: The bot was developed while playing on Rusty Moose and PlayRust Reddit servers, and was allowed by the admins.
Question: Will the bot work on a modded server?
Answer: It may or may not work with a modded server. Some modded servers restrict team chat to the Rust+ service while in-game.
Question: Can I change the prefix or any bot commands?
Answer: You can change the bot's default prefix and create Aliases to change bot commands and its responses in RustPlusBot settings.
Question: Can I permit or restrict who can use the bot commands on my team?
Answer: You can create Permissions to restrict bot commands to certain players in RustPlusBot settings.
Question: Can I change the bot's language to something other than English?
Answer: Yes, you can change the bot's default output language in RustPlusBot settings.
Question: Can I control any Smart Switch on the map if I guess its device ID?
Answer: No. Building privilege is required to control a Smart Switch.
Question: How can I get team leader from others when using the promote command?
Answer: In order for other team members to promote when they are leader, they must have paired with the bot and the server at least once. This is because RustPlusBot requires their server connection information to take their leader.
Question: My Discord tracker isn't updating... is there something wrong?
Answer: If you are using the tracker in another channel, make sure you have given RustPlusBot the required permissions for that channel. If it still isn't updating, try restarting the bot using command rp!restart
Question: Is it possible to have the bot speak in the Discord?
Answer: Yes, if you enable the Text-to-Speech option in RustPlusBot settings then all team chat messages posted to Discord will be spoken.
Question: My server enforces a chat delay and I think it's messing up the bot, how can I fix this?
Answer: You can configure a team chat delay for the bot in RustPlusBot settings for your Discord.
Question: I've switched servers and paired the bot already, but I am still getting notifications from the previous one?
Answer: To unpair from the previous server: connect to the previous server in-game, and then press Escape, click Rust+ and click Disable.
Question: If I stop the bot when I'm not playing, will I still lose the bot's credit?
Answer: No. When the bot is stopped, your bot credit will not be deducted.
Question: How often will I have to update the bot's Steam Authorization token?
Answer: The bot's token typically lasts two weeks before expiring. You will be alerted in Discord to update it when this happens.
Question: How can I control the bot using my voice? Do I need Alexa or Google?
Answer: You can use your Amazon Alexa or Google Assistant to command the RustPlusBot after enabling the Alexa skill, or invoking the Assistant action (see Voice Control).
Question: If I switch Discord servers, do I keep the credit I've purchased?
Answer: Yes, please contact the developer (see below the questions) for assistance with your credit migration.
Question: How can I stop the bot's speech echo when multiple bot players are on the same team?
Answer: Use the !delay team chat command to delay your own bot's responses by one or more seconds. When your bot sees the same response was already spoken by another bot player, it will silence it.
Question: Are you also the developer of Rustangelo and Rustrician.io?
Answer: That is correct! RustPlusBot was created by the same developer with the support of many dedicated Rust players.
Question: I like the free trial, but why can't the bot just be free after?
Answer: The payments go towards continued bot development and help support the bot's operating costs.
Question: Is this listed on Top.gg so I can vote it?
Question: Why are Game Event notifications and commands disabled starting April 18, 2022 for servers: Rustoria, Rustopia, Rusticated, and Vital?
Answer: A senior developer for Rustoria, representing the listed servers above, has asked that the Game Event functionality of the bot be disabled on their servers. They strive for a level playing field and dislike the unfair advantage of the bot's Game Event notifications and commands. As a compromise to this dilemma and to avoid a ban, we have decided to disable the Game Event functionality starting April 18, 2022 on these servers.
Update: Zombie Land PVE servers will also have Game Event functionality disabled starting April 18, 2022.
Failure to grant the bot the required permissions above could cause a bot malfunction.
Configuring the Bot
Once RustPlusBot is invited to your Discord server, you will need to configure it. If the bot doesn't send a Discord message when it was invited, then it didn't have access to a channel to send a message. Once the bot is visible when viewing a channel, you can type: rp!config to get the configuration link.
Web Configuration Overview:
Access / Discord
Configure who can access this page and the bot's Discord channels.
Configure the bot's token and other RustPlusBot settings.
Configure game event settings for the bot.
Configure chat aliases and command permissions for the bot. (see examples below)
Configure Server Connected, Death, Smart Alarm / Switch, Device inactive team chat commands. (see examples below)
Configure smart device settings and manage paired devices.
Configure the server player tracking list.
Pair your Amazon Alexa or Google Assistant device to the bot, and use voice commands to control it.
Install plugins to add additional functionality to the bot.
Purchase credits to keep the bot alive!
Web Configuration Examples:
Chat Commands -> Aliases
Create aliases for incoming and outgoing chat commands and responses. The bot's input is changed to the output.
Example Input: !farm
Example Output: !tauto-timed 1m30s 1m 2h farmswitch
In this example, the incoming bot's message is changed to the output, which runs a command for the farmswitch device.
Chat Commands -> Permissions
Create permissions for chat commands. This will restrict the chat commands entered to only those allowed.
Example Command: !promote
In this example, the bot command !promote is restricted to only those added here with the !promote command.
Post-Action Commands -> Post-Connect
Execute team chat commands after the bot connects to a server.
Example Command: !tauto 3m 1m FarmSwitch
In this example, the device FarmSwitch continually turns On for 3 minutes and Off for 1 minute because this command will run when the bot connects to the server.
Post-Action Commands -> Post-Death
Execute team chat commands when there is a death notification.
Example Command: !on sam
In this example, the device sam will automatically turn on when the bot player receives a death notification.
Post-Action Commands -> Post-Alarm
Execute team chat commands when a paired Smart Alarm or Smart Switch is activated or deactivated.
Example Command: !on turrets
In this example, the device turrets will automatically turn on when the selected paired device is activated.
Post-Action Commands -> Post-Inactive
Execute team chat commands when a paired device becomes inactive.
Example Command: !bot Device xyz is broken!
In this example, the bot will say the message Device xyz is broken! when the selected paired device become inactive.
The bot requires a Steam Authorization token for the pairing listener which is required to connect to a server. You can update this token in the RustPlusBot configuration settings, pressing Update Token.
Toggle a Smart Switch device for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !ttoggle 5m spotlight
Example: !ttoggle 1m30s TurretDoors
!ton [time] [ID|name]
Toggle a Smart Switch device ON for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !ton 10m LaserLights
!toff [time] [ID|name]
Toggle a Smart Switch device OFF for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !toff 20m sams
!tauto [on_time] [off_time] [ID|name]
Repeatedly toggle a Smart Switch device ON and OFF for different amounts of time.on_time: The time to wait while ON (format: 1d1h1m1s) off_time: The time to wait while OFF (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Repeatedly toggle a Smart Switch device ON and OFF for different amounts of time until total time is reached.on_time: The time to wait while ON (format: 1d1h1m1s) off_time: The time to wait while OFF (format: 1d1h1m1s) total_time: The time to wait until expiring (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !tauto_timed 3m 1m 2h FarmSwitch
!ttoggle / !ttog / !ton / !toff / !tauto
Display all toggled devices and their time remaining.
Clear all or specific device toggle(s).ID|name: The identifier or paired name of the device (optional)
Stopwatch Time Measurement Measure any length of time with these Stopwatch commands.
Restarting the bot clears any active Stopwatches
Plugin chat commands:
Start a Stopwatch to begin measuring time.name: The name of the Stopwatch (optional)
Example: !startwatch mytimer
Stop a Stopwatch and display the measured time.name: The name of the Stopwatch (optional)
Example: !stopwatch mytimer
Display any active stopwatch(es) and their duration.
Storage Monitor Commands Useful commands for Storage Monitored devices.
Plugin chat commands:
Display paired storage devices containing the specified item.item: The name of the item in the container
Example: !contains rocket
The item results are sorted by highest to lowest quantity
Display the contents of a specified paired Storage Monitor container.ID|name: The identifier or paired name of the device
Example: !contents BoomBox
Display paired TCs and their upkeep.name: The name of the paired device (optional)
Example: !upkeep BaseTC
The TC results are sorted by lowest to highest upkeep time remaining
Team Activity Messages Automatically displays team activity messages when installed.
After installing this plugin, you will see messages such as Player1 is now online or Player2 has died @ J10
Plugin chat commands:
Display the last time a team member was seen online.name: The name of the team member
Example: !lastseen RustyMike
Display the last 5 team activity messages.
Display or set the AFK time in minutes.time: The AFK time in minutes (0 to disable) (optional)
Example: !teammsgs-afk 5
Team Offline Status Controlled Smart Switches Control Smart Switches using team offline status as a trigger.
Plugin chat commands:
Automatically turn on a Smart Switch when all team members are offline.ID|name: The identifier or paired name of the device
Example: !teamoffline-on SAM
Automatically turn off a Smart Switch when all team members are offline.ID|name: The identifier or paired name of the device
Check out the RustPlusBot plugin documentation and examples on GitHub.
The Plugin Studio can be accessed via a link in the Plugin settings tab on the RustPlusBot settings page for your Discord server.
Purchase bot credits to keep the bot alive! One credit is equal to 30 days of bot operation.
Payments help with continued bot development, bot operating costs, and routine maintenance. Thank you for your support!