Configuration Cog

The Configuration cog provides a centralized interface for managing Vör’s settings across your Discord server. It offers both guild-wide configuration and per-cog settings through an intuitive UI system.

Features

Guild Configuration

  • Manage server-wide settings
  • Configure logging channels
  • Set bot operation channels
  • Setup service integrations

Per-Cog Configuration

  • Individual settings for each cog
  • Interactive configuration UI
  • Real-time validation
  • Permission-based access control

Configuration UI

  • Channel selection dropdowns
  • Role selection menus
  • Text input fields
  • Boolean toggles
  • Number inputs with validation

Commands

Command Description
/config guild Manage server-wide settings
/config cog <name> Configure a specific cog
/config help Display configuration help

Guild Settings

Setting Description
Log Channel Where Vör logs command activity (cogs may have their own log channels)
Sentinel Channel Where Vör posts sentinel and automod alerts
Important Updates Channel Where Vör posts important notices from the Vör team (e.g. planned outages)
Dashboard Tier 1 / Tier 2 Roles Roles with read-only / full config access to the web dashboard
Disabled Cog Alert Send a message if a command from a disabled cog is run

Important Updates Channel

By default, important notices from the Vör team go to your server’s System Messages channel (Server Settings → Engagement). If that channel is public, for example so members can see boost messages, set an Important Updates Channel to keep Vör notices to your staff instead.

  • If the channel is deleted, the setting is cleared automatically and a note is posted in your Log Channel.
  • If Vör can’t post there when a notice goes out (for example it lost permission), the notice is sent to your System Messages channel instead, the setting is cleared, and the reason is posted in your Log Channel.
  • Make sure Vör can View Channel and Send Messages in the channel you pick.

Configuration Settings

Both guild and per-cog configurations support multiple input types:

  • Channels - Select text/voice channels
  • Roles - Choose server roles
  • Members - Select specific users
  • Text - Custom text input with validation
  • Numbers - Numeric values with min/max
  • Toggles - Enable/disable features
  • Dropdowns - Choose from predefined options

Hidden Cogs

Some cogs or commands may be hidden for your server by whoever runs the Vör instance you’re using. A hidden cog doesn’t appear in /config cog and can’t be configured, and its commands aren’t available in your server.

If you think a cog is missing:

  • Official Vör: ask in the Support Server.
  • Self-hosted Vör: ask whoever runs that instance.

Running your own instance? Cogs and commands are hidden per server from the Dashboard’s Server Access page (bot admins only).

Best Practices

  1. Test configuration changes before deploying
  2. Ensure bot has access to configured channels
  3. Verify role hierarchy is correct
  4. Document your configuration for team reference
  5. Review settings periodically