# MasterBot Platform Navigation

Task-oriented guide for the MasterBot dashboard. Use stable URLs first; UI labels may differ in Polish locale.

Index: https://masterbot.gg/llms.txt

## Sidebar navigation

After login, the left sidebar lists main sections. A bot must be selected (Bot Info card at top of sidebar) for bot-scoped sections.

| URL path | Section | Purpose |
|----------|---------|---------|
| /dashboard | Dashboard | Home overview |
| /dashboard/commands | Commands | Slash commands and context menu commands |
| /dashboard/events | Events | Discord gateway event flows |
| /dashboard/events/custom | Events (Custom) | Custom, webhook, and timed event flows |
| /dashboard/events/timed | Events (Timed) | Scheduled timed events (cron-like) |
| /dashboard/integrations | Integrations | API keys and inbound webhooks |
| /dashboard/database | Database Variables | Persistent custom variables per bot |
| /dashboard/bots | Bots | Bot list and Bot Settings panel |
| /dashboard/analytics | Analytics | Usage analytics |
| /dashboard/servers | Servers | Guilds where the bot is installed |
| /dashboard/settings | Settings | Account-level settings |
| /dashboard/profile | Profile | User profile |
| /dashboard/flows | Flow Builder | Full-screen flow editor (opened from Commands/Events) |

Sidebar actions (when a bot is selected):
- Open Flow Builder - navigates to /dashboard/flows for the active flow context
- Deploy / Start bot - starts the selected bot (requires valid token)

## Bots page layout (/dashboard/bots)

1. Header with Refresh and Create Bot buttons
2. Bot list (cards or list view) - click a bot card to select it
3. Bot Settings panel below the list (visible when a bot is selected)

Bot Settings sections (top to bottom, approximate order):
- Install actions (invite bot to server, user install link)
- Trial / billing upgrade card (if applicable)
- Bot Token
- Start bot / runtime controls
- Avatar, banner, username, bio preview and editors
- Bot status and activity (Discord presence)
- Auto-start, default timed timezone, auto-live, beta nodes toggles
- Collaboration (team, roles, invites) - visible to owner or users with collab.manage

## Collaborator permissions (common keys)

- bot.settings.edit - Edit username, avatar, banner, bio, status, activity
- bot.token.edit - Change bot token (includes bot.token.use)
- bot.token.use - Use token in flows (API Request preset, etc.)
- collab.manage - Manage team and collaboration roles
- bot.admin - Full bot admin (includes most permissions)
- flows.edit - Edit command and event flows
- flows.create / flows.delete - Create or delete flows
- nodes.use.* - Use specific node types (see llms-nodes.txt)

---

## Task recipes

### Log in

1. Go to https://masterbot.gg/login
2. Click **Continue with Google** (primary) or **Continue with GitHub**
3. You land on /dashboard
4. Optional: link Discord in Profile (/dashboard/profile) - this is not required to log in

### Create a new bot

1. Go to https://masterbot.gg/dashboard/bots
2. Click Create Bot (header) or use the inline creator form
3. Paste your Discord bot token from the Discord Developer Portal
4. Save - the bot appears in the list

### Change bot token

1. Go to https://masterbot.gg/dashboard/bots
2. Click the bot card to select it
3. Scroll to Bot Settings below the bot list
4. Find the Bot Token section
5. Click Edit, paste the new token, Save
6. Requires: bot owner OR collaborator with bot.token.edit

### Start or stop the bot

1. Go to https://masterbot.gg/dashboard/bots
2. Select the bot
3. In Bot Settings, use Start bot (or runtime controls near the token section)
4. Bot must have a valid token configured

### Install bot on a Discord server

1. Go to https://masterbot.gg/dashboard/bots
2. Select the bot
3. In Bot Settings, use the install section (server invite link)
4. Or use install actions on the bot card
5. Open the invite URL and authorize on your server

### Change bot status or activity

1. Go to https://masterbot.gg/dashboard/bots
2. Select the bot
3. In Bot Settings, find Status (online/idle/dnd/invisible) and Activity
4. Set activity type and message, then Save
5. Requires: bot.settings.edit

### Change bot username, avatar, or banner

1. Go to https://masterbot.gg/dashboard/bots
2. Select the bot
3. In Bot Settings, use the avatar/banner preview (click to upload) or Username / Bio sections
4. Save avatar/banner or username changes separately as prompted
5. Requires: bot.settings.edit

### Invite a collaborator

1. Go to https://masterbot.gg/dashboard/bots
2. Select the bot
3. Scroll to Collaboration in Bot Settings
4. Open the Team tab
5. Invite by email or copy an invite link
6. Assign a collaboration role with the needed permissions
7. Requires: bot owner OR collab.manage (or bot.admin)

