Configuration guide

Live Heat Map

Show a live map of player positions and map markers in Discord and on the Player Portal. Add your map image, align the grid, choose the layers and post it.

Time
12 minutes
You need
Manage Server (website)
Applies to
Per Rust server

Overview

The Live Heat Map draws a picture of your map with pins on it. It posts in a Discord channel and also appears on the Player Portal's Heat Map page. The bot updates the positions about every 10 minutes.

Before you start
  • You need your map image, or your map seed so it can be fetched for you.
  • If your map uses custom boot commands (a custom generated map), have them ready.
  • Pick a channel the bot can post in.

Setup & Configuration

Log in to the RustyWorks website, open Servers Configure, pick your server and select Live Activity Heatmap. Pick your server. Work through the four steps, then press Save Heatmap.

Enable

Enable Live Heatmap turns it on for the server.

Step 1: Map image

Choose Auto-fetch from Seed or Upload My Own.

Setting What it does Limits
Map Seed Fetches your map from RCEmaps.com. No screenshot needed 0 to 2,147,483,647
World Size The size of your map 1,000 to 4,500 in steps of 500. Default 3,500
Show the coordinate grid Off gives a clean map with no grid or info bar
My map uses custom boot commands Use this for custom generated maps
Boot Commands Paste the exact commands from your GPORTAL or Nitrado dashboard, one per line A server.seed line is used if the seed is blank, and server.worldsize overrides World Size
Upload My Own Your own image PNG, JPG or WebP, up to 4 MB

Press Get Map. A new seed can take a few seconds. Replacing the image resets the grid to the full image.

Step 2: Align the in-game grid

Drag the green edges to line the grid up with the map, or drag inside the box to move it. Zoom in for precision.

Setting What it does
Map Size Shows the centre and corner coordinates
Update Interval Fixed at every 10 minutes
Top, Right, Bottom, Left Edge % Fine tune each edge, 0 to 100
Discord Post Channel Where the heat map is posted
Changing these replaces the heat map

Replacing the image, changing the island size or moving the grid replaces the existing heat map. Old locations are drawn again.

Step 3: Map layers

Pick what shows as pins, in both the Discord post and the Player Portal. Players and Zorps are on by default.

Group Layers
People and bases Players, Zorps, Tool Cupboards
Crates and pickups Code Locked Hackable Crate, Elite Crate, Green, Blue and Red Keycard Pickups
Animals Bear, Boar, Chicken, Shark, Stag, Wolf
Nodes Stone Node, Sulfur Node, Metal Node
Players layer

The Players layer shows every player's live position to everyone who opens the Heat Map on the Player Portal. Turn it off if you do not want that.

Step 4: Live preview

Shows what players see. It checks for new data every 10 seconds. Your grid, size and layers show straight away. A layer you have just ticked fills in after you save and the bot's next update.

Buttons

Button What it does
Save Heatmap Saves everything
Send Now Posts it to Discord now
Refresh Settings Reloads the saved settings
Clear Heatmap Deletes the saved map, points and Discord post. Cannot be undone

Troubleshooting

Problem Cause Fix
"Enter your map seed first" Auto-fetch needs a seed Enter it
"Paste your boot commands, or untick custom boot commands" The custom option is on but empty Paste them or untick
The map does not match The seed, size or boot commands differ from your server Use the exact values from your host
Pins are missing The layer was just ticked Save, then wait for the next update
"No live positions from the bot yet" The first update has not run Tick a layer, save, and wait about 10 minutes

Checked against RustyWorks on 29 Oct 2026.

Stuck on this step?

Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.