Baldio is the Discord bot that connects your Wowutils group to your Discord server: it posts your next setup, calendar events, and can auto-post recurring schedules, using roles and permissions you control.
Link it from your group hub's Integrations tab, then run a few setup commands in Discord to grant permissions and set your officer/raider roles.
What is Baldio?
Baldio is the Discord bot that connects your Wowutils group to Discord.
Setup
On Wowutils
Link the Bot
Open Integrations in your group hub and use the invite link in the Discord Bot section to add the bot to your server.
Set Your Timezone
Open Settings in your group hub and set your calendar server timezone, so the bot posts event times in the right zone.
On Discord
Once the bot is in your server, run these commands in Discord to finish setup.
Grant Permissions
The bot needs a couple of permissions in your Discord server to function:
- Send Messages in the channels you want to use the bot in
- Mention Roles if you want to ping roles when posting setups
Missing Permissions
If you get an error that says "Missing Permissions", make sure the bot has the required permissions in the channel you're trying to use it in.
Set Your Server Roles
- Requirement = ManageGuild permission
/server set-roles
This command will set officer and raider roles on the server. Officer roles have access to all bot features, and raider roles are more limited. If this is not set, everyone on the server can run commands. Timezone is now fetched automatically from the group's settings on https://wowutils.com/viserio-cooldowns; no manual timezone command is required.
Commands
Channel
There are channel-scoped commands used to set up and stop automatic posting of calendar schedules in a channel. These commands require the Manage Guild permission.
/channel setup-calendar-schedule
- Requirement = ManageGuild permission
- Members of the event, can update their status on the discord post.
- Input amount of events to keep posted : default to 2
This command lets you select a calendar events schedule (via autocomplete) and configure the current channel to automatically post events from that schedule. It will keep next x amount of events from that schedule posted in the channel, and auto remove them when the event is over.
/channel stop-calendar-schedule
- Requirement = ManageGuild permission
This command stops automatic posting for the selected channel calendar events schedule and attempts to remove any previously posted event messages for that schedule in the channel.
/channel subscribe-group-changes
- Requirement = ManageGuild permission
Turns the current channel into an activity feed for a group: raid nights created or cancelled, signup changes (including statuses set by an officer), and members linking or unlinking their Discord. New entries are posted within a few minutes. Stop it with /channel unsubscribe-group-changes.
/channel subscribe-group-calendar
- Requirement = ManageGuild permission
Keeps a specific group's upcoming calendar events posted in the current channel, with a configurable number of events to keep up. Stop it with /channel unsubscribe-group-calendar.
/channel bind-group
- Requirement = ManageGuild permission
Routes the current channel to a specific group instead of the server's default one. Useful when one Discord server runs more than one raid team: bind each team's channels to its own group and every post, calendar and feed in that channel follows that team. Undo it with /channel unbind-group.
Post
/post next-setup
Posts one or all setups from the most recently updated reset.
- Requirement = officer or a raider role (if set)
- If your reset has more than one setup, you'll be prompted to choose a specific setup or post all of them.
- You can mention up to 3 roles when the post is made, to notify your raid team.
- The post carries an Update button that refreshes the message in place, following the same requirements as the command.
/post setup
Same as /post next-setup, but you pick the reset yourself instead of taking the most recent one.
- Requirement = officer or a raider role (if set)
- If the reset has more than one setup, you'll be prompted to choose.
/post event
Lets you post a selected event from your group calendar, and see members and their status.
- Requirement = officer or a raider role (if set)
- You can mention up to 3 roles when the post is made, to notify your raid team.
- Members of the event, can update their status on the discord post.
- If the event has a setup linked to it, the post includes the setup as an image, and an Update button refreshes signups and the image in place.
/schedule
Automate recurring posts. This is an early version with basic functionality.
- Requirement = officer role (if set)
/schedule add-post-next-setup: Schedule a weekly/post next-setuppost, with role mentions./schedule disable: Select and disable a single schedule./schedule get-list: Get an overview of all current active or failed schedules./schedule activate-failed: Reactivate a failed schedule, giving you a chance to fix the error and get it running again.