Introduction Last updated: 2022-12-02

RustPlusBot Official Links

RustPlusBot is a Rust+ Team Chat Discord ✔verified Bot that unlocks the full power of the Rust+ companion.

With RustPlusBot you can: receive notifications about in-game events, control Smart Switches, find vending machine items, and more... entirely in team chat! You can also use the bot's Discord commands to control Smart Switches and get useful team information in Discord.

The bot connects to a server in the same manner as the Rust+ mobile app, but intelligently handles team chat to process commands.

Check out the latest MikeTheVike video on YouTube and see how RustPlusBot was integrated with a hotel on Rusty Moose!

Features

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

Team Chat Features:
  • Receive alerts for Patrol Helicopter, Bradley Tank, Cargo Ship, CH-47 Chinook (Heavy Scientists), Oil Rigs, and Locked Crate drop
  • Display approx. time remaining until the next Heli, Bradley, Cargo Ship, and Locked Crate should respawn
  • Control individual Smart Switches or a group of Smart Switches using the same name
  • Get real-time information 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 previously paired with the bot and server)
  • Lookup a player's online status using BattleMetrics
  • Track a player's joined or left status on the server using BattleMetrics
  • Display the server time, and when is the next night or day cycle
  • Display the server population including queue information
  • Display a team member's Steam reputation using Steamrep
  • Display all AFK team members and for how long
  • Locate team members and display their coordinates
  • Locate the team leader and leader map note, and show their coordinates
  • Display all nearby team members and their distance from you
  • Find vending machine items and related information
  • Find monuments and display their coordinates
  • Display a monument's radiation and minimum armor required
  • Be notified when a vending item becomes available using item name or item price
  • Be notified when a vending machine's contents change and show the difference
  • Be notified when a paired Storage Monitor's contents change and show the recyled items
  • Be notified when a paired Storage Monitor's contents contains an item quantity if it was recycled
  • Search for items in a Storage Monitored container
  • Display the contents of a Storage Monitored container
  • Display the upkeep for all paired Storage Monitored TCs
  • Track a vending item in a specific location on the map
  • Lookup the history of a specific vending item on the map
  • Lookup the top 5 most common vending items on the map
  • Lookup the RustLabs durability of items or building blocks
  • Lookup the RustLabs decay time for a building block
  • Lookup the RustLabs despawn time for an item
  • Lookup the RustLabs crafting cost and time for an item quantity
  • Lookup the RustLabs repair costs for an item or building block
  • Replace your timed water setup for farming with Smart Switch auto-toggling
  • Replace your Solar Panel activated night lights with a night-triggered Smart Switch
  • Automatically turn on your SAM site switch with a team offline status-triggered Smart Switch
  • Measure any length of time using the Stopwatch commands
  • Set reminders to be alerted in the future
  • List the latest Rustafied news entries
Discord Features:
  • Mirror all or only mentions in team chat messages
  • Create useful trackers that automatically update their content
  • Control Smart Switches from a tracker
  • Control Smart Switches and get information from Smart Devices
  • Display server or device pairing, smart alarm, and player death alerts
  • Display a tracked player's joined or left status on the server using BattleMetrics
  • Display an alert when a team member comes online
  • Display the team roster including their coordinates
  • Display the most recent game events
  • Display the server information and map
  • Find vending machine items and related information
  • Start, stop, and restart the bot
Web Features:
  • Configure the bot's settings and permissions
  • Configure what game events the bot will announce
  • Configure aliases for the bot's commands and responses
  • Configure post-action team chat commands for: Server Connect, Player Death, Device On/Off, and Device Inactive
  • Configure your player tracking list and see the player tracker history
  • 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 information 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)
  • Install official plugins to expand the functionality of the bot
  • Create your own plugins for the bot in the Plugin Studio
Other Features:
  • Use your voice to talk to your bot with the Amazon Alexa skill or the Google Assistant action
  • Use your Stream Deck to control your paired devices and view server info with the RustPlusBot plugin

Frequently Asked Questions (FAQ)

