Baldio - Discord Bot
How to set up and use Baldio, the Discord bot that connects your Wowutils group to Discord
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.
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 5 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.
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 repost button follows the same requirements as the command here.
/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.
/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.