Getting Started

1. Add the bot to your server

You’ll need Manage Server permission on the target Discord server.

→ Add Overlap Bot to Discord

After authorization, the bot joins your server and registers all slash commands. Commands may take up to an hour to propagate globally — if you’re self-hosting, use DEV_GUILD_ID for instant sync.

2. Configure your server (recommended)

Run /server_settings as a server admin to configure:

• Admin roles — who can manage server settings and all events
• Organizer roles — who can create and manage their own events
• Attendee roles — who can RSVP to events
• Bulletin channel — where event posts appear
• Time format — 12-hour or 24-hour

Without role configuration, Discord Administrators get admin access and everyone else defaults to attendee.

See Configuration → for the full reference.

3. Set your timezone

Before RSVPing, each member should run /settings to set their timezone. The bot uses this to display times correctly per user.

/settings

Select your IANA timezone (e.g. America/New_York, Europe/London) and preferred time format.

4. Create your first event

Run /create in any channel:

/create

A modal dialog appears with two fields:

• Event name — what you’re scheduling (must be unique on this server)
• Max attendees — optional cap; leave blank for unlimited

After submitting, a 14-day calendar appears — select one or more proposed time slots. The bot will post a bulletin embed in your configured bulletin channel.

5. Collect availability

Members click the Register button on the bulletin embed. They choose which slots they’re available for and mark their available time range within each slot. No account needed beyond Discord.

If a member hasn’t set their timezone yet, the bot will prompt them to do so before continuing.

6. Confirm the event

Run /events to see all active events and their overlap chart. Slots are sorted by attendance count:

• 🟩 Green — ≥ 75% of RSVPs available
• 🟨 Yellow — 40–74% available
• ⬜ Grey — < 40% available

Click a slot (as organizer or admin) to confirm it. Attendees with notifications enabled receive a Discord DM confirmation.

Next: Command Reference →