### Manage collaboration roles

1. Bots → select bot → Collaboration
2. Use the Roles tab to create or edit preset permission sets
3. Assign roles to team members on the Team tab
4. Requires: collab.manage

### Create a slash command

1. Go to https://masterbot.gg/dashboard/commands
2. Click Create (or equivalent create command action)
3. Choose Slash command, set name and description
4. Open the flow in Flow Builder (/dashboard/flows)
5. Build the graph starting from the Slash Command root node
6. Save the flow

### Create a context menu command

1. Go to https://masterbot.gg/dashboard/commands
2. Create a new command, choose Context command (User or Message)
3. Open Flow Builder and wire nodes from the Context Command root
4. Save

### Create a Discord event flow

1. Go to https://masterbot.gg/dashboard/events
2. Click Create Event
3. Pick a Discord event type (see https://masterbot.gg/llms-events.txt for verified list)
4. Open Flow Builder - the flow root is an Event node
5. Save

### Create a custom event flow

1. Go to https://masterbot.gg/dashboard/events/custom
2. Create Event, choose Custom event
3. Trigger manually, from Run Custom Event node in another flow, or via integrations
4. Event type key: custom.event

### Create a webhook-triggered flow

1. Go to https://masterbot.gg/dashboard/events/custom
2. Create Event, choose Webhook (custom.webhook)
3. Configure the inbound webhook under Integrations if needed
4. External systems POST to the webhook URL to trigger the flow

### Create a timed (scheduled) event

1. Go to https://masterbot.gg/dashboard/events/timed
2. Create a timed schedule linked to a flow with event type custom.timed
3. Or create the flow under Events → Custom first, then bind a schedule on the Timed tab

### Manage database variables

1. Go to https://masterbot.gg/dashboard/database
2. Create, edit, or delete custom variables (persist across flow runs)
3. Use Set Variable / Reset Variable nodes in flows to read and write values
4. Tutorial: https://masterbot.gg/tutorials/variables

### Enable DM / User Install on a slash or context command

1. Open the flow in Flow Builder (/dashboard/flows)
2. Select the **Slash Command** or **Context Command** root node
3. In the right sidebar, enable **Available in DM (User Install)**
4. Save the flow
5. Share the User Install link from Bots → Bot Settings so users can install the command on their account
6. See https://masterbot.gg/llms-capabilities.txt for DM vs server-only behavior

### Create a context menu command (user or message)

1. Go to https://masterbot.gg/dashboard/commands
2. Create → **Context command**
3. In Flow Builder, select the Context Command root → set **Context Type** to **User Context** or **Message Context**
4. Build and save the flow

### Manage database variables (including per-server scope)

1. Go to https://masterbot.gg/dashboard/database
2. Create a variable and set **Scope** to `global`, `server`, `server-user`, or `server-channel`
3. `server` scope = different value on each Discord guild
4. Enable **targetable** for per-user or per-channel maps within a server
5. Full syntax: https://masterbot.gg/tutorials/variables

### Configure API keys and webhooks

1. Go to https://masterbot.gg/dashboard/integrations
2. Manage API secrets and inbound webhook endpoints for the selected bot

### View bot analytics

1. Go to https://masterbot.gg/dashboard/analytics
2. Review usage metrics for the selected bot

### View servers (guilds)

1. Go to https://masterbot.gg/dashboard/servers
2. See guilds where the bot is present

### Account settings

1. Go to https://masterbot.gg/dashboard/settings
2. Language, notifications, and account preferences

### Upgrade subscription / billing

1. Bots → select bot → billing upgrade card in Bot Settings
2. Or visit https://masterbot.gg/pricing
3. Only bot owner can manage paid subscriptions

### Open Flow Builder for an existing flow

1. Commands or Events list → find the flow → Edit / Open in Flow Builder
2. URL pattern: https://masterbot.gg/dashboard/flows (with flow context from the app)
3. See https://masterbot.gg/llms-flow-builder.txt for builder layout

### Debug a flow

1. Open the flow in Flow Builder
2. Open the Debug panel (bottom)
3. Run the command or trigger the event on Discord while debug is enabled
4. Inspect variable values and execution steps

---

## Related files

- Flow Builder layout: https://masterbot.gg/llms-flow-builder.txt
- Capabilities (commands, variables, math): https://masterbot.gg/llms-capabilities.txt
- Node list: https://masterbot.gg/llms-nodes.txt
- Event list: https://masterbot.gg/llms-events.txt
- Variable tutorial: https://masterbot.gg/tutorials/variables