Features

RustPlusBot has many powerful features accessible using team chat and Discord commands.

Team Chat Features:

---

• Use the RustPlusBot AI assistant to quickly get intelligent and accurate answers to questions about the bot and Rust
• Receive alerts for Patrol Helicopter, Cargo Ship, CH-47 Chinook, Oil Rigs, Traveling Vendor, and Locked Crate drop
• Display approx. time remaining until the next Heli, Cargo Ship, Traveling Vendor, 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 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 droprates for an item
• Lookup the RustLabs crafting cost and time for an item quantity
• Lookup the RustLabs mixing 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

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
• 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?
  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: I'm trying to pair with Rust+ in-game, but the Pair button is not showing on the screen... what should I do?
  Answer: You should install the Rust+ mobile app on your phone and login with your Steam account to fix this issue.
• 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: Can I use the bot with the console version of Rust?
  Answer: No. Unfortunately, there is not a console version of Rust+ yet.
• 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: You can configure options for various team chat announcements in RustPlusBot settings.
• Question: How do I turn off or disable the new vending machine and event announcements / notifications?
  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: I'm trying to pair a device, but the bot isn't receiving the notification... what is wrong?
  Answer: Most likely your bot's pairing needs to be updated. Go to RustPlusBot settings and update your token, then wait for the bot to connect to the server and try pairing the device again.
• 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?
  Answer: Try repairing the bot using command rp!repair and wait a minute for it to become active. Now try pairing your server again in-game: press Escape, click Pairing, and click Resend.
• 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 Pairing, and click Disable.
• Question: I'm trying to switch to another server, but my bot is not changing servers? I am also using the mobile app.
  Answer: Using the Rust+ mobile app can interfere with the bot's pairing capabilities. To fix this, go to RustPlusBot settings and update your token, then wait for the bot to become active. Now try pairing your server again in-game: press Escape, click Pairing, and click Resend.
• Question: I'm trying to change the paired player to the bot, however, it keeps staying paired to the same player?
  Answer: If your bot is still using the old player when updating the bot's token, then try using a different browser or device. Steam sometimes caches this info in the current browser.
• 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 Pairing, and click Disable. Wait about ten seconds and then click Enable.
• 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 there a limit of how many devices can be paired to the bot?
  Answer: There is a limit of 60, however, the Rust+ service will become sluggish after 30 paired devices because of the rate limiter.
• 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: The commands aren't working in team chat, but work when typed in Discord... what is wrong?
  Answer: This sometimes happens with modded servers... the server is probably blocking the incoming team chat that the bot receives. To get around this, you can enable the Silence the bot so it only responds to commands by posting to the Main Discord Channel option in RustPlusBot settings. However, you will still have to type the team chat commands in Discord.
• Question: What happened to the oil rig respawn notification and bradley tank 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: Why does the bot sometimes say the wrong location for the dropped locked crate and patrol heli crash?
  Answer: This is because both the dropped Locked Crate and Patrol Helicopter debris locations are estimated by the bot as a result of Facepunch limiting what information is sent to the bot via 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 incur usage.
• Question: How do I turn off the bot temporarily to not use my credit hours?
  Answer: Use the rp!stop command to stop or pause your bot and prevent it from using your credit.
• Question: Can I use the bot to kick or remove 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 to command the RustPlusBot after enabling the Alexa skill.
• 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?
  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: 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!

Useful Tips

Quickly find useful tips for the RustPlusBot:

• To add your own commands and custom functionality to the bot, access the RustPlusBot Plugin Studio page
• To ask the RustPlusBot AI assistant a question about the bot, server, team, and more, use team chat command !ai
• 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 after all team members are offline, use team chat command !teamoffline-on
• To automatically turn on a paired device after the first team member comes online, use team chat command !teamonline-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 an item or building block, use team chat command !decay
• To calculate the amount of mixing materials for an item, use team chat command !mix
• To calculate the amount of recyclables from items, use team chat commands !recycle , !recyclei , !recyclesafe , !recyclesafei
• 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 Discord rp!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 create a group of paired devices that you can control with a single command, simply pair your smart devices to the same name
• To disable the automatic SAM Site turn on, use team chat command !sam-delay 0
• 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 commands !contains and !containsi
• 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 lookup the droprates for a specific item, use team chat command !droprate
• To monitor the items going in and out of a paired storage container, use team chat command !monitor
• To pair your Amazon Alexa device with your bot and enable voice commands, access the RustPlusBot Voice Apps page
• 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 Discord rp!vend
• To search for a vending item for sale's price, use team chat command !price or in Discord rp!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 last 5 death locations on the interactive map, use team chat command !deathpin
• To see a team member's or Steam member's Rust stats, use team chat command !stats
• 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 Discord rp!trackhistory
• To see detailed server player tracking info, access the RustPlusBot Player Tracking page
• 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 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 Traveling Vendor event, use team chat command !vendor
• 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 amount of radiation and the gear requirements for a monument, use team chat command !rad
• To see the amount of scrap received when vendor exchanging an item quantity, use team chat command !scrap
• To see the amount of scrap required to research an item, use team chat command !blueprint
• To see the amount of time monument loot and keycards take to respawn, use team chat command !loot
• To see the BattleMetrics info for your server, use team chat command !bm or in Discord rp!bm
• To see the BattleMetrics top 5 most played players list, use team chat command !mostplayed or in Discord rp!mostplayed
• To see the bullet costs to raid an item or building block, use team chat command !durability-bullet
• To see the contents of a paired storage container, use team chat commands !contents and !contentsi
• To see the current number of players on the server, use team chat command !pop
• To see the current server pop and time with voice feedback, use team chat command !now
• To see the current status of a team member, use team chat command !teammate
• 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 connected players on the server, use Discord command rp!players
• To see the list of current and past server events, use Discord command rp!events
• To see the max health for an item, use team chat command !health
• To see the melee costs to raid an item or building block, use team chat command !durability-melee
• 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 siege weapon costs to raid an item or building block, use team chat command !durability-siege
• To see the size of the map, use team chat command !size
• To see the stats for the team or a specific team member, use team chat command !teamstats
• 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 vending item search results using chat emoji icons, use team chat commands: !vendi , !instocki , !pricei
• 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 monuments spawn a specific keycard, use team chat command !keycard
• 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 is AFK and for how long, use team chat command !afk
• To see who has been alive the longest on your team, use team chat command !alive
• To see your auto function devices, use team chat command !auto-list or in Discord rp!auto_list
• 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 set a timer with a message and be notified when the time is up, use team chat command !timer
• 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 death messages in team chat, use team chat command !teamdeaths-mute
• To stop seeing team member messages such as player died or is AFK, use team chat command !teammsgs-mute
• To track a player on the server using BattleMetrics, use team chat command !track or in Discord rp!track
• To track a player's BattleMetrics ID on the server, use team chat command !trackid or in Discord rp!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
• To view and quickly control your paired devices, access the RustPlusBot Paired Device Control Panel page
• To view the server map and see your team member's locations including heatmaps, access the RustPlusBot Interactive Map page
• To view your cameras and control your drones / turrets, access the RustPlusBot Camera Station page

Limitations

Listed below are all the limitations, or maximum limits, for RustPlusBot:

• 100 x Camera Identifiers added to the Camera Station
• 100 x Custom Markers pinned on the Interactive Map
• 999 x Heatmap Data Points per heatmap type
• 60 x Paired Smart Devices *
• 150 x Tracked Players
• Discord Trackers:
  • 1 x BattleMetrics trackers
  • 30 x Paired Device trackers
  • 1 x Player Tracking trackers
  • 2 x Server Events trackers
  • 2 x Server Information trackers
  • 1 x Team Members trackers
  • 1 x TC Upkeep trackers
  • 1 x Vending Items trackers
• Settings -> Commands:
  • 100 x Aliases
  • 100 x Permissions
  • 200 x Players Allowed (White List)
  • 200 x Players Denied (Black List)
• Settings -> Post-Action Commands:
  • 40 x Post-Alarm Commands
  • 20 x Post-Connect Commands
  • 20 x Post-Death Commands
  • 40 x Post-Inactive Commands


* It is recommended not to pair more than 30 devices since the bot will become sluggish after exceeding this amount.

Listed below are the capabilities and limitations of the Rust+ service that RustPlusBot operates on:

• Map markers that are viewable from Rust+ include:
  • Cargo Ship
  • CH-47 Chinook
  • Patrol Helicopter
  • Traveling Vendor
  • Team members
  • Team leader map notes (pins) and paired player map notes (pins)
  • Vending machines and vending machine items
• Map markers that are not viewable from Rust+ include:
  • Airdrops
  • APC Bradley Tank
  • Debris (explosion)*
  • Caves / God Rocks
  • Locked Crates **
  • Marketplace Drone
  • MLRS Rockets
  • Node Spawns
  • Quests
• Team chat is viewable and can send messages, while global chat is not accessible whatsoever
• Paired smart devices are controllable and their statuses can be viewed
• CCTV Cameras and Drones are controllable, and can be viewed while the paired player is offline
• Server information is viewable including server map and time
• Promoting a team member to team leader


* The Debris from an exploded Patrol Helicopter is simulated in the RustPlusBot Interactive Map.
** The dropped Locked Crate event is still supported by RustPlusBot as it uses experimental methods to observe it.
Seasonal events (Easter, Halloween, Christmas) information is not supported with Rust+

Inviting the Bot

To use the bot, you will need to invite it to your Discord server. Use the following link to invite it: https://bot.rustplus.io/invite

RustPlusBot requires these Discord permissions:

---

• Read Messages
• Send Messages
• Embed Links
• Add Reactions
• Use Application Commands

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.
• RustPlusBot
  • Configure the bot's token and other RustPlusBot settings.
• Events
  • Configure server event settings for the bot.
• Commands
  • Configure team chat aliases and command permissions for the bot. (see examples below)
• Post-Actions
  • Configure Server Connected, Death, Smart Alarm / Switch, Device inactive triggered team chat commands. (see examples below)
• Devices
  • Configure smart device settings and manage paired devices.
• Tracking
  • Configure the server player tracking list.
• Voice
  • Configure voice settings for the RustPlusBot.
• Plugins
  • Install plugins to add additional functionality to the bot.
