Docs / Guides / Run weekly raid signups

Run weekly raid signups

In short

You will have a weekly raid event with role caps, a waitlist and reminders. The bot can also open a voice channel before the start and record who turned up.

Before you start: if you want the voice channel in step 6, give the bot Manage Channels and Connect. To keep that channel to the members who signed up, give it Manage Roles too.

1. Turn on Beacon Events and run setup

Open the dashboard, pick the server, go to Services and turn on the Beacon Events switch. Then click Open, press Set it up for me on Home and confirm.

What setup creates
  • #beacon-events: everyone reads, only the bot posts. Setup saves it as the announcement channel.
  • A private #event-logs.
  • A channel the bot can see with beacon-events or event-announcements in its name is used instead of a new #beacon-events. One with event-logs or beacon-logs in its name is used instead of a new #event-logs.

See Set it up.

2. Open the event editor

In the Beacon Events menu, press New event. The editor has five steps: Event Info, Roles, Design, Actions and Finish. On Event Info, set the date, the time and the Length of the raid.

Templates, the length and creating events from Discord
  • Sixteen built-in templates are in the Fill in from a template... list at the top of the editor, and under Start fast on Home. Most of them, such as WoW Mythic Raid (20) and Guild Wars 2 Squad (10), come with role caps ready. You can also start blank.
  • Length runs from 30 minutes to 8 hours. It starts at the Default event length from the Settings page, 2 hours unless you changed it. The raid counts as over at its start plus its length.
  • You can also run /beacon create in Discord, but its form cannot set repeating, a length, a sign-up deadline or the voice channel. See /beacon create.

3. Set the roles and caps

In Roles, add one role per slot and give each a cap, for example Tank 2, Healer 4 and DPS 14. If the whole event has a limit, set Max participants on Event Info.

Quick Add, classes and the waitlist
  • The Quick Add box takes Tank:2, Healer:4, DPS:14.
  • A role can hold classes and specs that members pick after the role. A class or spec can have a cap of its own.
  • When a role, class or spec is at its cap, later members who pick it go on the waitlist and the bot names it. Once the event reaches Max participants, every new sign-up goes on the waitlist.
  • A seat frees up when someone leaves or stops attending. Raising a cap adds seats. Each free seat goes to the longest-waiting member whose role has room, with a DM. Nobody moves into a role past its cap.

4. Make it repeat every week

Under Recurrence, choose Weekly. Under Repeat On, tick each raid night, for example Tue and Thu. Set an End Date if the series should stop.

How repeating works
  • The choices are None, Daily, Weekly, Every 2 weeks and Monthly.
  • With Weekly, the next run is on the next ticked day at the same time. With no day ticked, it is on the same weekday a week later.
  • Every 2 weeks uses the ticked days of every second week. Weeks start on Monday. With no day ticked, the next run is on the same weekday two weeks later.
  • With Monthly, the next run is on the same day of the month. A series on the 29th, 30th or 31st runs on the last day of a shorter month, then goes back to its own day.
  • The first run is the date you set in Event Info, even when that day is not ticked.
  • The series stops after the End Date, at midnight in the event time zone. A run on the evening of that day still posts.
  • The Review at the bottom of the Finish step names the days it repeats on.
  • When a run ends, the next one posts with the same roles, caps, length, reminders, custom buttons and fields.
  • Cancelling one run skips only that date. The next run still posts.
  • A repeating event keeps its local time through daylight saving changes in the event time zone. You can set that time zone on the Settings page of Beacon Events.

5. Add reminders, a sign-up deadline and a minimum

Press Add reminder for each reminder. Under Advanced, set a Sign-up deadline and Min participants if you want them.

Reminder timing, the deadline and the minimum
  • Each reminder is 1 to 10,080 minutes before the start and goes to the channel or by DM.
  • Channel reminders mention everyone signed up as attending, tentative or late.
  • Sign-up deadline closes sign-ups that many minutes before the start. Members already signed up can still change their status after it.
  • Min participants puts "🎯 Still need" on the card with how many more confirmed sign-ups the raid needs. If it is still short at the warning time (3 hours before sign-ups close unless you pick another in Settings), the organizer gets one DM with the number and a link to the event's page. Pick a role under Ping when short and the bot also pings it once in the event's channel.

6. Turn on the voice channel

Under Advanced, check Auto-create voice channel. Then, on the Settings page of Beacon Events, pick the Category for voice rooms and Open the room before the start.

Channel timing, access and no-shows
  • The bot creates the channel 1 to 120 minutes before the start (15 by default), in the category you set. From then on the card links it under 🔊 Voice channel, until the event ends.
  • Only members who signed up can join lets everyone see the room, but only members signed up as attending, tentative, late or bench can connect. A member who signs up later or moves up from the waitlist can connect too. One who leaves or switches to Absent no longer can.
  • The bot needs Manage Channels and Connect. For a room kept to signed-up members it also needs Manage Roles, to let members in after the room is made.
  • Once the event has ended, the bot deletes the channel as soon as it is empty. It never deletes it while people are in it.
  • The event is marked complete when it ends. Joins count until then. A member signed up as attending who never joined the channel is logged as a no-show. A late member who never joined gets no credit.

7. Save and let members sign up

Press Create event. Every step of the editor has it, so you can save as soon as the basics are in. The card posts in the announcement channel with Sign Up, Leave and Options buttons.

What members can pick and what the card shows
  • Members pick a role from a dropdown.
  • Options lets them mark themselves Tentative, Late, Bench or Absent.
  • Discord shows the start time in each member's own time zone.
  • The card counts confirmed members against the caps, for example "18 / 20 confirmed, 2 tentative, 1 late". Each role lists its members with their class or spec. "🎯 Still need" names the roles under their cap, such as "1× Tank, 2× Healer".
  • The preview in the editor is this same card.

8. Check that it works

Press Sign Up yourself, pick a role, then press Leave. The card should add and remove your name within a couple of seconds.

Test the waitlist too

To test the waitlist, set a role cap of 1 on a test event and have a second member sign up for the same role. They should see "⏳ Tank is full, so you're on the waitlist." with your role's name. If something fails, see Troubleshooting.

Next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord