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!
The bot is free to try for 30 days with your Discord server. After the trial, you will have to purchase bot credits to keep the bot alive. More information about bot credits in the Payments section.
If you have purchased Rustangelo PRO or Rustissimo PRO on Steam, your free trial will automatically be extended for each app you own.
Features
RustPlusBot has many powerful features accessible using team chat and Discord commands.
Control your paired devices and ask the bot commands such as "what is the server population" or "server time", entirely using your voice!
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
Manage your paired Smart Devices and unpair all or inactive only
Control Smart Switches and get real-time information from Smart Devices
Display the container contents of a paired Storage Monitor device
Get direct links to externally control Smart Devices using IFTTT
See the server's map and all markers / team members, and interact with it (including vending item searching / team chat display)
Install official plugins to expand the functionality of the bot
Create your own plugins for the bot in the Plugin Studio
Frequently Asked Questions (FAQ)
Quickly find answers to the most common questions about RustPlusBot:
Question: How many players can use the bot in the same Discord?
Answer: There is no limit to how many players can use the bot's commands, however, only one player can pair to the bot at a time (see Update Token).
Question: I've invited the bot to my Discord but nothing happened, now what?
Answer: Make sure RustPlusBot has the required permissions (see Inviting the Bot). If you can see the bot in the channel you are in, then type command: rp!config
Question: Is this cheating or some kind of exploit?
Answer: The bot talks to a server the same way the Rust+ mobile app does and therefore is not an exploit or cheat. Many server admins already allow its use and Facepunch has said they are ok with it.
Question: What servers has the bot been tested on or approved to use with?
Answer: The bot was developed while playing on Rusty Moose and PlayRust Reddit servers, and was allowed by the admins.
Question: Will the bot work on a modded server?
Answer: It may or may not work with a modded server. Some modded servers restrict team chat to the Rust+ service while in-game.
Question: Can I change the prefix or any bot commands?
Answer: You can change the bot's default prefix and create Aliases to change bot commands and its responses in RustPlusBot settings.
Question: Can I permit or restrict who can use the bot commands on my team?
Answer: You can create Permissions to restrict bot commands to certain players in RustPlusBot settings.
Question: Can I change the bot's language to something other than English?
Answer: Yes, you can change the bot's default output language in RustPlusBot settings.
Question: Can I control any Smart Switch on the map if I guess its device ID?
Answer: No. Building privilege is required to control a Smart Switch.
Question: How can I get team leader from others when using the promote command?
Answer: In order for other team members to promote when they are leader, they must have paired with the bot and the server at least once. This is because RustPlusBot requires their server connection information to take their leader.
Question: My Discord tracker isn't updating... is there something wrong?
Answer: If you are using the tracker in another channel, make sure you have given RustPlusBot the required permissions for that channel. If it still isn't updating, try restarting the bot using command rp!restart
Question: Is it possible to have the bot speak in the Discord?
Answer: Yes, if you enable the Text-to-Speech option in RustPlusBot settings then all team chat messages posted to Discord will be spoken.
Question: My server enforces a chat delay and I think it's messing up the bot, how can I fix this?
Answer: You can configure a team chat delay for the bot in RustPlusBot settings for your Discord.
Question: I've switched servers and paired the bot already, but I am still getting notifications from the previous one?
Answer: To unpair from the previous server: connect to the previous server in-game, and then press Escape, click Rust+ and click Disable.
Question: If I stop the bot when I'm not playing, will I still lose the bot's credit?
Answer: No. When the bot is stopped, your bot credit will not be deducted.
Question: How often will I have to update the bot's Steam Authorization token?
Answer: The bot's token typically lasts two weeks before expiring. You will be alerted in Discord to update it when this happens.
Question: How can I control the bot using my voice? Do I need Alexa or Google?
Answer: You can use your Amazon Alexa or Google Assistant to command the RustPlusBot after enabling the Alexa skill, or invoking the Assistant action (see Voice Control).
Question: If I switch Discord servers, do I keep the credit I've purchased?
Answer: Yes, please contact the developer (see below the questions) for assistance with your credit migration.
Question: How can I stop the bot's speech echo when multiple bot players are on the same team?
Answer: Use the !delay team chat command to delay your own bot's responses by one or more seconds. When your bot sees the same response was already spoken by another bot player, it will silence it.
Question: Are you also the developer of Rustangelo and Rustrician.io?
Answer: That is correct! RustPlusBot was created by the same developer with the support of many dedicated Rust players.
Question: I like the free trial, but why can't the bot just be free after?
Answer: The payments go towards continued bot development and help support the bot's operating costs.
Question: Is this listed on Top.gg so I can vote it?
Question: I've got a great idea for the bot... how can I create my own bot commands?
Answer: You can create your own plugins using the Plugin Studio!
Question: Why are Game Event notifications and commands disabled starting April 18, 2022 for servers: Rustoria, Rustopia, Rusticated, and Vital?
Answer: A senior developer for Rustoria, representing the listed servers above, has asked that the Game Event functionality of the bot be disabled on their servers. They strive for a level playing field and dislike the unfair advantage of the bot's Game Event notifications and commands. As a compromise to this dilemma and to avoid a ban, we have decided to disable the Game Event functionality starting April 18, 2022 on these servers.
Update: Zombie Land PVE servers will also have Game Event functionality disabled starting April 18, 2022.
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
Failure to grant the bot the required permissions above could cause a bot malfunction.
Configuring the Bot
Once RustPlusBot is invited to your Discord server, you will need to configure it. If the bot doesn't send a Discord message when it was invited, then it didn't have access to a channel to send a message. Once the bot is visible when viewing a channel, you can type: rp!config to get the configuration link.
Web Configuration Overview:
Access / Discord
Configure who can access this page and the bot's Discord channels.
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
In this example, the incoming bot's message is changed to the output, which runs a command for the farmswitch device.
Chat Commands -> Permissions
Create permissions for chat commands. This will restrict the chat commands entered to only those allowed.
Example Command: !promote
In this example, the bot command !promote is restricted to only those added here with the !promote command.
Post-Action Commands -> Post-Connect
Execute team chat commands after the bot connects to a server.
Example Command: !tauto 3m 1m FarmSwitch
In this example, the device FarmSwitch continually turns On for 3 minutes and Off for 1 minute because this command will run when the bot connects to the server.
Post-Action Commands -> Post-Death
Execute team chat commands when there is a death notification.
Example Command: !on sam
In this example, the device sam will automatically turn on when the bot player receives a death notification.
Post-Action Commands -> Post-Alarm
Execute team chat commands when a paired Smart Alarm or Smart Switch is activated or deactivated.
Example Command: !on turrets
In this example, the device turrets will automatically turn on when the selected paired device is activated.
Post-Action Commands -> Post-Inactive
Execute team chat commands when a paired device becomes inactive.
Example Command: !bot Device xyz is broken!
In this example, the bot will say the message Device xyz is broken! when the selected paired device become inactive.
The bot requires a Steam Authorization token for the pairing listener which is required to connect to a server. You can update this token in the RustPlusBot configuration settings, pressing Update Token.
Use the RustPlusBotFirefox Add-on or Chrome Extension to easily obtain your bot token without having to complete the steps below.
Access the Login page
Login using Steam
Ignore the popup message
Right-click and click View Page Source
Select all and Copy
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 Commands Reference
Find the complete list of RustPlusBot's Discord commands below.
Enable Strict Mode in RustPlusBot configuration settings to restrict bot communication to a single Discord channel
Use the Wire Tool in-game to pair the bot with a Smart Device
Not receiving any Smart Device pairing notifications? Try pairing again after restarting the bot using command rp!restart
Bot Commands:
rp!bot
Display the status of the bot's server connection.
rp!config
Get the bot configuration link.
rp!guide
Get the link to the bot's setup guide on YouTube.
rp!help
Display helpful information about the bot.
rp!restart
Restart the bot's server connection.
rp!start
Start the bot's server connection.
rp!stop
Stop the bot's server connection.
Discord Tracker Commands:
Discord Trackers are automatically updating Discord embeds that provide useful information.
rp!tracker_device [ID|name]
Create a Discord tracker for a Smart device.ID|name: The identifier or paired name of the device
Example: rp!tracker_device Turrets
Create your 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
rp!tracker [name]
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.
Create your trackers in their own channel so they don't get lost in the bot's messages
Most trackers can be configured by clicking on their settings gear
Requires a server connection
The events tracker will be disabled starting April 18, 2022 for servers: Rustoria, Rustopia, Rusticated, Vital. More info
Smart Device Commands:
rp!devices
Display the status of all paired Smart devices.
Requires a server connection
rp!on [ID|name]
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]
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]
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
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 restarting the bot using command rp!restart
Requires a server connection
rp!subscribe (@user/@role) [ID|name]
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
Requires a server connection
rp!status [ID|name]
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]
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]
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
Forget all paired Smart devices.
Requires a server connection
rp!unpair_inactive
Forget all inactive paired Smart devices.
Requires a server connection
rp!unsubscribe (@user/@role) [ID|name]
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
Requires a server connection
Team Commands:
rp!team
Display the list of team members.
Requires a server connection
Server Commands:
rp!events (name)
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
Restarting the bot clears the rp!events list
Requires a server connection
Game Event commands will be disabled starting April 18, 2022 for servers: Rustoria, Rustopia, Rusticated, Vital. More info
rp!info
Display the server information.
Requires a server connection
rp!map
Display the server map.
Requires a server connection
Vending Machine Commands:
rp!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: rp!price 1000 Stone
Example: rp!price 10 Rifle Body
The vending item results are sorted by highest to lowest quantity
Requires a server connection
rp!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: rp!vend Workbench Level 3
Example: rp!vend 1000 Stone
Example: rp!vend <= 100 scrap
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.
The prefix requirement for commands can be disabled in RustPlusBot configuration settings.
Create an alias to shorten a frequently used command you type in team chat in RustPlusBot configuration settings.
Bind team chat commands to a key in F1 console: bind [key] chat.teamsay "!pop"
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
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
!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)
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
Use the Wire Tool in-game to pair the bot with a Smart Device
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 restarting the bot using command rp!restart
!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.
The AFK team members are sorted by highest to lowest AFK time
!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.
The team members are sorted by lowest to highest distance
!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.
!trackclear [name]
Clear the specific player name from the !track list.name: The name of the player in the !track list
Example: !trackclear RustyPlayer2099
!trackclear
Clear the list of all !track player names.
!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"
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.
!trackstatus (name)
Display the recent tracking status for tracked players.name: The name of the player in the !track list (optional)
Example: !trackstatus
!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"
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)
Game Event Commands:
Game Event commands will be disabled starting April 18, 2022 for servers: Rustoria, Rustopia, Rusticated, Vital. More info
!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.
!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
Restarting the bot clears the !events list
!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
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.
!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
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.
!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
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.
!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.
Approximate Respawn Times for Game Events Display approximate respawn times for various game events.
Restarting the bot clears all event respawn times
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.
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.
Restarting the bot clears any active reminders
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.
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
Toggle a Smart Switch device for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !ttoggle 5m spotlight
Example: !ttoggle 1m30s TurretDoors
!ton [time] [ID|name]
Toggle a Smart Switch device ON for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !ton 10m LaserLights
!toff [time] [ID|name]
Toggle a Smart Switch device OFF for a desired amount of time.time: The time to wait (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !toff 20m sams
!tauto [on_time] [off_time] [ID|name]
Repeatedly toggle a Smart Switch device ON and OFF for different amounts of time.on_time: The time to wait while ON (format: 1d1h1m1s) off_time: The time to wait while OFF (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Repeatedly toggle a Smart Switch device ON and OFF for different amounts of time until total time is reached.on_time: The time to wait while ON (format: 1d1h1m1s) off_time: The time to wait while OFF (format: 1d1h1m1s) total_time: The time to wait until expiring (format: 1d1h1m1s) ID|name: The identifier or paired name of the device
Example: !tauto_timed 3m 1m 2h FarmSwitch
!ttoggle / !ttog / !ton / !toff / !tauto
Display all toggled devices and their time remaining.
!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
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
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
!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
Team Activity Messages Automatically displays team activity messages when installed.
After installing this plugin, you will see messages such as Player1 is now online or Player2 has died @ J10
Plugin chat commands:
!lastseen [name]
Display the last time a team member was seen online.name: The name of the team member
Example: !lastseen RustyMike
!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
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
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!
Last updated: 2022-05-06
Check out the latest MikeTheVike video on YouTube and see how RustPlusBot was integrated with a hotel on Rusty Moose!