• Payments
  • 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: !raid

  Example Output: !tts @everyone GETTING RAIDED!

  In this example, the incoming bot's message is changed to the output, which sends an announcement to Discord and pings the @everyone role. The !tts command is used because it can send a message directly to Discord, bypassing team chat.

  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.

  Example Input: !ai

  Example Output: !ai reply like a pirate:

  In this example, the bot's input for the !ai command is changed to the alias output, forcing the AI assistant to reply like a pirate to all questions asked. For example, the chat message !ai what is the pop? becomes !ai reply like a pirate: what is the pop?
• Chat Commands -> Permissions
  Create permissions for chat commands. This will restrict the chat commands entered to only those allowed.

  Example Command: !leader

  In this example, the bot command !leader is restricted to only those added here with the !leader 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.

  Example Command: !cam BASETURRET1

  In this example, the device is a Smart Alarm that is connected to the Has Target output of an Auto Turret. The turret has a camera ID set and that's the ID used in the command. When the turret is targeting it displays the names of players visible on the turret's camera.
• 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.

Update Token Instructions: https://www.youtube.com/watch?v=6ZcQTe-0Pns

Connecting to a Server

After you have completed updating the Bot Token (see above) follow these steps to pair with a server:

• Connect to a Rust server
• Once connected, press Escape and click Pairing
• If instructed to install the Rust+ mobile app, install it and login via Steam
• Click the Enable button, or Resend if you have previously paired
• Wait about a minute for the bot to connect to the server
• Check the bot's server connection using Discord command: rp!bot
• All done! Try using a team chat command in-game: !pop

Stream Deck Plugin Setup

Do you have a Stream Deck device? Install the RustPlusBot Stream Deck plugin to unlock the full potential of the bot!

Supported Stream Deck devices include: Classic, MK.2, XL, Mini, Neo, and mobile. The Stream Deck + device is not supported.

To find out what's new or past changes with the plugin, check out the plugin changelog.

How to setup the Stream Deck plugin actions:

---

• Camera Viewer
  View your CCTV cameras including drones and turrets.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
  • Manage the camera identifiers on the RustPlusBot Camera Station page.
• Paired Devices
  View and control your paired devices.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
  • Choose what device types appear in the list by checking or unchecking the types in the action properties.
• Server Events (Current)
  View the current server event times.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
• Server Events (Future)
  View the future server event times.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
• Server Information
  View the current server information.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
• Server Info + Events
  View the current server information and server events combined.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
• Server Map
  View the server map and map markers including team members.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
  • Select the team member to focus on when displaying the map (required).
  • Enable the follow heli option to automatically follow the Patrol Helicopter around the map.
• Team Members
  View team member information.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).
• Vending Items
  View recent vending machine items.
  • Drag and drop the action to an empty key to create it.
  • Input your bot's API Token on the action's properties panel (at the bottom).

Discord Commands Reference

Find the complete list of RustPlusBot's Discord commands below.

Bot Commands:

---

• rp!bot ^{(Slash command: /rustplusbot_status)}
  Display the status of the bot's server connection.
• rp!config ^{(Slash command: /rustplusbot_config)}
  Get the bot configuration link.
• rp!credits ^{(Slash command: /rustplusbot_credits)}
  Get the link to the bot's credit manager.
• rp!discord ^{(Slash command: /rustplusbot_discord)}
  Get the link to the bot's community Discord server.
• rp!guide ^{(Slash command: /rustplusbot_guide)}
  Get the link to the bot's setup guide on YouTube.
• rp!help ^{(Slash command: /rustplusbot_help)}
  Display helpful information about the bot and the link to view the entire command list.
• rp!repair ^{(Slash command: /rustplusbot_repair)}
  Repair and restart the bot to fix any device or server pairing issues.
• rp!reset ^{(Slash command: /rustplusbot_reset)}
  Reset the owner of the bot allowing access the bot's config.
  Requires the Administrator Discord permission to use this command
• rp!restart ^{(Slash command: /rustplusbot_restart)}
  Restart the bot's server connection.
• rp!start ^{(Slash command: /rustplusbot_start)}
  Start the bot's server connection.
• rp!stop ^{(Slash command: /rustplusbot_stop)}
  Stop the bot's server connection.
• rp!tip ^{(Slash command: /rustplusbot_tip)}
  Display a random useful tip about RustPlusBot.
• rp!voice_join ^{(Slash command: /rustplusbot_voice_join)}
  Invite RustPlusBot to join you in your active voice channel.
• rp!voice_greet ^{(Slash command: /rustplusbot_voice_greet)}
  Tell RustPlusBot to say a greeting in the active voice channel.
  To make the bot say a custom voice message, use team chat command !bot
• rp!voice_leave ^{(Slash command: /rustplusbot_voice_leave)}
  Tell RustPlusBot to leave the active voice channel.

Smart Device Commands:

---

• rp!auto_clear (name) ^{(Slash command: /rustplusbot_device_auto_clear)}
  Disable the automatic function for a Smart Switch device, or all devices.name: The paired name of the device (optional)

  Example: rp!auto_clear

  Example: rp!auto_clear Doors

  Are you trying to clear the auto-on function for the SAM Site? See the SAM Sites Auto-On After Delay plugin.
  Requires a server connection
• rp!auto_list ^{(Slash command: /rustplusbot_device_auto_list)}
  Display the devices that have an automatic function.
  Requires a server connection
• rp!auto_off [time] [name] ^{(Slash command: /rustplusbot_device_auto_off)}
  Automatically turn off a Smart Switch device after it is turned on.time: The auto off delay time (format: 1d1h1m1s)
name: The paired name of the device

  Example: rp!auto_off 1h30m Doors

  Requires a server connection
• rp!auto_on [time] [name] ^{(Slash command: /rustplusbot_device_auto_on)}
  Automatically turn on a Smart Switch device after it is turned off.time: The auto on delay time (format: 1d1h1m1s)
name: The paired name of the device

  Example: rp!auto_on 20m Turrets

  Requires a server connection
• rp!devices ^{(Slash command: /rustplusbot_devices)}
  Display the status of all paired Smart devices.
  Requires a server connection
• rp!on [ID|name] ^{(Slash command: /rustplusbot_device_on)}
  Turn On a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: rp!on turrets

  Requires a server connection
• rp!off [ID|name] ^{(Slash command: /rustplusbot_device_off)}
  Turn Off a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: rp!off turrets

  Requires a server connection
• rp!pair [ID] [name] ^{(Slash command: /rustplusbot_pair)}
  Assign a name to a Smart device.ID: The identifier for the Smart device
name: The name to assign to the paired device

  Example: rp!pair 123456789 turrets

  Example: rp!pair 123456789! iturrets

  Use the Wire Tool in-game to pair the bot with a Smart Device (Smart Alarm, Smart Switch, Storage Monitor)
  You can pair multiple identifiers to the same name to create a device group
  To invert the switch operation, append an exclamation mark (!) to the ID
  Not receiving any Smart Device pairing notifications? Try pairing again after repairing and restarting the bot using command rp!repair
  Requires a server connection
• rp!subscribe (@user/@role/@everyone) [ID|name] ^{(Slash command: /rustplusbot_subscribe | /rustplusbot_subscribe_role)}
  Receive @user / @role / @everyone alerts for Smart device notifications.@role: The @user or @role or @everyone/@here to subscribe with (optional)
ID|name: The identifier or paired name of the device

  Example: rp!subscribe BaseTC

  Example: rp!subscribe @RustTeam BaseTC

  Example: rp!subscribe @everyone BaseTC

  RustPlusBot requires the Mention @everyone, @here permission in the Discord channel
  Requires a server connection
• rp!subscriptions ^{(Slash command: /rustplusbot_subscriptions)}
  Display all paired device subscriptions.
  Requires a server connection
• rp!status [ID|name] ^{(Slash command: /rustplusbot_device_status)}
  Display the status of a Smart device.ID|name: The identifier or paired name of the device

  Example: rp!status turrets

  Requires a server connection
• rp!toggle [ID|name] ^{(Slash command: /rustplusbot_device_toggle)}
  Toggle On/Off a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: rp!toggle turrets

  Requires a server connection
• rp!unpair [ID|name] ^{(Slash command: /rustplusbot_unpair)}
  Forget a paired Smart device.ID|name: The identifier or paired name of the device

  Example: rp!unpair turrets

  Requires a server connection
• rp!unpair_all ^{(Slash command: /rustplusbot_unpair_all)}
  Forget all paired Smart devices.
  Requires a server connection
• rp!unpair_inactive ^{(Slash command: /rustplusbot_unpair_inactive)}
  Forget all inactive paired Smart devices.
  Requires a server connection
• rp!unsubscribe (@user/@role/@everyone) [ID|name] ^{(Slash command: /rustplusbot_unsubscribe | /rustplusbot_unsubscribe_role)}
  Stop receiving @user / @role / @everyone alerts for Smart device notifications.@role: The @user or @role or @everyone/@here to unsubscribe with (optional)
ID|name: The identifier or paired name of the device

  Example: rp!unsubscribe BaseTC

  Example: rp!unsubscribe @RustTeam BaseTC

  Requires a server connection

Discord Tracker Commands:

---

Discord Trackers are automatically updating Discord embeds, or Discord UIs, that provide useful information. Discord trackers are created in the Discord channel assigned in the bot's configuration. To remove a tracker, you can delete it by selecting Delete Message from the tracker's message options.

• rp!tracker [name] ^{(Slash command: /rustplusbot_tracker)}
  Create one of the several Discord trackers available below:name: The name of the Discord tracker to create

  Example: rp!tracker events

  • battlemetrics
    Create a Discord tracker for BattleMetrics information.
  • events
    Create a Discord tracker for server events information.
  • info
    Create a Discord tracker for server information.
  • team
    Create a Discord tracker for team information.
  • tracking
    Create a Discord tracker for player tracking information.
  • upkeep
    Create a Discord tracker for all paired Storage Monitor's upkeep.
  • vending
    Create a Discord tracker for newest vending machine items.
  RustPlusBot requires the Manage Messages permission in the Discord Tracker channel
  Most trackers can be configured by clicking on their settings gear
  Requires a server connection
  The events tracker is disabled for select servers. More info
