Cogwing

Settle into your guild hall

Start with a party. Add private channels and alerts when your server needs them.

Your first party

  1. Add Cogwing to Discord and select a server you manage. The base invite asks to view channels, send messages and embed links.
  2. Open a text channel where Cogwing can view and send. Run /help. A server admin can run /setup timezone:Europe/Oslo, or choose another IANA timezone.
  3. Register your own main or alt with /character add. Profiles are manually entered.
  4. Run /lfg create for a spontaneous group, or /event create for a planned event. Planned events need Manage Events, Manage Server or Administrator.
  5. Press Join, choose your character, and use Reminders if you want a reminder. A full role puts you on its waiting list.

Private WoW channels and optional alerts

This is optional. Characters, groups and individual reminders work without it. The configuring admin needs Manage Server and Manage Roles, or Administrator.

  1. In Discord’s Server Settings → Roles, create WoW Access and WoW Alerts. Give both roles no server permissions. Keep the alert role non-mentionable and give it no channel permission grants.
  2. Give Cogwing’s own bot role Manage Roles. Put the two WoW roles below Cogwing and all unrelated roles above it. Cogwing does not need Administrator.
  3. Create a WoW category and a private text channel for game events inside it. Deny @everyone → View Channel; allow WoW Access → View Channel. Keep the access role’s grants within this category and limited to normal member permissions. Let Cogwing view and send there. Other explicit member or role View Channel grants in this event channel fail the privacy check.
  4. In that event channel only, allow Cogwing’s own role Mention @everyone, @here, and All Roles. This Discord permission lets Cogwing mention the otherwise non-mentionable alert role. Cogwing restricts its outgoing mention list to your selected alert role.
  5. Choose a welcome text channel outside the private category, so people can find it before joining.
  6. Run /wow-setup configure. Use Discord’s selectors for access_role, alert_role, category, welcome_channel and event_channel.
  7. Run /wow-setup status shortly afterward. “Checking” acknowledges the request; only “WoW roles enabled” means validation passed. A failed check tells you what to fix; then run configure again.
  8. For EU announcements and countdowns, run /gameevents enable in the selected event channel. Use /blue enable in your preferred blue-post channel. Role setup does not enable or move a feed.

Members use /wow join for access and /wow alerts-on for a separate alert opt-in. /wow alerts-off keeps access; /wow leave removes both roles. /wow status shows pending changes. Administrators retain channel visibility through Discord’s own permission rules.

Use /wow-setup disable to stop automation and role pings. It leaves existing Discord roles and permissions in place. Resolve pending role jobs before replacing a setup; existing memberships are not transferred to replacement roles.

Reminders without the noise

Individual group reminders are opt-in at 15, 30 or 60 minutes. /remind minutes:0 disables yours; leaving removes your pending reminder. Event changes notify only members who opted in. Discord settings still determine whether a mention creates a push notification.

EU game-event role alerts are a separate choice. Initial announcement cards and blue posts are quiet. Cogwing does not emit everyone or here mentions. Official-source announcements are not a live game-server status feed; calendar dates need an admin-reviewed source.

Remove data or uninstall

Run /data status to see your stored profile/signup/group counts. To delete your data in this server, leave optional WoW roles first with /wow leave, then run /data delete-mine confirm:DELETE. This also removes groups and weekly series you organized.

For a server-wide reset, an Administrator runs /data delete-server and confirms the exact server ID shown by /data status. This removes stored profiles, groups, settings and queued work. Run it before removing Cogwing. Existing Discord messages and assigned roles must be removed in Discord itself. These deletions are permanent; other servers are unaffected.

If background delivery is finishing, deletion asks you to retry shortly. Cogwing also checks server membership daily and removes active server data after Discord confirms the bot was removed; outages can delay confirmation. Privacy and retention details.

Get a hand from Ferbu

Email [email protected] for support, bug reports or privacy requests. Include the command, approximate time and a description. Add a server ID only when needed to identify the affected installation. Never send a bot token, password or game login.

Admins can run /ops status for held or failed deliveries and activity counts. Inspect a destination before retrying an uncertain message. Missing slash commands may need a Discord reload. If a channel is silent, check Cogwing can view, send and embed there.

Early public operation is limited to 120 normal actions per server per minute and 5,000 per day. Help, data deletion, operations and opting out remain accessible. Each enabled server checks the official EU source roughly every 15 minutes. This is best-effort hosting, with no guaranteed support or notification delivery time.