Quickly find answers to the most common questions about RustPlusBot:

  • Question: How many players can use the bot in the same Discord?
    Answer: There is no limit to how many players can use the bot's commands, however, only one player can pair to the bot at a time (see Update Token).
  • Question: I've invited the bot to my Discord but nothing happened, now what?
    Answer: Make sure RustPlusBot has the required permissions (see Inviting the Bot). If you can see the bot in the channel you are in, then type command: rp!config
  • Question: Is this cheating or some kind of exploit?
    Answer: The bot talks to a server the same way the Rust+ mobile app does and therefore is not an exploit or cheat. Many server admins already allow its use and Facepunch has said they are ok with it.
  • Question: What servers has the bot been tested on or approved to use with?
    Answer: The bot was developed while playing on Rusty Moose and PlayRust Reddit servers, and was allowed by the admins.
  • Question: Will the bot work on a modded server?
    Answer: It may or may not work with a modded server. Some modded servers restrict team chat to the Rust+ service while in-game.
  • Question: 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.
  • Question: Can I change the bot's language to something other than English?
    Answer: Yes, you can change the bot's default output language in RustPlusBot settings.
  • Question: Can I control any Smart Switch on the map if I guess its device ID?
    Answer: No. Building privilege is required to control a Smart Switch.
  • Question: Is it possible to toggle a device using only the paired name?
    Answer: Yes, you can toggle any paired device by simply typing its name as the command (make sure you include the command prefix). Example: !Turrets
  • Question: How can I get team leader from others when using the promote command?
    Answer: In order for other team members to promote when they are leader, they must have paired with the bot and the server at least once. This is because RustPlusBot requires their server connection information to take their leader.
  • Question: My Discord tracker isn't updating... is there something wrong?
    Answer: If you are using the tracker in another channel, make sure you have given RustPlusBot the required permissions for that channel. If it still isn't updating, try restarting the bot using command rp!restart
  • Question: Is it possible to have the bot speak in the Discord?
    Answer: Yes, if you enable the Text-to-Speech option in RustPlusBot settings then all team chat messages posted to Discord will be spoken.
  • Question: My server enforces a chat delay and I think it's messing up the bot, how can I fix this?
    Answer: You can configure a team chat delay for the bot in RustPlusBot settings for your Discord.
  • Question: I've switched servers and paired the bot already, but I am still getting notifications from the previous one?
    Answer: To unpair from the previous server: connect to the previous server in-game, and then press Escape, click Rust+ and click Disable.
  • Question: If I stop the bot when I'm not playing, will I still lose the bot's credit?
    Answer: No. When the bot is stopped, your bot credit will not be deducted.
  • Question: How often will I have to update the bot's Steam Authorization token?
    Answer: The bot's token typically lasts two weeks before expiring. You will be alerted in Discord to update it when this happens.
  • Question: How can I control the bot using my voice? Do I need Alexa or Google?
    Answer: You can use your Amazon Alexa or Google Assistant to command the RustPlusBot after enabling the Alexa skill, or invoking the Assistant action (see Voice Control).
  • Question: If I switch Discord servers, do I keep the credit I've purchased?
    Answer: Yes, please contact the developer (see below the questions) for assistance with your credit migration.
  • Question: How can I stop the bot's speech echo when multiple bot players are on the same team?
    Answer: Use the !delay team chat command to delay your own bot's responses by one or more seconds. When your bot sees the same response was already spoken by another bot player, it will silence it.
  • Question: Are you also the developer of Rustangelo and Rustrician.io?
    Answer: That is correct! RustPlusBot was created by the same developer with the support of many dedicated Rust players.
  • Question: I like the free trial, but why can't the bot just be free after?
    Answer: The payments go towards continued bot development and help support the bot's operating costs.
  • Question: Is this listed on Top.gg so I can vote it?
    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!

Bot Setup

Follow the setup instructions to invite the bot to your Discord server and then connect it to a server.

Watch the RustPlusBot setup video on YouTube: https://youtu.be/6ZcQTe-0Pns

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.
  • Game Events
    • Configure game event settings for the bot.
  • Chat Commands
    • Configure chat aliases and command permissions for the bot. (see examples below)
  • Post-Action Commands
    • Configure Server Connected, Death, Smart Alarm / Switch, Device inactive team chat commands. (see examples below)
  • Smart Devices
    • Configure smart device settings and manage paired devices.
  • Player Tracking
    • Configure the server player tracking list.
  • Voice
    • Pair your Amazon Alexa or Google Assistant device to the bot, and use voice commands to control it.
  • 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: !farm

    Example Output: !tauto-timed 1m30s 1m 2h farmswitch

  • Chat Commands -> Permissions
    Create permissions for chat commands. This will restrict the chat commands entered to only those allowed.

    Example Command: !promote

  • Post-Action Commands -> Post-Connect
    Execute team chat commands after the bot connects to a server.

    Example Command: !tauto 3m 1m FarmSwitch

  • Post-Action Commands -> Post-Death
    Execute team chat commands when there is a death notification.

    Example Command: !on sam

  • 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

  • Post-Action Commands -> Post-Inactive
    Execute team chat commands when a paired device becomes inactive.

    Example Command: !bot Device xyz is broken!