• rp!tracker_color [ID] [color] ^{(Slash command: /rustplusbot_tracker_color)}
  Change the color for a Discord tracker using its Message ID.ID: The Message ID of the Discord tracker copied from Discord with Developer Mode enabled
color: The hexadecimal color code

  Example: rp!tracker_color 1234567890 #ff0000

  Enable Developer Mode in Advanced Discord settings to unlock the Copy ID menu. More info
  Requires a server connection
• rp!tracker_device [ID|name] ^{(Slash command: /rustplusbot_tracker_device)}
  Create a Discord tracker for a Smart device.ID|name: The identifier or paired name of the device

  Example: rp!tracker_device Turrets

  Create the trackers in their own channel so they don't get lost in the bot's messages
  The device tracker can be configured by clicking on the settings gear (Smart Switch only)
  Requires a server connection

Server Commands:

---

• rp!battlemetrics ^{(Slash command: /rustplusbot_battlemetrics)}
  Display the BattleMetrics information of the server.
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• rp!events (name) ^{(Slash command: /rustplusbot_events)}
  Display the most recent events observed on the server.name: The name of the event to filter using (optional)

  Example: rp!events

  Example: rp!events oil

  Requires a server connection
  Server Event commands are disabled for select servers. More info
• rp!info ^{(Slash command: /rustplusbot_info)}
  Display the server information.
  Requires a server connection
• rp!map ^{(Slash command: /rustplusbot_map)}
  Display the server map.
  Requires a server connection
• rp!mostplayed ^{(Slash command: /rustplusbot_mostplayed)}
  Display the top 10 players on the server and their time played.
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• rp!players ^{(Slash command: /rustplusbot_players)}
  Display all connected players on the server.
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• rp!track [name] ^{(Slash command: /rustplusbot_track)}
  Track a player's joined/online or left/offline status on the server using BattleMetrics. To track a player using their BattleMetrics ID, use command: rp!trackid name: The name of the player to track

  Example: rp!track RustyPlayer2099

  Example: rp!track "Rusty Mike"

  Enclose name with quotes to exactly match the name
  Requires a BattleMetrics ID in RustPlusBot configuration settings
  Does not work with Streamer Mode enabled servers (including Official servers)
• rp!trackclear ^{(Slash command: /rustplusbot_trackclear)}
  Clear the server player tracking list. (untrack all players)
• rp!trackhistory [ID] ^{(Slash command: /rustplusbot_trackhistory)}
  Display the recent player names for a player's BattleMetrics ID.ID: The BattleMetrics ID of the player in the rp!trackid list

  Example: rp!trackhistory 112233

• rp!trackid [ID] ^{(Slash command: /rustplusbot_trackid)}
  Track a player's joined/online or left/offline status on the server using their BattleMetrics ID. This does not track a Steam ID.ID: The BattleMetrics ID of the player to track

  Example: rp!trackid 112233

  Enter a player name instead of an ID to automatically track the BattleMetrics ID of the first tracked player that joins the server
  Find the BattleMetrics ID for a player by accessing the BattleMetrics page for your server, and then finding the player ID from the player name link
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• rp!trackstatus (ID|name) ^{(Slash command: /rustplusbot_trackstatus)}
  Display the recent tracking status for tracked players.name: The ID or name of the player in the rp!track list (optional)

  Example: rp!trackstatus

  Example: rp!trackstatus 112233

• rp!untrack [name] ^{(Slash command: /rustplusbot_untrack)}
  Remove the specific player name from the rp!track list.name: The name of the player in the rp!track list

  Example: rp!untrack RustyPlayer2099

• rp!untrackid [ID] ^{(Slash command: /rustplusbot_untrackid)}
  Remove the specific player ID from the rp!trackid list.ID: The BattleMetrics ID of the player in the rp!trackid list

  Example: rp!untrackid 112233

Team Commands:

---

• rp!register ^{(Slash command: /rustplusbot_register)}
  Get the link to the bot's team leader transfer registration.
• rp!team ^{(Slash command: /rustplusbot_team)}
  Display the list of team members.
  Requires a server connection

Vending Machine Commands:

---

• rp!price [query] ^{(Slash command: /rustplusbot_price)}
  Search for and display the quantity and location of a specific vending item using the sell name (currency to buy item).query: The name of the vending item to search for (can include a quantity)

  Example: rp!price 1000 Stones

  Example: rp!price 10 Rifle Body

  Example: rp!price >= 100 scrap

  Example: rp!price >= scrap x 100

  The vending item results are sorted by highest to lowest quantity
  Requires a server connection
• rp!vend [query] ^{(Slash command: /rustplusbot_vend)}
  Search for and display the quantity and location of a specific vending item using the buy name (item being sold).query: The name of the vending item to search for (can include a quantity)

  Example: rp!vend Workbench Level 3

  Example: rp!vend 1000 Stones

  Example: rp!vend <= 100 scrap

  Example: rp!vend <= scrap x 100

  The vending item results are sorted by highest to lowest quantity
  Requires a server connection

Team Chat Commands Reference

Find the complete list of RustPlusBot's team chat commands below.

AI Assistant Command:

---

Repeated abuse or persistent misuse of the RustPlusBot AI may lead to permanent suspension of access.
• !ai [question] / !assistant [question]
  Ask the RustPlusBot AI assistant a question about your bot, server, events, team members, tracked players, paired devices, saved notes, timers that are currently active, or Rust items / building blocks. (Note: vending machine item listings are not supported at this time)question: The question to ask

  Example: !ai what is rustplusbot?

  Example: !ai what time is it ingame?

  Example: !ai is the heli active?

  Example: !ai when will cargo respawn?

  Example: !ai oil status?

  Example: !ai what events are active?

  Example: !ai how long does loot crates take to respawn?

  Example: !ai are any tracked players online?

  Example: !ai 2 c4 enough for armored door?

  Example: !ai decay time for stone wall with 100 hp?

  Example: !ai metal wall 600 hp, i have 1 rocket and how much explo?

  Example: !ai how many c4 and explosive ammo for a garage door if both are used together?

  Example: !ai how much sulfur for 200 explo?

  Example: !ai how many rockets can I craft from 120k sulfur?

  Example: !ai mix 50 explosives

  Example: !ai recycle 10 auto turrets

  Example: !ai l96 droprate

  Example: !ai repair snowmobile

  Example: !ai garage door bp

  Example: !ai what cards and how many fuses for launch?

  Example: !ai give me a current status report

  Example: !ai time in russia?

  Example: !ai pop, but reply like a pirate

  Example: !ai what are my team stats?

  Example: !ai who is the weakest link on the team?

  Example: !ai how much credit remaining?

  The RustPlusBot AI can learn new knowledge that you tell it in a saved note, use team chat command !note
  The RustPlusBot AI is still in early development and is continuously being improved. Response times and answers to questions can vary
  The RustPlusBot AI is not conversational and does not have knowledge of any previously asked questions
  The RustPlusBot AI cannot directly control paired devices or execute commands, instead it will recommend what command to use

Bot Commands:

Include Plugin Commands

---

• !bot [msg]
  Send a team chat message prefixed with BOT.msg: The message to send

  Example: !bot This is an announcement!

  The message will also be spoken if RustPlusBot is in a voice channel
• !calculate [expression] / !calc [expression]
  Calculate the result of a mathematical expression.expression: The mathematical expression to evaluate

  Example: !calc 1 + 2 / 3 * 100

  Be sure to only use mathematical symbols in your expression such as + - * /
• !help
  Display helpful information about the bot and the link to view the entire command list.
• !delay [time]
  Delay the bot's team chat messages for a specified amount of time (1-10 seconds).time: The delay time (format: 1d1h1m1s)

  Example: !delay 5s

  Use this when there are multiple bot players on the same team
  Only the bot player can use this command
  Restarting the bot clears the delay
• !prefix [message]
  Set a prefix message for the bot's team chat messages.message: The prefix message

  Example: !prefix RustPlusBot |

• !prefix-clear
  Clear the bot's team chat prefix message.
• !silent (time) / !mute (time)
  Quiet the bot's team chat messages for a minute or a specified amount of time.time: The silence time (format: 1d1h1m1s) (optional)

  Example: !silent

  Example: !silent 5m

• !tip (filter)
  Display a random useful tip about RustPlusBot.filter: The text used to filter the tips (optional)

  Example: !tip

  Example: !tip device

• !translate [language] [message] / !tr [language code] [message]
  Translate a message from any language to another.language code: The language code to translate to
message: The message to translate

  Example: !tr es Please translate this message

  Example: !tr zh I'm speaking chinese!

  See the entire list of language codes here: https://bot.rustplus.io/languages
• !tts [msg]
  Post a message to Discord with Text-to-Speech (TTS) enabled.msg: The message to post to Discord with TTS enabled

  Example: !tts Hello from Rust

• !uptime
  Display how long the bot has been connected to the server.
• !unsilent / !unmute
  Stop silencing the bot's team chat messages.

Smart Device Commands:

Include Plugin Commands

---

• !auto-clear [name]
  Disable the automatic function for a Smart Switch device.name: The paired name of the device

  Example: !auto-clear Doors

  Use command !auto-clear-all to clear all automatic device functions
  Are you trying to clear the auto-on function for the SAM Site? See the SAM Sites Auto-On After Delay plugin
• !auto-list
  Display the devices that have an automatic function.
• !auto-off [time] [name]
  Automatically turn off a Smart Switch device after it is turned on.time: The auto off delay time (format: 1d1h1m1s)
name: The paired name of the device

  Example: !auto-off 1h30m Doors

• !auto-on [time] [name]
  Automatically turn on a Smart Switch device after it is turned off.time: The auto on delay time (format: 1d1h1m1s)
name: The paired name of the device

  Example: !auto-on 20m Turrets

• !on [ID|name]
  Turn on a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: !on turrets

• !off [ID|name]
  Turn off a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: !off turrets

• !pair [ID] [name]
  Assign a name to a Smart device.ID: The identifier for the Smart device
