A Home Assistant custom integration to connect with the Rust+ Companion App API. It allows you to monitor and control your in-game Rust entities directly from Home Assistant.
- 🔌 Smart Switches: Turn your in-game smart switches on and off from Home Assistant.
- 🚨 Smart Alarms: Receive binary sensor alerts for base alarms
- 📦 Storage Monitors: Monitor inventory levels of chests and storage boxes (e.g., amount of sulfur, metal, or wood).
- 👥 Server Stats: Monitor online player count, queue size, and max player capacity.
- 🗺️ Map Camera: View the in-game map as a camera entity in Home Assistant.
For a visual showcase, you can check out my video: https://www.youtube.com/watch?v=ed0F8BjBLkY
For a game-style visual grid of your Storage Monitors (item stacks plus a color-coded decay/upkeep timer), install the companion Lovelace card:
➡️ DatDraggy/RustPlus-Assistant-Cards
- Open HACS in your Home Assistant instance.
- Click the three dots in the top right corner and select Custom repositories.
- Enter the URL of this repository:
https://github.com/DatDraggy/RustPlus-Assistant - Set the category to Integration and click Add.
- Find the Rust+ Assistant integration in HACS and click Download.
- Restart Home Assistant.
- Download the latest release or clone this repository.
- Copy the
custom_components/rustplus_assistantfolder to your Home Assistant'sconfig/custom_components/directory. - Restart Home Assistant.
Once installed, add the integration via the Home Assistant UI:
- Go to Settings > Devices & Services.
- Click Add Integration in the bottom right, then search for Rust+ Assistant and select it.
- Choose how to sign in to your Rust+ (Steam) account:
No browser extension and no third-party website required — Home Assistant talks to Steam and Facepunch directly.
- Home Assistant shows a QR code.
- Open the Steam Mobile app, tap the QR-code scanner, scan the code, and approve the sign-in.
- Click Submit. Home Assistant finishes signing in and registers for push notifications automatically.
Your Steam password is never entered into — or seen by — Home Assistant. This is the same QR sign-in Steam uses on the desktop client; you approve it on your phone. Each Home Assistant install registers its own push device, so multiple instances (e.g. a test and a production server) can run in parallel without invalidating each other.
If you prefer, or if the QR sign-in isn't working for you, generate credentials with the Rustplus.py Link Companion browser extension and paste the JSON string.
If your credentials ever stop working, open the Rust+ Account entry under Settings > Devices & Services, click the ⋮ menu > Reconfigure, and re-authenticate (Steam QR or paste JSON). Your paired devices and servers are kept.
When you pair a new device (like a Smart Switch, Smart Alarm, or Storage Monitor) in the Rust+ app:
- Home Assistant will detect the pairing.
- An alert/notification will appear in your Home Assistant dashboard notifying you that a device has been paired.
- After pairing, rename the entity in your Home Assistant Device page to give it a clean, user-friendly name.
This project is licensed under the MIT License - see the LICENSE file for details.
This code is heavily based on Gemini and Claude's work, but manually reviewed and tested.