Update Token Instructions: https://www.youtube.com/watch?v=6ZcQTe-0Pns
steamauth_1
Access the Login page
steamauth_2
Login using Steam
steamauth_3
Ignore the popup message
steamauth_4
Right-click and click View Page Source
steamauth_5
Select all and Copy
steamauth_6
Return to the bot page and Paste

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 Rust+
  • Click the Pair With Server 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

Bot Commands

Utilize the bot's powerful team chat and Discord commands to control Smart Switches and other functionality.

Discord slash commands are also available for controlling the bot. If you don't have any /rustplusbot_ slash commands, try kicking the bot and then re-inviting it to your Discord using following link: https://bot.rustplus.io/invite

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!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.
  • rp!repair (Slash command: /rustplusbot_repair)
    Repair and restart the bot to fix any device pairing issues.
  • 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.
Discord Tracker Commands:

    Discord Trackers are automatically updating Discord embeds that provide useful information.

  • 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 game 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.
  • 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

  • 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

Smart Device Commands:
  • rp!devices (Slash command: /rustplusbot_devices)
    Display the status of all paired Smart devices.
  • 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

  • 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

  • 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

  • rp!subscribe (@user/@role) [ID|name] (Slash command: /rustplusbot_subscribe | /rustplusbot_subscribe_role)
    Receive @user / @role alerts for Smart device notifications.@role: The @user or @role to subscribe with (optional)
    ID|name: The identifier or paired name of the device

    Example: rp!subscribe BaseTC

    Example: rp!subscribe @RustTeam BaseTC

  • 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

  • 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

  • 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

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

    Example: rp!unsubscribe BaseTC

    Example: rp!unsubscribe @RustTeam BaseTC

Team Commands:
  • rp!team (Slash command: /rustplusbot_team)
    Display the list of team members.
Server Commands:
  • rp!events (name) (Slash command: /rustplusbot_events)
    Display the most recent game events observed on the server.name: The name of the event to filter with (optional)

    Example: rp!events

    Example: rp!events oil

  • rp!info (Slash command: /rustplusbot_info)
    Display the server information.
  • rp!map (Slash command: /rustplusbot_map)
    Display the server map.
  • rp!track [name] (Slash command: /rustplusbot_track)
    Track a player's joined or left status on the server using BattleMetrics.name: The name of the player to track

    Example: rp!track RustyPlayer2099

    Example: rp!track "Mike"

  • rp!trackclear (Slash command: /rustplusbot_trackclear)
    Clear the server player tracking list.
  • 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 or left status on the server using their BattleMetrics ID.ID: The BattleMetrics ID of the player to track

    Example: rp!trackid 112233

  • rp!trackstatus (name) (Slash command: /rustplusbot_trackstatus)
    Display the recent tracking status for tracked players.name: The name of the player in the rp!track list (optional)

    Example: rp!trackstatus

  • 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

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.query: The name of the vending item to search for (can include a quantity)

    Example: rp!price 1000 Stone

    Example: rp!price 10 Rifle Body

  • rp!vend [query] (Slash command: /rustplusbot_vend)
    Search for and display the quantity and location of a specific vending item using the buy name.query: The name of the vending item to search for (can include a quantity)

    Example: rp!vend Workbench Level 3

    Example: rp!vend 1000 Stone

    Example: rp!vend <= 100 scrap

Team Chat Commands Reference

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

Bot Commands:
  • !calculate [expression] / !calc [expression]
    Calculate the result of a mathematical expression.expression: The mathematical expression to evaluate

    Example: !calc 1 + 2 * 5

  • !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

  • !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

  • !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

  • !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:
  • !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

  • !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.
Team Commands:
  • !afk
    Display all AFK team members and for how long.
  • !alive
    Display the team member who has been alive the longest.
  • !bot [msg]
    Send a team message prefixed with BOT.msg: The message to send

    Example: !bot This is an announcement :-)

  • !leader
    Locate the team leader and the team leader's map note (if it exists).
  • !locate [name]
    Locate a team member on the map.name: The name of a team member

    Example: !locate RustyMike

  • !nearby
    Locate the closest team member near you.
  • !offline
    Display the names of all offline team members.
  • !online
    Display the names of all online team members.
  • !promote (name)
    Promote yourself or a team member to team leader when the bot is the team leader.name: The name of a team member (optional)

    Example: !promote

    Example: !promote RustyMike

  • !proximity / !prox
    Display team members and their distance from you.
  • !steamrep [name]
    Display the Steam reputation of a team member.name: The name of a team member

    Example: !steamrep RustyMike