name: The name to assign to the paired device

  Example: !pair 123456789 turrets

  Example: !pair 123456789! iturrets

  Use the Wire Tool in-game to pair the bot with a Smart Device (Smart Alarm, Smart Switch, Storage Monitor)
  You can pair multiple identifiers to the same name to create a device group
  To invert the switch operation, append an exclamation mark (!) to the ID
  Not receiving any Smart Device pairing notifications? Try pairing again after repairing and restarting the bot using command rp!repair
• !status [ID|name]
  Display the status of a Smart device.ID|name: The identifier or paired name of the device

  Example: !status turrets

• !toggle [ID|name] / !tog [ID|name]
  Toggle a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: !tog turrets

• !unpair [ID|name]
  Forget a paired Smart device.ID|name: The identifier or paired name of the device

  Example: rp!unpair turrets

• !unpair-all
  Forget all paired Smart devices.
• !unpair-inactive
  Forget all inactive paired Smart devices.

Server Commands:

Include Plugin Commands

---

• !bm / !battlemetrics
  Display the BattleMetrics information for your server.
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• !cam [ID] / !camera [ID]
  Scan a camera for any visible players and display their names.ID: The identifier of the camera

  Example: !cam MYCAMERA

  Requires a sleeper or an alive player of the player paired to the bot on the server
  Cameras are only viewable while the paired player is offline and monument / static cameras can no longer be viewed since the May 4, 2023 Rust update
• !cams [name] / !cameras [name]
  Display all camera IDs for a camera group or monument.name: The name of the camera group. Group names: airfield, bandit, dome, loil, missile silo, outpost, smoil

  Example: !cams smoil

  Example: !cams loil

  Ask the RustPlusBot AI assistant for this information, for example: !ai large oil cams?
• !camsall (ID)
  Scan all cameras in the Camera Station list, and display any visible player names and the camera ID.ID: The identifier of the camera (optional)

  Example: !camsall

  Example: !camsall base

  Configure the camera list using the RustPlusBot Camera Station
  Requires a sleeper or an alive player of the player paired to the bot on the server
  Cameras are only viewable while the paired player is offline and monument / static cameras can no longer be viewed since the May 4, 2023 Rust update
• !day
  Display the time remaining until the next day cycle.
  Ask the RustPlusBot AI assistant for this information, for example: !ai when is day?
• !info
  Display the server information.
• !loot
  Display the amount of time monument loot and keycards take to respawn.
  Ask the RustPlusBot AI assistant for this information, for example: !ai server respawn rate?
• !mostplayed
  Display the top 5 players on the server and their time played.
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• !night
  Display the time remaining until the next night cycle.
  Ask the RustPlusBot AI assistant for this information, for example: !ai when is night?
• !pop
  Display the current server population and queue.
  Ask the RustPlusBot AI assistant for this information, for example: !ai pop
• !size
  Display the map size of the server.
  Ask the RustPlusBot AI assistant for this information, for example: !ai server size and seed?
• !stats (player)
  Display the Rust stats for yourself, a team player, or a server player's Steam ID. The stats include: Wood collected, Stones collected, Metal Ore collected, Cloth collected, total scientist kills, total player kills, total deaths, K/D ratio, and total game hours.player: The name of a team player or Steam ID of a Steam member (optional)
  Example: !stats Rusty Mike

  Example: !stats 76561197886880999

  Player stats are only collected while playing on Official Servers
  Player stats are only visible for players who have a Steam profile set to public
• !time
  Display the current server time.
  Ask the RustPlusBot AI assistant for this information, for example: !ai server time?
• !track [name]
  Track a player's joined/online or left/offline status on the server using BattleMetrics. To track a player using their BattleMetrics ID, use command: !trackid name: The name of the player to track

  Example: !track RustyPlayer2099

  Example: !track "Rusty Mike"

  Enclose name with quotes to exactly match the name
  Requires a BattleMetrics ID in RustPlusBot configuration settings
  Does not work with Streamer Mode enabled servers (including Official servers)
• !track
  Display the list of current !track player names.
• !trackclear
  Clear the list of all !track player names. (untrack all players)
• !trackhistory [ID]
  Display the recent player names for a player's BattleMetrics ID.ID: The BattleMetrics ID of the player in the !trackid list

  Example: !trackhistory 112233

  Use command !trackhistory-all to see all player names when there are too many to display
• !trackid [ID]
  Track a player's joined/online or left/offline status on the server using their BattleMetrics ID. This does not track a Steam ID.ID: The BattleMetrics ID of the player to track

  Example: !trackid 112233

  Enter a player name instead of an ID to automatically track the BattleMetrics ID of the first tracked player that joins the server
  Find the BattleMetrics ID for a player by accessing the BattleMetrics page for your server, and then finding the player ID from the player name link
  Requires a BattleMetrics ID in RustPlusBot configuration settings
• !tracklast
  Track the last player that was looked up using the !whois / !whoisid command.

  Example: !tracklast

  Requires a BattleMetrics ID in RustPlusBot configuration settings
• !trackstatus (ID|name)
  Display the recent tracking status for tracked players.name: The ID or name of the player in the !track list (optional)

  Example: !trackstatus

  Example: !trackstatus 112233

  Use command !trackstatus-all to see all tracked players when there are too many to display
  Ask the RustPlusBot AI assistant for this information, for example: !ai are any tracked players online?
• !untrack [name]
  Remove the specific player name from the !track list.name: The name of the player in the !track list

  Example: !untrack RustyPlayer2099

• !untrackid [ID]
  Remove the specific player ID from the !trackid list.ID: The BattleMetrics ID of the player in the !trackid list

  Example: !untrackid 112233

• !wipe
  Display the age of the current wipe.
  Ask the RustPlusBot AI assistant for this information, for example: !ai when was the last wipe?
• !whereis [name]
  Locate a specific monument on the map.name: The name of the monument

  Example: !whereis dome

  This command does not locate caves or other geographical features on the map
• !whois [name]
  Lookup info about and display the online / offline status of a server player using BattleMetrics.name: The name of a server player

  Example: !whois RustPlayer2099

  Example: !whois "Rusty Moose Man"

  To track the player after using this command, use team chat command !tracklast
  Enclose name with quotes to get exact results
  Requires a BattleMetrics ID in RustPlusBot configuration settings
  Does not work with Streamer Mode enabled servers (including Official servers)
• !whoisid [ID]
  Lookup info about and display the online / offline status of a server player using their BattleMetrics ID.ID: The BattleMetrics ID of a server player

  Example: !whoisid 112233

  Requires a BattleMetrics ID in RustPlusBot configuration settings

Server Event Commands:

Include Plugin Commands

---

Server Event commands are disabled for select servers. More info
• !brad
  Display information about the Bradley Tank explosion event.
  Unfortunately, this command no longer works since the May 4, 2023 Rust update
• !cargo
  Display information about the Cargo Ship event.
  Ask the RustPlusBot AI assistant for this information, for example: !ai cargo?
• !ch47
  Display information about the CH-47 Chinook event.
• !crate
  Display information about all Locked Crates on the map.
  Ask the RustPlusBot AI assistant for this information, for example: !ai crate?
• !crate-timer (time)
  Display or set the crate unlock timer in seconds.time: The crate unlock timer in seconds (0 to reset) (optional)

  Example: !crate-timer

  Example: !crate-timer 900

• !events (name)
  Display the most recent events observed on the server.name: The name of the event to filter using (optional)

  Example: !events

  Example: !events oil

  Ask the RustPlusBot AI assistant for this information, for example: !ai what events are active?
• !heli
  Display information about the Patrol Helicopter explosion event.
  Ask the RustPlusBot AI assistant for this information, for example: !ai heli?
• !large
  Display information about the Large Oil Rig.
  Ask the RustPlusBot AI assistant for this information, for example: !ai loil?
• !oil
  Display information about the Oil Rig's locked crates.
  Ask the RustPlusBot AI assistant for this information, for example: !ai oil status?
• !small
  Display information about the Small Oil Rig.
  Ask the RustPlusBot AI assistant for this information, for example: !ai smoil?
• !vendor
  Display information about the Traveling Vendor event.
  Ask the RustPlusBot AI assistant for this information, for example: !ai vendor?

Team Commands:

Include Plugin Commands

---

• !afk (name)
  Display all AFK team members and for how long.name: The name of a team member (optional)

  Example: !afk

  Example: !afk Rusty Mike

  The AFK team members are sorted by highest to lowest AFK time
  Use command !afk-all to see all AFK team members when there are too many to display
  Ask the RustPlusBot AI assistant for this information, for example: !ai who is afk?
• !alive (name)
  Display the team member who has been alive the longest.name: The name of a team member (optional)

  Example: !alive

  Example: !alive Rusty Mike

  Use command !alive-all to see all alive team members
  Ask the RustPlusBot AI assistant for this information, for example: !ai who is alive?
• !death [name]
  Locate a team member's last death on the map, or append 1-5 to the command to see a specific death.name: The name of a team member

  Example: !death Rusty Mike

  Example: !death3 Rusty Mike

  Use command !death-all to see all recorded deaths for a team member (last 5)
  Ask the RustPlusBot AI assistant for this information, for example: !ai who is dead?
• !leader (name) / !promote (name)
  Promote yourself or a team member to team leader.name: The name of a team member (optional)

  Example: !leader

  Example: !leader Rusty Mike

  In order for team members to promote when they are leader, they must have registered with RustPlusBot at https://bot.rustplus.io/register
• !locate [name] / !loc [name]
  Locate a team member on the map.name: The name of a team member

  Example: !locate Rusty Mike

• !nearby
  Locate the closest team member near you.
• !offline
  Display the names of all offline team members and their offline time.
  The team members are sorted by highest to lowest offline time
  Ask the RustPlusBot AI assistant for this information, for example: !ai offline team members?
• !online
  Display the names of all online team members and their online time.
  The team members are sorted by highest to lowest online time
  Ask the RustPlusBot AI assistant for this information, for example: !ai online team members?
• !proximity / !prox
  Display team members and their distance from you.
  The team members are sorted by lowest to highest distance
• !register
  Display the link to the bot's team leader transfer registration.
  Team members can register with RustPlusBot at https://bot.rustplus.io/register
• !registered (name)
  Display all registered team members, or check the registration status of a specified team member.name: The name of a team member (optional)

  Example: !registered

  Example: !registered Rusty Mike

  Team members can register with RustPlusBot at https://bot.rustplus.io/register
