🦀 RustyCordBot — Setup Wizard

🎮 Step 1 — Rust+ Server Credentials

Connect the bot to your Rust server via the companion app

📦 Prerequisites — install these first:

Node.js v18+ — download and install from nodejs.org. Open a terminal and run node -v to confirm.
A terminal / command prompt (Terminal on Mac, Command Prompt or PowerShell on Windows)
The Rust+ mobile app installed on your phone and linked to your Steam account

How to get your Rust+ credentials (takes ~2 minutes):

Open a terminal and run:
npx @liamcottle/rustplus.js fcm-register
A browser window opens. Log in with your Steam account and approve the request.
Then run:
npx @liamcottle/rustplus.js fcm-listen
Leave this running and move to the next step.
On your phone, open the Rust+ app → select your server → tap "Pair with Server".
Your terminal will print JSON like this:
{"ip":"51.81.48.180","port":"28082","playerId":"76561198012345678","playerToken":"-1234567890"}
Copy each value into the fields below.

Command Prompt

─□✕

Microsoft Windows [Version 10.0.22631.3880]

C:\Users\YourName> npx @liamcottle/rustplus.js fcm-register

Opening browser for Steam login...

✓ FCM registration complete.

C:\Users\YourName> npx @liamcottle/rustplus.js fcm-listen

Waiting for Rust+ pairing notification...

[Open Rust+ app on your phone and pair the server]

Notification received:

{"ip":"51.81.48.180","port":"28082","playerId":"76561198012345678","playerToken":"-1234567890"}

C:\Users\YourName> _

Server IP Address *?

Server IP is required

App Port *?

Port is required

Player Steam ID (64-bit) *?

Player ID is required

Player Token *? Found in the fcm-listen JSON output

Player token is required

🤖 Step 2 — Discord Bot Setup

These fields are required — the hosted bot runs inside your Discord server

How to create a Discord bot:

Go to discord.com/developers/applications
Click "New Application" and name it
Go to the "Bot" tab
Click "Reset Token" and copy it
Copy the "Application ID" from General Information
Enable Message Content Intent and Server Members Intent under Privileged Gateway Intents

💡 Developer Mode tip: To copy your Server ID, enable Developer Mode in Discord Settings → Advanced, then right-click your server name → Copy Server ID.

Bot Token *?

Bot token is required

Application (Client) ID *?

Application ID is required

Server (Guild) ID *? Right-click your server name in Discord → Copy Server ID

Guild ID is required

📢 Step 3 — Discord Channel IDs

All optional — leave blank to disable that feature

💡 Right-click any channel in Discord and click "Copy Channel ID".
Requires Developer Mode (Discord Settings → Advanced → Developer Mode).
You can use the same channel ID for multiple purposes.

Team Chat Channel (optional)? e.g. #rust-chat — relays Rust ↔ Discord team chat

Alerts Channel (optional)? e.g. #rust-alerts — raid alarms and switch state changes

Events Channel (optional)? e.g. #rust-events — team deaths, joins, leaves

Status Channel (optional)? e.g. #rust-status — used by /status command

Admin Role ID (optional)? Role allowed to run /addswitch, /addalarm etc. If not set, only the server owner can manage entities.

🔌 Step 4 — Smart Entity IDs

Optional — leave blank if you don't use smart devices

How to find entity IDs in Rust:

Open the console (F1)
Type: bind o lookingat_debug and press Enter
In game, press O while looking at a Smart Switch or Smart Alarm
The entity ID appears on your screen

Enter multiple IDs separated by commas: 1234567,7654321

Smart Alarm IDs (optional) Comma-separated entity IDs for raid alarms

Smart Switch IDs (optional) Comma-separated entity IDs for smart switches

🚀 Step 5 — Subscribe & Launch

Review your configuration, then start your $5/mo subscription

✅ Your credentials are sent securely to our servers and the bot activates automatically after payment. Secrets are masked below for your protection.

Setting	Value