← Back to Docs

Getting Started

From inviting the bot to running your first event — a 10-minute walkthrough for new admins.

So you've decided to give StarBot a try. This guide takes you from the invite link to a working configuration in about 10 minutes. We'll set up just enough that members can verify their RSI handle, apply to your org, and RSVP for events — the three things most guilds use first.

1. Invite the bot

Open the Discord App Directory page for StarBot and click Add to Server. Choose your guild and grant the requested permissions.

Easiest path: grant Administrator. If you prefer a least-privilege setup, grant at minimum:

  • Manage Roles
  • Manage Channels
  • Manage Events
  • Send Messages
  • Embed Links
  • Read Message History

The Manage Events permission is the one that surprises people — without it, StarBot can't mirror your scheduled events into Discord's server-sidebar Events tab.

2. Open the dashboard

Go to trystarbot.com and log in with Discord. After OAuth, click Your Servers in the navbar and pick the guild you just added the bot to.

If your guild doesn't appear in the list, you don't have Manage Guild or Administrator permission in that guild. Ask the guild owner to grant you the permission, then refresh.

You're now on your guild's admin page. Every feature has a tab here, and every tab corresponds to a /config-* slash command in Discord. Both routes write to the same underlying tables — use whichever is faster for you.

3. Enable citizen verification

Most StarBot guilds use the verification badge to confirm members actually own the RSI handle they claim. Set it up in 30 seconds:

  1. Open the Citizen tab on the dashboard.
  2. Toggle Verification enabled on.
  3. (Optional) Set a reminder channel and how often unverified members get a nudge DM.
  4. Save.

Members can now run /citizen set handle:YourHandle followed by /citizen verify in Discord, or visit their Profile page on the dashboard to verify there with one click.

4. Set up applications

If you want a recruitment funnel into your guild or org:

  1. Open the Applications tab on the dashboard.
  2. Click Create Application Type. Pick a name (e.g. "Recruitment"), and the role to assign on approval.
  3. Add your questions. Each question can be required or optional.
  4. Pick the log channel where new applications post for review.
  5. Save.

Now run /post-app in the channel where you want the "Apply Now" button visible. Members click → fill in the questions → your reviewers get a button to approve or deny.

5. Create your first event

Two flavors:

  • Time event — scheduled meetup with RSVPs. Best for ops nights, training, social hours.
  • Goal event — delivery drive with item targets. Best for "we need 5,000 SCU of Titanium by Friday".

For a time event:

  1. In Discord, run /event create with the date, time, and a title. Set the type to "Server-Wide" if you don't have custom event types yet.
  2. The bot posts an RSVP embed in your configured board channel and also adds the event to Discord's server-sidebar Events tab.
  3. Members click Going / Maybe / Leave. DM reminders fire at the offsets you configured.

Goal events follow the same /event create flow with mode:goal plus a deadline, then /event item add for each item you need delivered. See the Events guide for the full goal-drive lifecycle.

6. Where to go next

  • Citizen Verification guide — full lifecycle: token generation, bio matching, reminder system, gating other features behind verified status.
  • Events guide — recurring events, capacity + waitlist, broadcast channels, goal-drive leaderboards.
  • Subscription Tiers — what's free, what's paid, how to upgrade.
  • FAQ — the questions we get most often.

You're done with the minimum setup. Pop into our support server if you get stuck — we're active.