• !team
  Display the size of the team / online count / alive count / AFK count.
• !teamleader / !lead
  Locate the team leader and the team leader's map note (if it exists).
• !teammate [name] / !teammember [name]
  Display the current status of a team member.name: The name of a team member

  Example: !teammate Rusty Mike

  Ask the RustPlusBot AI assistant for this information, for example: !ai Rusty Mike status?

Vending Machine Commands:

Include Plugin Commands

---

• !instock [query]
  Search for and display the quantity and location of a specific in-stock vending item using the buy name (item being sold).query: The name of the vending item to search for (can include a quantity)

  Example: !instock Workbench Level 2

  Example: !instock 1000 Wood

  Example: !instock >= 300 crude

  Example: !instock >= crude x 300

  The vending item results are sorted by highest to lowest quantity
• !instock-next
  Display the next page of the !instock command results.
• !instock-prev
  Display the previous page of the !instock command results.
• !instocki [query]
  Search for and display the quantity and location of a specific in-stock vending item using the buy name. (chat emoji icons display)query: The name of the vending item to search for (can include a quantity)

  Example: !instocki Workbench Level 2

  Example: !instocki 1000 Wood

  Example: !instocki >= 300 crude

  Example: !instocki >= crude x 300

  The vending item results are sorted by highest to lowest quantity
• !instocki-next
  Display the next page of the !instocki command results.
• !instocki-prev
  Display the previous page of the !instocki command results.
• !newest
  Display the name and location of the newest vending machine on the map.
• !price [query]
  Search for and display the quantity and location of a specific vending item using the sell name (currency to buy item).query: The name of the vending item to search for (can include a quantity)

  Example: !price 1000 Stones

  Example: !price 10 Rifle Body

  Example: !price >= 100 scrap

  Example: !price >= scrap x 100

  The vending item results are sorted by highest to lowest quantity
• !price-next
  Display the next page of the !price command results.
• !price-prev
  Display the previous page of the !price command results.
• !pricei [query]
  Search for and display the quantity and location of a specific vending item using the sell name. (chat emoji icons display)query: The name of the vending item to search for (can include a quantity)

  Example: !pricei 1000 Stones

  Example: !pricei 10 Rifle Body

  Example: !pricei >= 100 scrap

  Example: !pricei >= scrap x 100

  The vending item results are sorted by highest to lowest quantity
• !pricei-next
  Display the next page of the !pricei command results.
• !pricei-prev
  Display the previous page of the !pricei command results.
• !vend [query]
  Search for and display the quantity and location of a specific vending item using the buy name (item being sold).query: The name of the vending item to search for (can include a quantity)

  Example: !vend Workbench Level 3

  Example: !vend 1000 Stones

  Example: !vend <= 100 scrap

  Example: !vend <= scrap x 100

  The vending item results are sorted by highest to lowest quantity
• !vend-next
  Display the next page of the !vend command results.
• !vend-prev
  Display the previous page of the !vend command results.
• !vendi [query]
  Search for and display the quantity and location of a specific vending item using the buy name. (chat emoji icons display)query: The name of the vending item to search for (can include a quantity)

  Example: !vendi Workbench Level 3

  Example: !vendi 1000 Stones

  Example: !vendi <= 100 scrap

  Example: !vendi <= scrap x 100

  The vending item results are sorted by highest to lowest quantity
• !vendi-next
  Display the next page of the !vendi command results.
• !vendi-prev
  Display the previous page of the !vendi command results.
• !watchclear [query]
  Clear the specific vending item from the !watchfor / !watchforprice list.query: The name of the vending item in the !watchfor / !watchforprice list

  Example: !watchclear m249

• !watchclear
  Clear the list of all !watchfor / !watchforprice vending items.
• !watchfor [query]
  Automatically watch for the availability of a vending item and be alerted / notified in team chat.query: The name of the vending item to watch for (can include a quantity)

  Example: !watchfor m249

• !watchforprice [query]
  Automatically watch for the availability of a vending item based on price and be alerted in team chat.query: The name of the vending item to watch for (can include a quantity)

  Example: !watchforprice 1 sulfur

• !watchfor / !watchforprice
  Display the list of current !watchfor / !watchforprice items.
• !watchfound
  Display the list of previously found !watchfor / !watchforprice items.

Drone Commands:

---

All drone commands have been removed from the bot. The Rust developers have made changes to the Rust+ service that effectively disabled the drone's abilities. More info: May 4, 2023 Rust update

Popular Commands

Take a look at the list of the top 10 most commonly used RustPlusBot Discord and Team Chat commands below.

Discord Commands:

---

• rp!vend
  Search for and display the quantity and location of a specific vending item using the buy name.
• rp!track
  Track a player's joined/online or left/offline status on the server using BattleMetrics.
• rp!players
  Display all connected players on the server.
• rp!events
  Display the most recent events observed on the server.
• rp!pair
  Assign a name to a Smart device.
• rp!team
  Display the list of team members.
• rp!voice_join
  Invite RustPlusBot to join you in your active voice channel.
• rp!bot
  Display the status of the bot's server connection.
• rp!config
  Get the bot configuration link.
• rp!repair
  Repair and restart the bot to fix any device or server pairing issues.

Team Chat Commands:

---

• !pop
  Display the current server population and queue.
• !time
  Display the current server time.
• !night
  Display the time remaining until the next night cycle.
• !day
  Display the time remaining until the next day cycle.
• !oil
  Display information about the Oil Rig's locked crates.
• !vend
  Search for and display the quantity and location of a specific vending item using the buy name.
• !afk
  Display all AFK team members and for how long.
• !track
  Track a player's joined/online or left/offline status on the server using BattleMetrics.
• !leader
  Promote yourself or a team member to team leader.
• !ai
  Ask the RustPlusBot AI assistant a question.

Voice Commands Reference

Find the complete list of RustPlusBot's voice commands and common Alexa Skill phrases below.

Common Alexa Skill Phrases:

---

• "Alexa, ask My RustPlusBot turn on device turrets"
• "Alexa, ask My RustPlusBot what is the server population"
• "Alexa, ask My RustPlusBot what is the server time"
• "Alexa, ask My RustPlusBot where is the team leader"
• "Alexa, ask My RustPlusBot how long until night"

Bot Commands:

---

• "what are the alerts"
  Get all paired device alerts since you last checked
• "run command [command]"
  Execute a team chat command using your voice.command: The command to execute

  Example: "run command promote"

  Example: "run command bot hello from alexa"

Smart Device Commands:

---

• "turn on device [ID|name]"
  Turn on a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: "turn on device sam"

• "turn off device [ID|name]"
  Turn off a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: "turn off device sam"

• "status of device [ID|name]"
  Get the status of a Smart device.ID|name: The identifier or paired name of the device

  Example: "status of device sam"

• "toggle device [ID|name]"
  Toggle a Smart Switch device.ID|name: The identifier or paired name of the device

  Example: "toggle device sam"

Team Commands:

---

• "where is team leader"
  Locate the team leader.
• "where is team member [name]"
  Locate a team member on the map.name: The name of a team member

  Example: "where is team member Mike"

• "is team member [name] offline"
  Get the offline status of a team member.name: The name of a team member

  Example: "is team member Mike offline"

• "is team member [name] online"
  Get the online status of a team member.name: The name of a team member

  Example: "is team member Mike online"

Server Commands:

---

• "how long until day"
  Get the time remaining until the next day cycle.
• "how long until night"
  Get the time remaining until the next night cycle.
• "what is the current population"
  Get the current server population and queue.
• "what is the current time"
  Get the current server time.
• "how long since wipe"
  Get the age of the current wipe.
• "when is next wipe"
  Get how long until the next wipe.

Server Event Commands:

---

Server Event commands are disabled for select servers. More info
• "when was the last cargo"
  Get information about the Cargo Ship event.
• "when was the last chinook"
  Get information about the CH-47 Chinook event.
• "when was the last crate"
  Get information about all Locked Crates on the map.
• "when was the last heli"
  Get information about the Patrol Helicopter explosion event.
• "when was the last large"
  Get information about the Large Oil Rig.
• "when was the last small"
  Get information about the Small Oil Rig.
• "when was the last vendor"
  Get information about the Traveling Vendor event.

Plugins Reference

The official plugins for RustPlusBot are listed below. Access the RustPlusBot Plugin Studio and create your own plugins!

Official Plugins:

---

• Approximate Respawn Times for Server Events
• Auto Turret Interference Calculator
• Bradley Tank Respawn Notification (No longer working)
• Camera Alert When Players Detected
• Current Server Info With Voice Feedback
• Day/Night Controlled Smart Switches
• Death Markers for Team Members
• Fortune Cookie Quotes
• Hidden / Offscreen Team Members
• Monument Information Lookup
• Notepad Text Storage
• Raid Alarm @everyone
• Recycle Box Contents Calculator
• Reminder Alerts
• Roll (Random Number Generator)
• Rustafied Latest News
• RustLabs Durability Lookup & Other Useful Commands
• SAM Sites Auto-On After Delay
• Scrap Vendor Exchange Calculator
• Smart Alarm Commands
• Smart Switch Timed Toggling
• Stopwatch Time Measurement
• Storage Monitor Commands
• Team Activity Messages & Stats
• Team Offline Status Controlled Smart Switches
• Team Online Status Controlled Smart Switches
• Vending Machine Messages
• Vending Machine Stats & Item History + Tracking
• When's Wipe?

---

• Approximate Respawn Times for Server Events Display approximate respawn times for various server events.

  Plugin team chat commands:

  • !when-cargo
    Display the approx. time remaining until the Cargo Ship respawns.
  • !when-crate
    Display the approx. time remaining until a Locked Crate (CH-47 Chinook respawns).
  • !when-heli
    Display the approx. time remaining until the Patrol Helicopter respawns.
  • !when-loil
    Display the approx. time remaining until the Oil Rig (Large) crate respawns.
  • !when-oil
    Display the approx. time remaining until the Oil Rig crates respawn.
  • !when-smoil
    Display the approx. time remaining until the Oil Rig (Small) crate respawns.
  • !when-vendor
    Display the approx. time remaining until the Traveling Vendor respawns.

