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

  • Server Settings: Manage global server preferences
  • Logging Channels: Configure where various logs are sent
  • Bot Channels: Set dedicated channels for bot operations
  • Integration Settings: Configure external service integrations

Cog Configuration

  • Per-Cog Settings: Individual configuration for each loaded cog
  • Dynamic UI: Interactive configuration panels with validation
  • Permission Checks: Role-based access to configuration options
  • Real-time Updates: Changes take effect immediately

Configuration Types

  • Channels: Select text/voice channels for various purposes
  • Roles: Choose roles for permissions and assignments
  • Members: Select specific users for special access
  • Text Fields: Custom text input with validation
  • Numbers: Numeric inputs with min/max constraints
  • Booleans: Toggle switches for enabling features
  • Choices: Dropdown selections from predefined options

Commands

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

Access Control

  • Requires “Ban Members” permission by default
  • Can be restricted further by cog-specific permissions
  • Some settings require additional role checks

UI Components

The configuration system uses Discord’s interactive components:

  • Select Menus: Choose from lists of channels, roles, etc.
  • Text Inputs: Enter custom values with validation
  • Buttons: Navigate between configuration panels
  • Modals: Advanced input forms for complex settings

Best Practices

  1. Test Changes: Verify configuration changes work as expected
  2. Backup Settings: Keep records of important configurations
  3. Role Hierarchy: Ensure configured roles have appropriate permissions
  4. Channel Access: Verify bot has access to configured channels

Troubleshooting

  • Permission Errors: Check user roles and bot permissions
  • Invalid Values: Configuration UI validates inputs automatically
  • Changes Not Applying: Some changes may require bot restart
  • UI Not Loading: Ensure bot has necessary Discord permissions