Setup Guides

Step 1

Place and pair a Smart Alarm in Rust

Craft and place a Smart Alarm in your base. Open the Rust+ mobile app, pair the alarm to your server, and ensure it shows as active. The alarm must be powered and paired before the bot can receive its events.

Step 2

Find the Entity ID in-game

Open the F1 console in Rust and run the command below. Then close the console, look directly at your Smart Alarm, and press O. The entity ID will appear on-screen.

Step 3

Register it with /addalarm

In your Discord server, run the slash command with the entity ID you found. Give it a memorable name so you can identify it later.

Step 4

Verify with /listalarms

Run /listalarms to confirm your alarm appears in the list with the correct name and entity ID. When the alarm fires in-game, the bot will post a notification to your configured alerts channel.

Step 1

Place a Smart Switch in Rust

Craft and place the switch in your base. Wire it to the device you want to control — auto-turrets, SAM sites, lighting rigs, etc. The switch must be powered and paired in the Rust+ mobile app.

Step 2

Find the Entity ID

Same process as alarms: open the F1 console, run bind o lookingat_debug, close the console, look directly at your Smart Switch, and press O. Note the entity ID that appears.

Step 3

Register it with /addswitch

Run the slash command in Discord with your entity ID and a descriptive name.

Step 4

Control it with /switch

Toggle your switch on or off directly from Discord. The bot confirms the state change in an ephemeral reply.

Step 5

Verify with /listswitches

Run /listswitches to see all registered switches and their current state. Use this to confirm your switch was registered correctly and check live states at a glance.

Step 1

Create the 4 recommended channels

In your Discord server, create the following text channels before starting the wizard. You can name them anything — these are the recommended names.

Step 2

Enable Developer Mode in Discord

To copy channel IDs, you need Developer Mode enabled. Go to User Settings → Advanced → Developer Mode and toggle it ON. This is a one-time setting.

Step 3

Copy a Channel ID

Right-click any channel name in your server → "Copy Channel ID". Paste it into the corresponding field in the setup wizard.

Step 1

Create a role in Discord

Go to Server Settings → Roles → Create Role. Name it something like RustBot Admin. Assign it to the team members who should have bot management access.

Step 2

Copy the Role ID

With Developer Mode enabled, right-click the role name (in Server Settings → Roles, or in a user's profile) → "Copy Role ID".

Step 3

Enter it in the wizard

Paste the Role ID into the Admin Role ID field in Step 3 of the setup wizard. This unlocks all admin-only commands for members with that role.

Step 1

Get a BattleMetrics API Token

Visit battlemetrics.com/developers, sign in, and generate a free API token. This is set by your bot host as an environment variable — if you're on the hosted service, contact support to have it enabled for your account.

Step 2

Add a BattleMetrics server

In Discord, run the command below. Autocomplete will search BattleMetrics for matching servers — select yours from the list.

Step 3

Add a target player

Run the command below. Autocomplete searches for the player by name on that server. Select the correct player from the suggestions.

Step 4

What alerts look like

When a tracked player goes online or offline, an embed is posted to your configured Events channel.

Step 5

Manage targets

Use the following commands to manage your tracked players and servers:

What changes each wipe

Credentials and IDs that reset

These must be updated after every wipe:

Two-step wipe process

Update credentials, then re-register devices

Follow these two steps in order after every wipe:

1. Run /botwipe in Discord to update your Rust+ credentials (Server IP, App Port, Player Token). This gives you a one-time link to the update form. Full walkthrough below.
2. Re-register your Smart Alarms and Switches using /addalarm and /addswitch with the new entity IDs from this wipe. See the Smart Alarm and Smart Switch guides above for how to find the new IDs.