---

• Auto Turret Interference Calculator Easily manage and view your Auto Turret interference.
  Auto Turret interference occurs when there are more than 12 turrets within a 40 meter radius

  Plugin team chat commands:

  • !turret-add (floor)
    Add a turret to the list at your current location and specified floor.floor: The number of floors (optional) (default is 1)

    Example: !turret-add

    Example: !turret-add 3.5

    Example: !turret-add 7

    After two or more turrets are added to the list, the Auto Turret Interference Map will display as a Discord notification
  • !turret-check (floor)
    Display the number of turrets within 40m radius of your current location and specified floor.floor: The number of floors (optional) (default is 1)

    Example: !turret-check

    Example: !turret-check 1.5

    Example: !turret-check 5

    After using this command, the Auto Turret Interference Map will display as a Discord notification
  • !turret-nearby (floor)
    Display the nearest turret distance within 40m radius of your current location and specified floor.floor: The number of floors (optional) (default is 1)

    Example: !turret-nearby

    Example: !turret-nearby 3

  • !turret-remove (floor)
    Remove a turret from the list at your current location and specified floor.floor: The number of floors (optional) (default is 1)

    Example: !turret-remove

    Example: !turret-remove 5

  • !turret-clear
    Clear the turret list.

---

• Bradley Tank Respawn Notification (No longer working) Automatically receive an alert when the Bradley Tank respawns (or earlier).
  Unfortunately, this plugin no longer works since the May 4, 2023 Rust update

  Plugin team chat commands:

  • !offset-brad (time)
    Receive the alert earlier by using an offset in minutes.time: The offset time in minutes (optional)

    Example: !offset-brad

    Example: !offset-brad 15

---

• Camera Alert When Players Detected For offline use only. Automatically detect players on cameras and send Discord alerts.
  Team members are included by default. Use command !camalert-exclude-team to exclude them from detection
  Requires a sleeper or an alive player of the player paired to the bot on the server
  Cameras are only viewable while the paired player is offline and monument / static cameras can no longer be viewed since the May 4, 2023 Rust update

  Plugin team chat commands:

  • !camalert-delay [time]
    Display or set the camera detection interval.time: The interval time in seconds (10-300) (0 to disable) (optional)

    Example: !camalert-delay

    Example: !camalert-delay 30

  • !camalert-list [list]
    Display or set the camera ID list (comma-separated).list: The list of camera identifiers

    Example: !camalert-list

    Example: !camalert-list MYCAMERA

    Example: !camalert-list MYCAMERA1,MYCAMERA2,MYCAMERA3

  • !camalert-list-clear
    Clear the camera ID list.
  • !camalert-role [role]
    Display or set the camera detection alert role.role: The role to alert in the Discord message

    Example: !camalert-role

    Example: !camalert-role @CamAlert

  • !camalert-role-clear
    Clear the camera detection alert role.
  • !camalert-exclude-team
    Exclude team members from the Camera Alert.
  • !camalert-include-team
    Include team members in the Camera Alert.

---

• Current Server Info With Voice Feedback Display the current server pop and time with voice feedback.

  Plugin team chat commands:

  • !current / !now
    Display the current server population and time information with voice feedback.
    To hear the voice feedback, invite RustPlusBot to join you in your active voice channel using command rp!voice_join
  • !current-voice / !now-voice
    Enable or disable the current server info voice feedback

---

• Day/Night Controlled Smart Switches Control Smart Switches using day or night as a trigger.

  Plugin team chat commands:

  • !day-on [ID|name]
    Automatically turn on a Smart Switch during the day, then off at night.ID|name: The identifier or paired name of the device

    Example: !day-on TrapDoors

  • !day-off [ID|name]
    Automatically turn off a Smart Switch during the day, then on at night.ID|name: The identifier or paired name of the device

    Example: !day-off BaseLights

  • !night-on [ID|name]
    Automatically turn on a Smart Switch during the night, then off at day.ID|name: The identifier or paired name of the device

    Example: !night-on BaseLights

  • !night-off [ID|name]
    Automatically turn off a Smart Switch during the night, then on at day.ID|name: The identifier or paired name of the device

    Example: !night-off TrapDoors

  • !day-on / !day-off / !night-on / !night-off
    Display all active day/night devices.
  • !daynight-clear (ID|name)
    Clear all or specific active day/night device(s).ID|name: The identifier or paired name of the device (optional)
  • !offset-daynight (time)
    Adjust the Day/Night offset in minutes. The default value is 30 minutes. Max value is 180 (equal to 3 in-game hours)time: The offset time in minutes (optional)

    Example: !offset-daynight

    Example: !offset-daynight 60

    A higher offset will cause the switch to turn on earlier and off later

---

• Death Markers for Team Members Display team member death locations on the interactive map for a short time.

  Plugin team chat commands:

  • !deathpin [name] / !dpin [name]
    Pin the last 5 deaths of a specified team member to the interactive map.name: The name of the team member

    Example: !deathpin Rusty Mike

  • !deathpin-delay (time) / !dpin-delay (time)
    Display or set the death map markers clear delay in seconds.time: The death map markers clear delay in seconds (optional) (default is 60)

    Example: !deathpin-delay

    Example: !deathpin-delay 120

---

• Fortune Cookie Quotes Display a random fortune cookie quote.

  Plugin team chat commands:

  • !fortune
    Display a random fortune cookie quote.

---

• Hidden / Offscreen Team Members Reveal all team members that are not visible for teams larger than 8.

  Plugin team chat commands:

  • !hidden / !offscreen
    Displays all off-screen team members.

---

• Monument Information Lookup Quickly lookup information about any Rust monument.

  Plugin team chat commands:

  • !keycard [color]
    Display monuments that spawn the specified keycard.color: The color of the keycard

    Example: !keycard red

    Ask the RustPlusBot AI assistant for this information, for example: !ai where do i get the red card?
  • !monument [name]
    Display information for the specified monument.name: The name of the monument

    Example: !monument train

    Ask the RustPlusBot AI assistant for this information, for example: !ai monument dome
  • !radiation [name] / !rad [name]
    Display the radiation amount and minimum armor required for a specific monument on the map.name: The name of the monument

    Example: !radiation dome

    Ask the RustPlusBot AI assistant for this information, for example: !ai radiation missile silo

---

• Notepad Text Storage Save and read text notes stored by the bot
  Any saved notes can be accessed using their note name as the chat command, for example: !mynote
  There is a limit of 10 saved notes

  Plugin team chat commands:

  • !note [name] [msg]
    Save a text note that is stored in your bot and is added to the RustPlusBot AI assistant knowledge base.name: The name of the note
msg: The message of the note

    Example: !note Base_Code 1234

    Example: !note Raid_Targets G10, N15, S20

    Example: !note TeamFact01 RustyMike is always AFK because he is either at Chipotle or rock climbing

    Ask the RustPlusBot AI assistant for saved note information, for example: !ai Base_Code
    Ask the RustPlusBot AI assistant about saved note information, for example: !ai why is RustyMike always afk?
  • !notes (name)
    Display all stored notes or notes matching name.name: The name of the note (optional)

    Example: !notes

    Example: !notes Base_Code

  • !notes-clear (name)
    Clear all or specific note(s).name: The name of the note (optional)

---

• Raid Alarm @everyone For modded servers only. Alert your Discord server when you receive a Raid Alarm notification.
  This plugin requires that the server has installed the Raid Alarm plugin

  Plugin team chat commands:

  • No commands available

---

• Recycle Box Contents Calculator Useful commands to calculate and display box content recyclables.

  Plugin team chat commands:

  • !recalert [item] [quantity] [ID|name]
    Display an alert when a recycled item's quantity reaches the specified amount.item: The name of the item
quantity: The quantity of the item
ID|name: The identifier or paired name of the device

    Example: !recalert scrap 100 JunkBox

    Example: !recalert metal fragments 1000 JunkBox

  • !recalert
    Display all recycle alert devices.
  • !recalert-clear (ID|name)
    Clear all or specific recycle alert device(s).ID|name: The identifier or paired name of the device (optional)
  • !recbox [ID|name]
    Display the items from recycling a paired Storage Monitor container contents.ID|name: The identifier or paired name of the device

    Example: !recbox JunkBox

  • !recboxi [ID|name]
    Display the items from recycling a paired Storage Monitor container contents. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !recboxi JunkBox

  • !recsafebox [ID|name]
    Display the items from safe zone recycling a paired Storage Monitor container contents.ID|name: The identifier or paired name of the device

    Example: !recsafebox JunkBox

  • !recsafeboxi [ID|name]
    Display the items from safe zone recycling a paired Storage Monitor container contents. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !recsafeboxi JunkBox

  • !recmon [ID|name]
    Monitor a Storage Monitor paired container for changes and display the recyclables.ID|name: The identifier or paired name of the device

    Example: !recmon JunkBox

  • !recmoni [ID|name]
    Monitor a Storage Monitor paired container for changes and display the recyclables. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !recmoni JunkBox

  • !recsafemon [ID|name]
    Monitor a Storage Monitor paired container for changes and display the safe zone recyclables.ID|name: The identifier or paired name of the device

    Example: !recsafemon JunkBox

  • !recsafemoni [ID|name]
    Monitor a Storage Monitor paired container for changes and display the safe zone recyclables. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !recsafemoni JunkBox

  • !recmon / !recmoni / !recsafemon / !recsafemoni
    Display all recycle monitored devices.
  • !recmon-clear (ID|name)
    Clear all or specific recycle monitored device(s).ID|name: The identifier or paired name of the device (optional)
  • !recycle [query] / !rec [query]
    Display the recyclables for an item quantity.query: The quantity and name of the item

    Example: !recycle m249

    Example: !recycle 20 tech trash

    Example: !recycle 5 rifle body, 10 metal spring, 20 metal pipe

    Example: !recycle Rifle Body x 5, Metal Spring x 10, Metal Pipe x 20

    Ask the RustPlusBot AI assistant for this information, for example: !ai recycle 50 tech trash
  • !recyclei [query] / !reci [query]
    Display the recyclables for an item quantity. (chat emoji icons display)query: The quantity and name of the item

    Example: !recyclei m249

    Example: !recyclei 20 tech trash

    Example: !recyclei 5 rifle body, 10 metal spring, 20 metal pipe

    Example: !recyclei Rifle Body x 5, Metal Spring x 10, Metal Pipe x 20

  • !recyclesafe [query] / !recsafe [query]
    Display the safe zone recyclables for an item quantity.query: The quantity and name of the item

    Example: !recyclesafe m249

    Example: !recyclesafe 20 tech trash

    Example: !recyclesafe 5 rifle body, 10 metal spring, 20 metal pipe

    Example: !recyclesafe Rifle Body x 5, Metal Spring x 10, Metal Pipe x 20

    Ask the RustPlusBot AI assistant for this information, for example: !ai recycle safe 10 rifle body
  • !recyclesafei [query] / !recsafei [query]
    Display the safe zone recyclables for an item quantity. (chat emoji icons display)query: The quantity and name of the item

    Example: !recyclesafei m249

    Example: !recyclesafei 20 tech trash

    Example: !recyclesafei 5 rifle body, 10 metal spring, 20 metal pipe

    Example: !recyclesafei Rifle Body x 5, Metal Spring x 10, Metal Pipe x 20