Server Commands:
  • !day
    Display the time remaining until the next day cycle.
  • !info
    Display the server information.
  • !night
    Display the time remaining until the next night cycle.
  • !pop
    Display the current server population and queue.
  • !radiation [name] / !rads [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

  • !size
    Display the map size of the server.
  • !steamrep [steamId]
    Display the Steam reputation of a Steam member.steamId: The Steam ID of a Steam member

    Example: !steamrep 76561197886880999

  • !time
    Display the current server time.
  • !track [name]
    Track a player's joined or left status on the server using BattleMetrics.name: The name of the player to track

    Example: !track RustyPlayer2099

    Example: !track "Mike"

  • !track
    Display the list of current !track player names.
  • !trackclear
    Clear the list of all !track player names.
  • !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

  • !trackid [ID]
    Track a player's joined or left status on the server using their BattleMetrics ID.ID: The BattleMetrics ID of the player to track

    Example: !trackid 112233

  • !trackstatus (name)
    Display the recent tracking status for tracked players.name: The name of the player in the !track list (optional)

    Example: !trackstatus

  • !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.
  • !whereis [name]
    Locate a specific monument on the map.name: The name of the monument

    Example: !whereis dome

  • !whois [name]
    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"

  • !whoisid [ID]
    Display the online / offline status of a server player using their BattleMetrics ID.ID: The BattleMetrics ID of a server player

    Example: !whoisid 112233

Game Event Commands:
  • !brad
    Display information about the Bradley Tank explosion event.
  • !cargo
    Display information about the Cargo Ship event.
  • !ch47
    Display information about the CH-47 Chinook event.
  • !crate
    Display information about all Locked Crates on the map.
  • !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 game events observed on the server.name: The name of the event to filter with (optional)

    Example: !events

    Example: !events oil

  • !heli
    Display information about the Patrol Helicopter explosion event.
  • !large
    Display information about the Large Oil Rig.
  • !oil
    Display information about the Oil Rig's locked crates.
  • !small
    Display information about the Small Oil Rig.
Vending Machine Commands:
  • !instock [query]
    Search for and display the quantity and location of a specific in-stock vending item using the buy name.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

  • !instock-next
    Display the next page of the !instock command results.
  • !instock-prev
    Display the previous page of the !instock 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.query: The name of the vending item to search for (can include a quantity)

    Example: !price 1000 Stone

    Example: !price 10 Rifle Body

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

    Example: !vend Workbench Level 3

    Example: !vend 1000 Stone

    Example: !vend <= 100 scrap

  • !vend-next
    Display the next page of the !vend command results.
  • !vend-prev
    Display the previous page of the !vend 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 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.

Voice Control

Control the bot using your voice with the RustPlusBot Alexa Skill on Amazon.

After enabling the RustPlusBot Alexa Skill, you can open it by saying the phrase "Alexa, open My RustPlusBot" and then say a bot command.


Control the bot using your voice with the RustPlusBot Assistant Action on Google.

It does not require enabling and you can open it by saying phrase "OK Google, Talk to My RustPlusBot", and then say a bot command.

Voice Commands Reference

Find the complete list of RustPlusBot's voice commands and common Alexa Skill / Assistant Action 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"
Common Assistant Action Phrases:
  • "OK Google, Talk to My RustPlusBot about turn on device turrets"
  • "OK Google, Talk to My RustPlusBot about what is the server population"
  • "OK Google, Talk to My RustPlusBot about what is the server time"
  • "OK Google, Talk to My RustPlusBot about where is the team leader"
  • "OK Google, Talk to My RustPlusBot about 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.
Game Event Commands:
  • "when was the last brad"
    Get information about the Bradley Tank explosion event.
  • "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.

Plugins

The bot allows for the use of plugins to expand its functionality.

Plugins Reference

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

Official Plugins:
  • Approximate Respawn Times for Game Events Display approximate respawn times for various game events.
      Plugin chat commands:
    • !when-brad
      Display the approx. time remaining until the Bradley Tank respawns.
    • !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.
  • Bradley Tank Respawn Notification Automatically receive an alert when the Bradley Tank respawns (or earlier).
      Plugin 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

  • Day/Night Controlled Smart Switches Control Smart Switches using day or night as a trigger.
      Plugin 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)
  • Fortune Cookie Quotes Display a random fortune cookie quote.
      Plugin 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 chat commands:
    • !hidden / !offscreen
      Displays all off-screen team members.
  • Monument Information Lookup Quickly lookup information about any Rust monument.
      Plugin chat commands:
    • !monument [name]
      Display information for the specified monument.name: The name of the monument

      Example: !monument train

  • Notepad Text Storage Save and read text notes stored by the bot
      Plugin chat commands:
    • !note [name] [msg]
      Save a text note.name: The name of the note
      msg: The message of the note

      Example: !note Base_Code 1234

      Example: !note Raid_Targets G10, N15, S20

    • !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)
  • Recycle Box Contents Calculator Useful commands to calculate and display box content recyclables.
      Plugin 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

    • !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

    • !recmon
      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]
      Display the recyclables for an item quantity.query: The quantity and name of the item

      Example: !recycle m249

      Example: !recycle 20 tech trash

  • Reminder Alerts Set reminders, and then receive the alerts in team chat and Discord.
      Plugin chat commands:
    • !reminder [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: !reminder 2h Harvest berries

    • !reminders
      Display all active reminders and their time remaining.
    • !reminders-clear (msg)
      Clear 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 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 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 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

    • !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

    • !decay (hp) [name]
      Display the decay time for a building block with a specified HP (or full health).hp: The remaining health of the building block (optional)
      name: The name of the building block

      Example: !decay armored floor

      Example: !decay 350 armored wall

    • !despawn [name]
      Display the despawn time for the specified item.name: The name of the item

      Example: !despawn m249

    • !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

    • !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: !durability-melee refinery

    • !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: !durability-melee-next refinery

    • !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

  • SAM Sites Auto-On After Delay Automatically turn On your paired SAM Sites after a configurable delay.
      Plugin 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)

      Example: !sam-delay

      Example: !sam-delay 120

  • Smart Alarm Commands Useful commands for Smart Alarm devices.
      Plugin 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

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

      Example: !alarms

      Example: !alarms Starter

  • Smart Switch Timed Toggling Toggle a Smart Switch device for a desired amount of time.
      Plugin 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.
      Plugin 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 stopwatch(es) and their duration.
  • Storage Monitor Commands Useful commands for Storage Monitored devices.
      Plugin chat commands:
    • !contains [item]
      Display paired storage devices containing the specified item.item: The name of the item in the container

      Example: !contains rocket

    • !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

    • !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

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

      Example: !upkeep

      Example: !upkeep BaseTC

  • Team Activity Messages Automatically displays team activity messages when installed.
      Plugin chat commands:
    • !lastseen [name]
      Display the last time a team member was seen online.name: The name of the team member

      Example: !lastseen RustyMike

    • !playtime [name]
      Display the total play time for a team member for the wipe.name: The name of the team member

      Example: !playtime RustyMike

    • !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.
    • !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)

      Example: !teammsgs-afk

      Example: !teammsgs-afk 5

  • Team Offline Status Controlled Smart Switches Control Smart Switches using team offline status as a trigger.
      Plugin chat commands:
    • !teamoffline-on [ID|name]
      Automatically turn on a Smart Switch when all team members are offline.ID|name: The identifier or paired name of the device

      Example: !teamoffline-on SAM

    • !teamoffline-off [ID|name]
      Automatically turn off a Smart Switch when 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 when all team members are offline, then off when team members come 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)
  • Vending Machine Messages Send messages when a paired vending machine's contents change.
      Plugin 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.
      Plugin 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 chat commands:
    • !nextwipe / !whenwipe / !whenswipe / !when wipe / !whens wipe / !when's wipe
      Display when the next wipe is.

Plugin Studio

Create your own plugins in the 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.

Check out the RustPlusBot plugin documentation and examples on GitHub.

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

Payments

Purchase bot credits to keep the bot alive! One credit is equal to 30 days of bot operation.

Payments help with continued bot development, bot operating costs, and routine maintenance. Thank you for your support!

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.
  • 6 Bot Credits $25 USD 15% discount
    • Get 180 days of bot operation with 6 credits.
  • 12 Bot Credits $45 USD 25% discount
    • Get 360 days of bot operation with 12 credits.