Introduction
Last updated: November 20, 2023
RustPlusBot Official Links
RustPlusBot is the most advanced 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.
How does it work? The bot connects to your Rust server in the same manner as the Rust+ mobile app, but intelligently handles team chat to process commands. The Rust+ mobile app does not have to be installed on your phone to use the bot.
Have any questions? Take a look at the Frequently Asked Questions to get answers quickly, or you can contact the developer.
Videos
- Check out this MikeTheVike video on YouTube and see how RustPlusBot was integrated with a hotel on Rusty Moose!
- Interested in cameras and drones? Watch the Drone and Camera Tricks with RustPlusBot video on YouTube and see the camera station.
- Interested in cameras? Watch the PTZ Camera Tips and Tricks with RustPlusBot video on YouTube and see different camera tricks.
- Interested in automation? Watch the Smart Automated Furnace with RUSTPLUSBOT video on YouTube and see how to automate your furnaces.
- Interested in automation? Watch the SMART AUTOLOCKER 2.0 video on YouTube and see how RustPlusBot integrates with the Industrial Crafter.
Features
RustPlusBot has many powerful features accessible using team chat and Discord commands.
Feature Spotlight
Support for RustPlusBot on Stream Deck devices is now available! You can control your paired devices, get server events and information, and even use it as a mini-map.
The RustPlusBot plugin directly integrates with your bot, and is completely free. You can install it by accessing the Stream Deck store for your device. Click the Store icon and then click Plugins on the left.
Team Chat Features:
- Receive alerts for Patrol Helicopter, Cargo Ship, CH-47 Chinook (Heavy Scientists), Oil Rigs, and Locked Crate drop
- Display approx. time remaining until the next Heli, Cargo Ship, and Locked Crate should respawn
- Control individual Smart Switches or a group of Smart Switches using the same name
- Get real-time data from Smart Devices including the Storage Monitor
- Display Smart Alarm alert messages when activated
- Display Storage Monitor connected TC decaying alerts
- 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 registered with RustPlusBot)
- 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
- Set reminders to be alerted in the future
- Manage your auto turret placement using the Auto Turret Interference Calculator commands
- Measure any length of time using the Stopwatch commands
- List the latest Rustafied news entries
Discord Features:
- Mirror all or only team chat messages containing team member mentions
- Join your active voice channel to automatically say server event messages and other notification 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 server events
- Display the server information and map
- Find vending machine items and related information
- Start, stop, and restart the bot
Web Features:
- Configure the bot's settings and permissions
- Configure what server 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 a post-alarm to display the names of the players that your turret is targeting
- Configure your player tracking list and see the player tracker history
- Customize the bot's Discord notification's colors and channels
- Manage your paired Smart Devices and unpair all or inactive only
- Control Smart Switches and get real-time data from Smart Devices
- Display the container contents of a paired Storage Monitor device
- Get direct links to externally control Smart Devices using a Stream Deck or for use with IFTTT
- See the server's map and all markers / team members, and interact with it (including vending item searching / team chat display)
- View your CCTV cameras and control your Drones / PTZs / Turrets using the bot's Camera Station
- Install official plugins to expand the functionality of the bot
- Create your own plugins for the bot in the Plugin Studio
Other Features:
- Use your voice to talk to your bot with the Amazon Alexa skill or the Google Assistant action
- Use your Stream Deck to control your paired devices and view server info with the RustPlusBot plugin
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: Can other team members use the wire tool and receive device pairing notifications?
Answer: Only the player paired to the bot can receive device pairing notifications to pair devices with the bot.
- Question: I've invited the bot to my Discord but nothing happened, now what?
-
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 and others restrict map markers to disable bot events.
-
Question: The bot works on my modded server, but the events respawn faster. How can I configure this?
Answer: RustPlusBot allows you to configure the events respawn ratio in the Events config. Set this ratio to how fast events respawn, for example: 3 for 33% faster.
-
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. There is also a Black List you can configure to ignore certain players, or a White List to allow all.
-
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: Is it possible to toggle a device using only the paired name?
Answer: Yes, you can toggle any paired device by simply typing its name as the command (make sure you include the command prefix). Example:
!Turrets
-
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 registered with RustPlusBot at https://bot.rustplus.io/register.
- Question: I've changed servers and paired the bot, but it still connects to my old server?
-
Question: I've switched my server and paired the bot already, but I keep getting notifications from the previous one?
Answer: To unpair from the previous server: connect to the previous server and then press Escape, click Rust+, and click Disable.
-
Question: My bot has stopped responding to my commands even though it says it's connected when using rp!bot. How can I fix this?
Answer: It is recommended to reset the Rust+ communication with the server: While in-game, press Escape, click Rust+, and click Disable. Wait about ten seconds and then click Pair With Server.
- Question: My Discord tracker isn't updating... is there something wrong?
-
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: What happened to the oil rig respawn notification and bradley explosion announcement?
Answer: The Rust developers removed the ability for bots to have access to this information by making changes to the Rust+ service. See: May 4, 2023 Rust update
-
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: Can I use the bot to kick someone from the team?
Answer: Unfortunately you cannot. This is not supported by the Rust+ service.
-
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, you can use the RustPlusBot Credit Manager to transfer any available credits to another Discord server.
- Question: How can I stop the bot's speech echo when multiple bot players are on the same team?
-
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: Is this listed on Top.gg so I can vote it?
Answer: Yes, RustPlusBot is listed on Top.gg here: https://top.gg/bot/892190942352769075
-
Question: I've got a great idea for the bot... how can I create my own bot commands?
Answer: You can create your own plugins using the Plugin Studio!
Question: Why are Server Event notifications and commands disabled for select servers?
Answer: Server owners / admins have contacted us asking to disable this functionality. Instead of banning or blocking the RustPlusBot, these servers allow it because of the server events restrictions we have put in-place.
- Zombie Land PVE servers will have Server Event functionality disabled starting April 18, 2022.
- Corrosion PvE and Dukes of Rust servers will have Server Event functionality disabled starting June 10, 2022.
- PH Rust Pure PVP Main Vanilla server will have Server Event functionality disabled starting June 23, 2022.
- Blue Collar Rust servers will have Server Event functionality disabled starting June 30, 2022.
- RENEGADE 2x Monthly Main server will have Server Event functionality disabled starting July 8, 2022.
- Rust Empires server will have Server Event functionality disabled starting October 30, 2022.
- RFL servers will have Server Event functionality disabled starting November 28, 2022.
- RustNite servers will have Server Event functionality disabled starting November 28, 2022.
- Дальний Восток | Far East server will have Server Event functionality disabled starting March 5, 2023.
Didn't find the answer you were looking for?
- Post a question in the official RustPlusBot subreddit
- Chat with the community in #rust-plus-bot @ Rustricity Workshop Discord
- Contact the developer via e-mail: rustrician@gmail.com
Useful Tips
Quickly find useful tips for the RustPlusBot:
- To automatically be notified when a vending item is for sale, use team chat command
!watchfor
- To automatically be notified when a vending machine is stocked with an item, use team chat command
!vendtrack
- To automatically turn on a paired device when your entire team goes offline, use team chat command
!teamoffline-on
- To automatically turn on or off a paired device, use team chat commands
!auto-on
or!auto-off
- To automatically turn on your light switch at night (and off during the day), use team chat command
!night-on
- To be alerted when your paired device is destroyed, use Discord command
rp!subscribe
- To calculate the amount of crafting materials for an item, use team chat command
!craft
- To calculate the amount of decay time remaining for a building block, use team chat command
!decay
- To calculate the amount of recyclables from items, use team chat command
!recycle
- To calculate the result of a math expression, use team chat command
!calc
- To calculate your Auto Turret interference radius, use team chat commands
!turret-add
and!turret-check
- To change the bot's prefix ( ! ) to another symbol, configure Chat Command Prefix on the Commands tab
- To check the connection status of your bot, use Discord command
rp!bot
- To clear all inactive devices, use team chat command
!unpair-all
or in Discordrp!unpair_all
- To create a Discord UI for all paired TC's upkeep, use Discord command
rp!tracker upkeep
- To create a Discord UI for your player tracking list, use Discord command
rp!tracker tracking
- To create a Discord UI for your server events like heli or cargo, use Discord command
rp!tracker events
- To create a Discord UI for your server info including pop, use Discord command
rp!tracker info
- To create a Discord UI for your server's BattleMetrics, use Discord command
rp!tracker bm
- To create a Discord UI for your server's newest vending items, use Discord command
rp!tracker vending
- To create a Discord UI for your team member list, use Discord command
rp!tracker team
- To create a Discord UI with buttons for a paired device, use Discord command
rp!tracker_device
- To disable the automatic SAM Site turn on, use team chat command
!sam-delay 0
- To disable the Bradley Tank has respawned message, remove the Bradley Tank Respawn Notification plugin from the Plugins tab
- To find a team member's current location on the map, use team chat command
!locate
- To find an item in all paired storage containers, use team chat command
!contains
- To find the closest team member near you, use team chat command
!nearby
- To find the location of a monument on the map, use team chat command
!whereis
- To find where a team member's body location (where they last died), use team chat command
!death
- To fix device pairing issues with your bot, use Discord command
rp!repair
- To generate a random number between 1 and 100, use team chat command
!roll
- To have the bot join your voice channel and say announcements, use Discord command
rp!voice_join
- To hide the server name from all bot responses, check the Enable Streamer Mode box on the RustPlusBot tab
- To increase the team member AFK time, use team chat command
!teammsgs-afk 15
- To insert a message or add a prefix to the bot's responses, use team chat command
!prefix
- To monitor the items going in and out of a paired storage container, use team chat command
!monitor
- To promote yourself or a team member and make them leader, use team chat command
!leader
- To save a text note or to see your saved notes, use team chat commands
!note
and!notes
- To scan a camera and display all player names visible, use team chat command
!cam
- To search for a vending item for sale on the map, use team chat command
!vend
or in Discordrp!vend
- To search for a vending item for sale's price, use team chat command
!price
or in Discordrp!price
- To search for a vending item that is in-stock, use team chat command
!instock
- To see a random fortune cookie quote, use team chat command
!fortune
- To see a team member's Steam reputation information, use team chat command
!steamrep
- To see all team members who are off the screen, use team chat command
!hidden
- To see an ID tracked player's first seen name, use team chat command
!trackhistory
or in Discordrp!trackhistory
- To see how long until the next wipe is, use team chat command
!nextwipe
- To see info about any monument in Rust, use team chat command
!monument
- To see info about the Bradley Tank explosion event, use team chat command
!brad
- To see info about the Cargo Ship event, use team chat command
!cargo
- To see info about the Locked Crate event, use team chat command
!crate
- To see info about the Oil Rig crates, use team chat command
!oil
- To see info about the Patrol Helicopter event, use team chat command
!heli
- To see info about the server such as time or pop, use Discord command
rp!info
- To see information about the server, use team chat command
!info
- To see the BattleMetrics top 5 most played players list, use team chat command
!mostplayed
or in Discordrp!mostplayed
- To see the amount of radiation and the gear requirements for a monument, use team chat command
!rad
- To see the amount of scrap required to research an item, use team chat command
!blueprint
- To see the contents of a paired storage container, use team chat command
!contents
- To see the current number of players on the server, use team chat command
!pop
- To see the current time in Rust, use team chat command
!time
- To see the explosive costs to raid an item or building block, use team chat command
!durability
- To see the list of all offline team members, use team chat command
!offline
- To see the list of all online team members, use team chat command
!online
- To see the list of current and past server events, use Discord command
rp!events
- To see the names of members on your team, use Discord command
rp!team
- To see the online status of a player on the server, use team chat command
!whois
- To see the repair requirements for an item, use team chat command
!repair
- To see the server map and grid, use Discord command
rp!map
- To see the size of the map, use team chat command
!size
- To see the time it takes for an item to despawn, use team chat command
!despawn
- To see the total AFK time for a team member for the wipe, use team chat command
!afktime
- To see the total play time for a team member for the wipe, use team chat command
!playtime
- To see the total time the bot has been connected to the server, use team chat command
!uptime
- To see the upkeep of all paired TC devices, use team chat command
!upkeep
- To see the vending machine sale history for an item, use team chat command
!vendhistory
- To see the vending machine stats for an item, use team chat command
!vendstats
- To see the who is AFK and for how long, use team chat command
!afk
- To see when a team member was last seen online, use team chat command
!lastseen
- To see when the next day cycle is going to occur, use team chat command
!day
- To see when the next night cycle is going to occur, use team chat command
!night
- To see when the server last wiped, use team chat command
!wipe
- To see which team member has the highest AFK time for the wipe, use team chat command
!afktime-highest
- To see which team member has the highest play time for the wipe, use team chat command
!playtime-highest
- To see which team member has the lowest AFK time for the wipe, use team chat command
!afktime-lowest
- To see which team member has the lowest play time for the wipe, use team chat command
!playtime-lowest
- To see who has been alive the longest on your team, use team chat command
!alive
- To see your list of paired devices and their status, use Discord command
rp!devices
- To see your team member's distances to yourself, use team chat command
!proximity
- To see your team size and related team info, use team chat command
!team
- To send a message from the bot to team chat, use team chat command
!bot
- To send a message to Discord with Text-To-Speech TTS capabilities, use team chat command
!tts
- To set a reminder in which you will be notified when the time is up, use team chat command
!reminder
- To silence or mute the bot for a period of time, use team chat command
!mute
- To slow down the bot's responses by adding a delay, use team chat command
!delay
- To start and stop measuring a length of time, use team chat commands
!startwatch
and!stopwatch
- To stop seeing team member messages such as player died or is AFK, remove the Team Activity Messages plugin from the Plugins tab
- To track a player on the server using BattleMetrics, use team chat command
!track
or in Discordrp!track
- To track a player's BattleMetrics ID on the server, use team chat command
!trackid
or in Discordrp!trackid
- To translate a message from any language to English, use team chat command
!tr en
- To translate all bot responses to another language, configure Message Translation on the RustPlusBot tab