---

• Reminder Alerts Set reminders (custom timers), and then receive the alerts in team chat and Discord.
  Restarting the bot clears any active reminders
  There is a limit of 10 active reminders

  Plugin team chat commands:

  • !reminder [time] [msg] / !timer [time] [msg]
    Set a reminder to later receive an alert in team chat and Discord.time: The time to wait (format: 1d1h1m1s)
msg: The message to display in team chat

    Example: !reminder 15m crate unlocked

    Example: !timer 1h20m pick berries

    Ask the RustPlusBot AI assistant about your timers, for example: !ai my timers
  • !reminders / !timers
    Display all active reminders and their time remaining.
  • !reminders-clear (msg) / !timers-clear (msg)
    Clear / stop all or specific active reminder(s).msg: The message of the reminder (optional)

---

• Roll (Random Number Generator) To roll is to generate a random number, normally between 1 and 100.

  Plugin team chat commands:

  • !roll (min) (max) / !rand (min) (max) / !random (min) (max) / !rnd (min) (max)
    Generate a random number within the range (default is 1-100).min: The minimum number (optional)
max: The maximum number (optional)

    Example: !roll 50

    Example: !roll 300-600

---

• Rustafied Latest News Display the latest Rustafied news feed entries.

  Plugin team chat commands:

  • !news
    Display the latest Rustafied news feed entries.

---

• RustLabs Durability Lookup & Other Useful Commands Quickly lookup item durability and despawn times from RustLabs.

  Plugin team chat commands:

  • !blueprint [name] / !bp [name]
    Display the scrap amount required to research the specified item.name: The name of the item

    Example: !blueprint rocket

    Ask the RustPlusBot AI assistant for this information, for example: !ai blueprint rocket
  • !craft [query]
    Display the crafting cost and time for an item quantity.query: The quantity and name of the item

    Example: !craft rocket

    Example: !craft 10 rocket

    Example: !craft explosives x 100

    Ask the RustPlusBot AI assistant for this information, for example: !ai craft 100 explosives
  • !decay (hp) [name]
    Display the decay time for an item or building block with a specified HP (or full health).hp: The remaining health of the item or building block (optional)
name: The name of the item or building block

    Example: !decay armored floor

    Example: !decay 350 armored wall

    Example: !decay 100 attack helicopter

    Ask the RustPlusBot AI assistant for this information, for example: !ai decay for 350 armored wall
  • !despawn [name]
    Display the despawn time for the specified item.name: The name of the item

    Example: !despawn m249

    Ask the RustPlusBot AI assistant for this information, for example: !ai despawn m249
  • !droprate [name]
    Display the top 5 droprates for the specified item.name: The name of the item

    Example: !droprate l96

    Ask the RustPlusBot AI assistant for this information, for example: !ai droprate l96
  • !durability [name] / !db [name]
    Display the durability information for the specified item or building block.name: The name of the item or building block

    Example: !durability armored door

    Example: !durability metal wall

    Ask the RustPlusBot AI assistant for this information, for example: !ai durability metal wall
  • !durability-bullet [name] / !db-bullet [name]
    Display the durability information for the specified item or building block (bullets only).name: The name of the item or building block

    Example: !db-bullet auto turret

    Example: !db-bullet stone wall

    Ask the RustPlusBot AI assistant for this information, for example: !ai durability pistol bullet auto turret
  • !durability-bullet-next [name] / !db-bullet-next [name]
    Display the next set of durability information for the specified item or building block (bullets only).name: The name of the item or building block

    Example: !db-bullet-next auto turret

  • !durability-next [name] / !db-next [name]
    Display the next set of durability information for the specified item or building block.name: The name of the item or building block

    Example: !durability-next armored door

  • !durability-melee [name] / !db-melee [name]
    Display the durability information for the specified item or building block (melee only).name: The name of the item or building block

    Example: !db-melee refinery

    Example: !db-melee-soft metal wall

    Example: !db-melee-hard stone foundation

    By default, hard side durability is displayed. Use team chat command !durability-melee-soft for soft side durability.
    Ask the RustPlusBot AI assistant for this information, for example: !ai durability melee stone wall soft side
  • !durability-melee-next [name] / !db-melee-next [name]
    Display the next set of durability information for the specified item or building block (melee only).name: The name of the item or building block

    Example: !db-melee-next refinery

    Example: !db-melee-soft-next metal wall

    Example: !db-melee-hard-next stone foundation

    By default, hard side durability is displayed. Use team chat command !durability-melee-soft-next for soft side durability.
  • !durability-siege [name] / !db-siege [name]
    Display the durability information for the specified item or building block (siege weapons only).name: The name of the item or building block

    Example: !db-siege high external stone wall

    Example: !db-siege stone wall

    Ask the RustPlusBot AI assistant for this information, for example: !ai durability siege stone wall
  • !durability-siege-next [name] / !db-siege-next [name]
    Display the next set of durability information for the specified item or building block (siege weapons only).name: The name of the item or building block

    Example: !db-siege-next high external stone wall

  • !health [name] / !hp [name]
    Display the max health and decay info for a specified item.name: The name of the item

    Example: !health rhib

    Example: !health snowmobile

    Ask the RustPlusBot AI assistant for this information, for example: !ai health minicopter
  • !mix [query]
    Display the mixing cost and time for an item quantity.query: The quantity and name of the item

    Example: !mix pure ore tea

    Example: !mix 100 explosives

    Example: !mix explosives x 100

    Ask the RustPlusBot AI assistant for this information, for example: !ai mix 10 pure ore tea
  • !repair [name]
    Display the repair information for the specified item or building block.name: The name of the item or building block

    Example: !repair armored door

    Ask the RustPlusBot AI assistant for this information, for example: !ai repair armored door

---

• SAM Sites Auto-On After Delay Automatically turn On your paired SAM Sites after a configurable delay.
  Requires that the paired Smart Switch for your SAM Sites is named sam or sams (case insensitive)

  Plugin team chat commands:

  • !sam-delay (time)
    Display or set the auto-on delay in seconds.time: The auto-on delay in seconds (0 to disable) (optional) (default is 180)

    Example: !sam-delay

    Example: !sam-delay 120

  • !sam-voice / !sam-voice-enable / !sam-voice-disable
    Enable or disable the auto-on voice message.
    The voice message is sent 10 seconds before the SAM Sites automatically turn on

---

• Scrap Vendor Exchange Calculator Calculate the amount of Scrap received from vendor exchanging.

  Plugin team chat commands:

  • !scrap [query] / !scrapcalc [query]
    Display the Scrap received for vendor exchanging an item quantity.query: The quantity and name of the item

    Example: !scrap 1500 fertilizer

    Example: !scrap cloth x 500

    Example: !scrap 20 green keycard

    Example: !scrap small trout

    Ask the RustPlusBot AI assistant for this information, for example: !ai what is 40 catfish worth?

---

• Smart Alarm Commands Useful commands for Smart Alarm devices.

  Plugin team chat commands:

  • !activated (name)
    Display paired activated Smart Alarms and their last activated time.name: The name of the paired device (optional)

    Example: !activated

    Example: !activated Starter

    The Smart Alarm results are sorted by newest to oldest time activated
  • !alarms (name)
    Display paired Smart Alarms and their last activated time.name: The name of the paired device (optional)

    Example: !alarms

    Example: !alarms Starter

    The Smart Alarm results are sorted by newest to oldest time activated

---

• Smart Switch Timed Toggling Toggle a Smart Switch device for a desired amount of time.
  After installing this plugin, you can turn on or off a device with an expiration time attached. For example: !TurretDoors on 1m30s
  Restarting the bot clears the !ttoggle / !ton / !toff / !tauto list
  Automatically execute this command after connecting to a server in Post-Connect

  Plugin team chat commands:

  • !ttoggle [time] [ID|name] / !ttog [time] [ID|name]
    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

    Example: !tauto 3m 1m FarmSwitch

  • !tauto-timed [on_time] [off_time] [total_time] [ID|name]
    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.
  • !t-clear (ID|name)
    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
  There is a limit of 10 active stopwatches

  Plugin team chat commands:

  • !startwatch (name)
    Start a stopwatch to begin measuring time.name: The name of the stopwatch (optional)

    Example: !startwatch

    Example: !startwatch mytimer

  • !stopwatch (name)
    Stop a stopwatch and display the measured time.name: The name of the stopwatch (optional)

    Example: !stopwatch

    Example: !stopwatch mytimer

  • !watches
    Display any active stopwatches and their duration.

---

