Skip to content

About

Desktop Rust+ companion client for Windows - live map, smart devices, team tracking, and per-event notifications for every in-game event.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Rust++

A desktop Rust+ companion client for Windows. It does what the Rust+ phone app does — live map, team, smart devices, team chat — plus the thing the phone app never did: every in-game event as a real notification, individually toggleable.

Built on Facepunch's official Rust+ companion API — the same public API the official mobile app uses. It never touches the game client or EAC.

Install

Prebuilt Windows binaries land in release/:

  • Rust++ Setup 1.0.0.exe — installer. Creates Start Menu and desktop shortcuts. Use this one: Windows toast notifications need a Start Menu shortcut carrying the app's identity, so the installed build gets proper toasts.
  • Rust++-1.0.0-portable.exe — single-file, no install. Handy for a USB stick; toasts can be less reliable without a shortcut.

Both are unsigned, so SmartScreen will show "Windows protected your PC" on first run — More info → Run anyway.

Build from source

npm install
npm run dev
npm run dist

npm run dist regenerates the icons, builds, and writes both the installer and the portable exe to release/.

Pairing — then it just runs

  1. Launch the app and press Pair with Rust+.
  2. A Facepunch login window opens — sign in with Steam there. Rust++ emulates the ReactNativeWebView bridge the real app uses, so no Chrome-with- web-security-disabled hack is needed and nothing is typed into Rust++ itself.
  3. In game: Esc → Rust+ → Pair With Server. The server appears instantly.
  4. Smart Switches, Smart Alarms and Storage Monitors pair the same way from the in-game device menu.

That is the whole setup. From then on it is hands-off: the server auto-selects and connects, reconnects by itself with backoff if the socket drops, re-reads every paired device on connect, and keeps listening for pushes in the tray when you close the window. Newly paired devices appear without a restart, and on a map wipe it resets its derived state and carries on.

Already registered a Rust+ push device with another tool? Use Import credentials instead — it needs at least gcm.androidId and gcm.securityToken.

What it notifies you about

Every row below is a separate toggle, and each has five independent delivery channels: Windows toast, in-app toast, sound, relay to in-game team chat, and map highlight.

Category Events
Map Cargo Ship spawn / egress / despawn, Patrol Helicopter spawn / left / taken down, Chinook spawn / left, Locked Crate dropped / gone, Bradley destroyed
Oil Rigs Large & Small Oil Rig triggered (heavy scientists called), crate respawned on each rig
Team You died, teammate died (with a death marker at their last position), Rust+ death push, connect / disconnect, joined / left team, leader changed, team chat
Devices Smart Alarm triggered, device went offline / online, Tool Cupboard upkeep running low
Shops New vending machine, watched item in stock
Server Connected, lost connection, map wiped

Four one-click presets are included: Everything on, Raid watch, Monument runs and Silent.

Features

  • Interactive map — pan, zoom to cursor, live team positions with names, event markers with spawn radius, monument labels, Rust grid overlay, death crosses, click-to-inspect with vending machine contents, and click-to-centre from the event list.
  • Smart devices — flip Smart Switches, mute individual alarms, read Storage Monitor contents and Tool Cupboard upkeep, group devices per base, and optionally auto-flip a switch on the in-game day/night cycle.
  • Team — online / offline / alive / dead / AFK tracking, promote to leader, and two-way in-game team chat.
  • Vending machines — searchable listing of every shop on the map, plus an item watchlist that alerts you when something comes in stock.
  • Event feed — searchable, category-filtered history of everything seen.
  • Tray — closes to the system tray so notifications keep running.

How events are detected

The Rust+ API has no event stream, so Rust++ polls getMapMarkers and diffs successive snapshots:

  • A CH47 near an Oil Rig monument means heavy scientists were called there — that's the oil rig trigger, rather than a generic Chinook.
  • A Crate on an Oil Rig is a rig crate respawn; anywhere else it's a normal locked crate drop, with an unlock countdown.
  • A Patrol Helicopter that vanishes near a recent Explosion marker was shot down; one that vanishes on its own simply left.
  • Deaths come from both the Rust+ push notification and the team poll, so a teammate's death gets a map marker at their last known position.

Pairing, Smart Alarm triggers and death notifications arrive over FCM push, the same channel the phone app uses.

Facepunch rate-limits per player (25 request tokens, refilling at 3/second), so poll intervals are conservative by default and adjustable in Settings → Polling & timers.

Layout

src/
  main/          Electron main process
    pairing.ts     FCM registration, Steam link window, push listener
    rustplus.ts    Rust+ websocket session, polling, broadcasts
    eventEngine.ts marker/team diffing -> game events
    notifications.ts per-event alert rules
    app.ts         orchestration + app state
    store.ts       JSON persistence in userData
  preload/       context-isolated IPC bridge (+ the pairing bridge)
  renderer/      React UI
  shared/        types, event catalog, item names, grid maths

Licence

MIT — see LICENSE. Bundled Rust game data and trademarks belong to Facepunch Studios; see NOTICE.md.

Unofficial project, not affiliated with Facepunch Studios.

About

Desktop Rust+ companion client for Windows - live map, smart devices, team tracking, and per-event notifications for every in-game event.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages