AtomicBot
⇠ Back to Help Center

Dashboard Access & Usage

The AtomicBot Dashboard is your control center for everything related to your Rust profile, team, ZORP status, Raid Alerts, and live map tracking. This page explains how to access it using the /dashboard command and how to navigate all the features once inside.

⚡ The /dashboard Command

The entire dashboard system starts with one Discord command:

/dashboard  

When a player runs /dashboard, AtomicBot instantly generates a secure, player-specific OAuth login link and sends it to them privately (ephemeral). This link takes them to the web dashboard page where the full interface loads.

This link includes:

  • The player’s Discord ID
  • The guild/server they ran the command in
  • Security checks to ensure only that player can use it
  • Automatic redirect after OAuth login

Players cannot “guess” dashboard URLs — they must always use /dashboard.

🔐 How Login Works

Clicking the link from /dashboard initiates Discord OAuth login. Once authenticated, the system loads all servers that the player's Discord ID is linked to.

Login verifies three things:

  • Your Discord identity
  • Your linked Rust profile in linked_users
  • Whether you are a bot admin for that guild

After login, the dashboard session begins and loads your guild context.

🌐 Switching Between Multiple Servers

If you play on multiple Rust servers powered by AtomicBot, the Dashboard lets you switch between them instantly using a dropdown selector.

Each guild loads:

  • Your in-game linked nickname
  • Your admin or player permissions
  • ZORP, RaidAlert, and feature settings unique to that guild
  • Server name and unique guild ID

The selected guild ID is stored in $_SESSION['_dash_ctx'] and updates every included section (Map, ZORP, RaidAlert, etc.).

👤 Player Dashboard Features

Regular (non-admin) players see their personal server data only.

  • Home: Profile, cooldowns, and basic info
  • Live Map: Real-time map with player markers
  • My Team: Team roster + colors + online status
  • ZORP: Activation status & cooldown timers
  • RaidAlert: Base status and recent alerts

All player views are read-only and cannot modify server settings.

🛠️ Admin Dashboard Features

Players marked as Bot Admin in the database receive extra sections automatically.

  • Advanced map debugging
  • Team & player linking info
  • ZORP configuration visibility
  • RaidAlert configuration details
  • Internal debug logs (coming soon)

Admin visibility is controlled by linked_users.is_admin.

🗺️ Live Map

The dashboard’s most popular feature — a real-time Rust map showing:

  • Your position
  • Your teammates
  • Online/offline icons
  • ZORP bubble overlays
  • Future: Heli, Cargo, Raid events

Powered by your WS RCON Proxy — the server is never exposed directly.

🧱 ZORP Control Center

Players can:

  • Check their current bubble status
  • View expiration timers
  • See auto/basic/advanced mode indicators
  • View team bubble metadata

This data comes directly from ZORP watch events and your database tables.

🚨 RaidAlert

Shows whether your base is protected, your team's raid cooldowns, and recent raid alerts triggered by in-game detonations.

Admins get additional tooltip information and cooldown reasons.

🔒 Dashboard Security

The dashboard is heavily secured behind multiple layers:

  • Discord OAuth identity lock
  • Guild-specific session context
  • WS RCON Proxy (no direct RCON calls exposed)
  • Role-checked admin permissions
  • Session expiration handling
  • No one can access another user’s guild

The dashboard is only reachable by clicking `/dashboard` — there is no public URL.