• Storage Monitor Commands Useful commands for Storage Monitored devices.

  Plugin team chat commands:

  • !contains [item]
    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
  • !containsi [item]
    Display paired storage devices containing the specified item. (chat emoji icons display)item: The name of the item in the container

    Example: !containsi rocket

    The item results are sorted by highest to lowest quantity
  • !contents [ID|name]
    Display the contents of a specified paired Storage Monitor container.ID|name: The identifier or paired name of the device

    Example: !contents BoomBox

  • !contentsi [ID|name]
    Display the contents of a specified paired Storage Monitor container. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !contentsi BoomBox

  • !contents-all [ID|name]
    Display the combined contents of all paired Storage Monitor containers for a device.ID|name: The identifier or paired name of the device

    Example: !contents-all BoomBox

  • !contentsi-all [ID|name]
    Display the combined contents of all paired Storage Monitor containers for a device. (chat emoji icons display)ID|name: The identifier or paired name of the device

    Example: !contentsi-all BoomBox

  • !upkeep (name)
    Display paired TCs and their upkeep.name: The name of the paired device (optional)

    Example: !upkeep

    Example: !upkeep BaseTC

    The TC results are sorted by lowest to highest upkeep time remaining
    Ask the RustPlusBot AI assistant for this information, for example: !ai upkeep BaseTC

---

• Team Activity Messages & Stats Automatically displays team activity messages and collects statistics when installed.
  After installing this plugin, you will see team messages such as Player1 is now online, Player2 is AFK, and Player3 has died @ J10
  Team member's stats are reset when changing servers, or when the server wipes

  Plugin team chat commands:

  • !lastseen [name]
    Display the last time a team member was seen online.name: The name of the team member

    Example: !lastseen Rusty Mike

    Ask the RustPlusBot AI assistant for this information, for example: !ai last seen Rusty Mike
  • !lastseen-all
    Display the last seen time for all team members.
    The team members are sorted by highest to lowest last seen time
  • !afktime [name]
    Display the total AFK time for a team member for the wipe.name: The name of the team member

    Example: !afktime Rusty Mike

    Ask the RustPlusBot AI assistant for this information, for example: !ai afk time Rusty Mike
  • !afktime-all
    Display the total AFK time for all team members.
    The team members are sorted by highest to lowest AFK time
  • !afktime-highest
    Display the total AFK time for the team member that has the highest AFK time.
  • !afktime-lowest
    Display the total AFK time for the team member that has the lowest AFK time.
  • !playtime [name]
    Display the total play time for a team member for the wipe.name: The name of the team member

    Example: !playtime Rusty Mike

    Ask the RustPlusBot AI assistant for this information, for example: !ai play time Rusty Mike
  • !playtime-all
    Display the total play time for all team members.
    The team members are sorted by highest to lowest play time
  • !playtime-highest
    Display the total play time for the team member that has the highest play time.
  • !playtime-lowest
    Display the total play time for the team member that has the lowest play time.
  • !teamdeaths-silent / !teamdeaths-mute
    Quiet the bot's team member death messages.
  • !teamdeaths-unsilent / !teamdeaths-unmute
    Stop silencing the bot's team member death messages.
  • !teammsgs
    Display the last 5 team activity messages.
  • !teammsgs-afk (time)
    Display or set the AFK time in minutes.time: The AFK time in minutes (0 to disable) (optional) (default is 5)

    Example: !teammsgs-afk

    Example: !teammsgs-afk 5

  • !teammsgs-silent / !teammsgs-mute
    Quiet the bot's team activity messages.
  • !teammsgs-unsilent / !teammsgs-unmute
    Stop silencing the bot's team activity messages.
  • !teamstats (name)
    Display team statistics for the team or a specific team member. The team stats include: Play time, AFK time, total deaths, and total distance traveled.name: The name of the team member (optional)

    Example: !teamstats

    Example: !teamstats Rusty Mike

    Ask the RustPlusBot AI assistant for this information, for example: !ai what are my team stats?

---

• Team Offline Status Controlled Smart Switches Control Smart Switches using team offline status as a trigger.

  Plugin team chat commands:

  • !teamoffline-on [ID|name]
    Automatically turn on a Smart Switch after all team members are offline.ID|name: The identifier or paired name of the device

    Example: !teamoffline-on SAM

  • !teamoffline-off [ID|name]
    Automatically turn off a Smart Switch after all team members are offline.ID|name: The identifier or paired name of the device

    Example: !teamoffline-off FarmSwitch

  • !teamoffline-toggle [ID|name] / !teamoffline-tog [ID|name]
    Automatically toggle on a Smart Switch after all team members are offline, then off after the first team member comes online.ID|name: The identifier or paired name of the device

    Example: !teamoffline-toggle SAM

  • !teamoffline-clear (ID|name)
    Clear all or specific active team offline device(s).ID|name: The identifier or paired name of the device (optional)

---

• Team Online Status Controlled Smart Switches Control Smart Switches using team online status as a trigger.

  Plugin team chat commands:

  • !teamonline-on [ID|name]
    Automatically turn on a Smart Switch after the first team member comes online.ID|name: The identifier or paired name of the device

    Example: !teamonline-on FarmSwitch

  • !teamonline-off [ID|name]
    Automatically turn off a Smart Switch after the first team member comes online.ID|name: The identifier or paired name of the device

    Example: !teamonline-off SAM

  • !teamonline-toggle [ID|name] / !teamonline-tog [ID|name]
    Automatically toggle on a Smart Switch after the first team member comes online, then off after all team members are offline.ID|name: The identifier or paired name of the device

    Example: !teamonline-toggle FarmSwitch

  • !teamonline-clear (ID|name)
    Clear all or specific active team online device(s).ID|name: The identifier or paired name of the device (optional)

---

• Vending Machine Messages Send messages when a paired vending machine's contents change.

  Plugin team chat commands:

  • !monitor [ID|name]
    Monitor a Storage Monitor paired container for any item updates.ID|name: The identifier or paired name of the device

    Example: !monitor BaseVending

  • !monitor-added [ID|name]
    Monitor a Storage Monitor paired container for added item updates.ID|name: The identifier or paired name of the device

    Example: !monitor-added BaseVending

  • !monitor-changed [ID|name]
    Monitor a Storage Monitor paired container for changed item updates.ID|name: The identifier or paired name of the device

    Example: !monitor-changed BaseVending

  • !monitor-removed [ID|name]
    Monitor a Storage Monitor paired container for removed item updates.ID|name: The identifier or paired name of the device

    Example: !monitor-removed BaseVending

  • !monitor / !monitor-added / !monitor-changed / !monitor-removed
    Display all monitored storage container devices.
  • !monitor-clear (ID|name)
    Clear all or specific monitored storage container device(s).ID|name: The identifier or paired name of the device (optional)

---

• Vending Machine Stats & Item History + Tracking Lookup / track vending item history and get vending item statistics.
  Restarting the bot clears all vending item history

  Plugin team chat commands:

  • !vendcommon
    Display the top 5 most common vending items on the map.
  • !vendhistory [item]
    Lookup the vending item history for a specific item.item: The name of the vending item

    Example: !vendhistory garage door

  • !vendstats (item)
    Display vending machine / vending item statistics.item: The name of the vending item (optional)

    Example: !vendstats

    Example: !vendstats garage door

  • !vendtrack [location] [item]
    Track a specific vending item in a specific location on the map.location: The location of the vending item
item: The name of the vending item

    Example: !vendtrack q18 garage door

  • !vendtrack
    Display all active vending item trackers.
  • !vendtrack-clear (item)
    Clear all or specific active vending item tracker(s).item: The name of the vending item (optional)

---

• When's Wipe? Display when the next wipe is (Weekly/Bi-Weekly/Monthly).

  Plugin team chat commands:

  • !nextwipe / !whenwipe / !whenswipe
    Display when the next wipe is.
    Ask the RustPlusBot AI assistant for this information, for example: !ai next wipe?

Plugin Studio

Create your own plugins in the RustPlusBot Plugin Studio to add custom functionality to the bot. Use JavaScript to interact with RustPlusBot by listening for events and sending team messages. Publish your plugin and make it public to allow others to install it into their bot.

View the RustPlusBot plugin documentation and examples on GitHub.

The RustPlusBot Plugin Studio can be accessed via a link in the Plugin settings tab on the RustPlusBot settings page for your Discord server.

Plugin Examples

Below are plugin examples that you can utilize for your bot, and customize to your liking.

• alarmchannel
  • This plugin example demonstrates how to use the activation of a Smart Alarm to post a Discord message in a specific channel and ping a role.
• announcements
  • This plugin example demonstrates how to automatically send pre-defined team chat announcements.
• autopop
  • This plugin example demonstrates how to automatically run the !pop command every 5 minutes.
• autotime
  • This plugin example demonstrates how to automatically send until daytime / until nighttime team chat announcements.
• hotelfloors
  • This plugin example demonstrates how to automatically activate multiple similarly named Smart Switches with a single command. This is the same plugin seen in the MikeTheVike YouTube video here: https://www.youtube.com/watch?v=ijdQ31TP0hk
• macro
  • This plugin example demonstrates how to use a single team chat command to execute multiple chat commands.
• mapmarker
  • This plugin example demonstrates how to pin a custom map marker to the Interactive Map.
• messagerouting
  • This plugin example demonstrates how to route team chat messages to custom Discord channels. You can specify wildcard matches for the messages and have them posted to their own Discord channels.
• mirrormessages
  • This plugin example demonstrates how to mirror all team chat messages by posting them to another Discord server via a webhook.
• teamvoice
  • This plugin example demonstrates how to send voice messages to the RustPlusBot voice client. You can invite the voice client to your active voice channel using Discord command: rp!voice_join.
• timedfireworks
  • This plugin example demonstrates how to activate multiple Smart Switches with different delays, allowing you to create a timed firework show. The Smart Switches should be directly wired to Igniters near the fireworks.
• turretrotation
  • This plugin implements auto turret flip flop for your bot. It works by rotating auto turret segments, or sections, with a total of 9 segments supported. Each turret segment is controlled by a single smart switch. Each turret in the segment has their Has Target output combined to a single smart alarm. When a turret segment is active, and if its related smart alarm is activated from the combined Has Target output, then the turret segment timer is reset keeping the segment active for longer.
• vendingitems
  • This plugin example demonstrates how to output all vending machine items in CSV or JSON format.
• vendinglog
  • This plugin example demonstrates how to log all vending machine item changes on the server to the Notifications Discord Channel (or the Plugin Notification channel if set in the bot's config).

Bot Credits

Bot credits can be purchased in the RustPlusBot store: https://bot-store.rustplus.io/

Packages:

• 1 Bot Credit $5 USD
  • Get 30 days of bot operation with 1 credit.