⚙️Configuration

Get Ivar started

Click [HERE] to invite Ivar in your Guild.

📋 Overview

The Server Configuration module provides three methods for setting up the bot in your server: Manual Setup (step-by-step role and channel configuration), Feature Management (enable/disable individual features), and Automatic Configuration (AI-powered detection and setup). The system includes core setup for Dominant/Submissive roles and moderator channel, feature toggles for 10+ optional systems (Economy, Jail, Leveling, Gags, Counting, Safeword, Confessions, etc.), intelligent channel and role detection, automatic creation of missing resources, permission management, and comprehensive status reporting. Configuration persists in database and can be modified at any time.

⚙️ How It Works

Manual Setup Process (/manage setup): The bot guides administrators through three required configuration steps:

  1. Dominant Roles: Set roles that can strike, jail, own, protect, punish, and give tasks

  2. Submissive Roles: Set roles that can be owned, jailed, punished, and receive tasks

  3. Moderator Channel: Designate channel for safeword notifications and bot announcements

Each step uses Discord message collection with role/channel mentions. Setup includes validation to prevent overlapping roles (submissives cannot be dominants). Configuration completes with summary showing all selected roles and channels.

Feature Management (/manage features): Interactive dropdown menu allows enabling/disabling individual features:

  • Select feature from dropdown

  • System checks premium requirements (Safeword, Confessions require "Kinkster" membership)

  • Enable/Disable toggle buttons appear

  • If enabling, additional configuration prompts appear (channels, roles, moderation options)

  • Feature saves to database upon completion

Automatic Configuration 👑 (/auto-config): AI-powered system that detects and configures everything automatically:

  1. Detection Phase: Scans server for existing channels/roles matching patterns

  2. Preview Phase: Shows what will be detected vs created

  3. Confirmation: Requires admin approval before proceeding

  4. Creation Phase: Creates missing channels and roles

  5. Configuration Phase: Enables all features with proper settings

  6. Permission Phase: Sets channel permissions for prisoner role, etc.

  7. Summary Phase: Reports all actions taken

Channel Detection: System searches channel names for keywords:

  • Prison: jail, prison, cell, detention, correctional

  • Gag Logs: gag, muzzle, silence, gag-log

  • Counting: count, counting, number

  • Work: work, bank, job, employment, labor

  • Gambling: gambl, casino, bet, slot, dice

  • Ownership: owner, ownership, collar, claim

  • Simp: simp, devot, worship, admire

  • Worship: worship, praise, adore, tribute

  • Level-ups: level, bank, rank, xp, experience

  • Revive: playtime, games, revive, question, daily, qotd, topic

  • Confessions: confess, confession, anon, anonymous

  • Moderation: mod-chat, moderation, staff-chat

Role Detection: System searches role names for keywords:

  • Prisoner: prisoner, jailed, inmate, detained, punished

  • Reviver: reviver, ping, notify, question

Premium Features: Some features require "Kinkster" membership tier:

  • Safeword System

  • Confession System

Non-Kinkster servers see Patreon link when attempting to enable these.

🔑 Key Commands

/manage setup

Description: Set me up in this server (Manual Setup) Access: Administrator permission required Cooldown: 30 seconds per server Function: Step-by-step guided setup for core bot configuration.

Setup Steps:

Step 1 - Dominant Roles (1-minute timeout):

  • Prompt: Mention Dominant roles

  • Input: Role mentions (@Role1 @Role2)

  • Permissions granted: Strike, jail, own/disown, protect/unprotect, punish/praise, give tasks

  • Validation: At least one role required

  • Storage: Saved as 'domme' config

Step 2 - Submissive Roles (1-minute timeout):

  • Prompt: Mention Submissive roles

  • Input: Role mentions (@Role1 @Role2)

  • Permissions granted: Can be owned, jailed, punished, receive tasks, worship

  • Validation: At least one role required, cannot overlap with Dominant roles

  • Filtering: Automatically removes roles also in Dominant list

  • Storage: Saved as 'slave' config

Step 3 - Moderator Channel (1-minute timeout):

  • Prompt: Mention moderator channel

  • Input: Channel mention (#channel)

  • Purpose: Safeword notifications, bot announcements

  • Validation: Must be valid channel

  • Storage: Saved as 'bot_announcement' config

Completion Summary:

Title: ✅ Configuration Done!
Shows: 
- All Dominant roles
- All Submissive roles  
- Moderator channel
- Suggestion to use /manage features next

Error Handling:

  • Timeout: "⏱️ Timeout - Use /manage setup to restart"

  • Invalid input: "❌ Configuration Incomplete - Role or Channel not set properly"

  • Auto-reset cooldown on errors

Database Actions:

  • Clears ALL previous config data before starting

  • Saves each role/channel selection immediately

  • Persistent storage in config database

/manage features

Description: View all the features available (Feature Management) Access: Administrator permission required Cooldown: 30 seconds per server Function: Interactive menu to enable/disable individual bot features.

Available Features:

🤐 Gag Logs:

  • Description: Log gagged messages to designated channel

  • Configuration: Enable/Disable → Channel mention (if enabled)

  • Database key: 'gags_channel'

🎮 Counting Game:

  • Description: Members earn gems for counting

  • Configuration: Enable/Disable → Channel mention (if enabled)

  • Note: Requires dedicated channel, auto-deletes non-count messages

  • Database key: 'counting'

💰 Economy System:

  • Description: Work, gambling, money bags, daily rewards

  • Configuration: Enable/Disable → Work channel, gambling channel (if enabled)

  • Database keys: 'bank_channel', 'gambling_channel', 'loops' (money bags)

⛓️ Dynamic Relationships:

  • Description: Ownership, protection, devotion systems

  • Configuration: Enable/Disable → Ownership channel, simp channel, worship channel (if enabled)

  • Database keys: 'ownership_channel', 'simp_channel', 'worship_channel'

📊 Leveling System:

  • Description: XP gain from messages/voice, level-up rewards

  • Configuration: Enable/Disable → Level-up announcement channel (if enabled)

  • Database keys: 'levelingup_channel', 'levels' (option: on/off)

⛓️ Jail System:

  • Description: Prison punishment with writing tasks

  • Configuration: Enable/Disable → Prison channel (if enabled) → Create/assign prisoner role

  • Database keys: 'prison', 'prisoner'

  • Permissions: Sets prisoner role to view_channel=False for all channels except prison

🎲 Revive Feature:

  • Description: Automated truth/dare, NHIE, WYR questions

  • Configuration: Enable/Disable → Channel mention (if enabled)

  • Database key: 'reviver'

🤫 Confessions (Premium - Kinkster):

  • Description: Anonymous confession submission system

  • Configuration: Enable/Disable → Confession channel → Enable moderation? → Moderation channel (if enabled)

  • Database keys: 'confession_channel', 'confession_moderation' (0/1), 'confession_moderation_channel'

  • Access: Requires Kinkster membership

🛡️ Safeword System (Premium - Kinkster):

  • Description: Emergency alert system with three severity levels

  • Configuration: Uses moderator channel from /manage setup

  • Roles: Set in separate safeword configuration

  • Database key: 'safeword_channel'

  • Access: Requires Kinkster membership

Success Message:

Title: ✅ Successful!
Description: Configurations saved! You are all set.

Premium Restriction:

Title: ⭐ Premium Required
Description: To access this feature, you must be a Kinkster!
Button: Link to Patreon

/auto-config preview 👑

Description: Preview what auto-configuration will detect and create Access: Administrator permission required Cooldown: 60 seconds per server Function: Shows intelligent detection results without making changes.

Display Sections:

✅ Detected Channels: Lists all matching channels found:

• 🔒 #jail (Prison)
• 🏦 #work (Bank)
• 🎯 #gambling (Gambling)
etc.

✅ Detected Roles: Lists all matching roles found:

• ⛓️ @Prisoner (Prisoner role)
• 🎲 @Reviver (Reviver notification role)

🔨 To Be Created: Lists what will be created:

• 📝 #jail
• 📝 #gag-logs
• 📝 @Prisoner role
etc.

⚙️ Features to Enable:

• ⛓️ Jail System
• 💎 Economy System
• 📈 Leveling System
• 🔗 Dynamic Relationships
• 🤐 Gag Logs
• 🔢 Counting Game
• 💰 Money Bags
• 🎯 Daily Questions
[Premium: 🛡️ Safeword, 🎭 Confessions]

No Changes Made: This is preview-only, nothing configured.

/auto-config run 👑

Description: Automatically configure all server features Access: Administrator permission required Cooldown: 60 seconds per server Requirements: Must run /manage setup first Function: Fully automated configuration of all features.

Process:

1. Prerequisite Check: Verifies basic setup complete (Dominant roles, Submissive roles, Moderator channel)

If missing: ⚠️ Initial Setup Required - Please run /manage setup first

2. Confirmation Prompt:

Title: 🚀 Auto-Configuration
Description: 
- Enable all available features
- Create necessary channels and roles
- Set up proper permissions
- Configure economy and leveling systems

Buttons: [Confirm] [Cancel]

3. Configuration Progress: Live-updating embed shows current action:

⚙️ Configuring Server
⏳ Setting up features...
⏳ Configuring Jail System...
⏳ Configuring Economy System...
⏳ Configuring Dynamic Relationships...
⏳ Configuring Gag Logs...
⏳ Configuring Counting Game...
⏳ Configuring Leveling System...
⏳ Configuring Daily Questions...
⏳ Configuring Money Bags...
[Premium: ⏳ Configuring Safeword System...]
[Premium: ⏳ Configuring Confessions...]

4. Feature Configuration Details:

Jail System:

  • Detects: jail, prison, cell, detention, correctional channels

  • Creates: #jail channel (if needed)

  • Detects: prisoner, jailed, inmate roles

  • Creates: @Prisoner role (if needed)

  • Permissions: Sets prisoner role blocked from all channels except jail

Economy System:

  • Detects: work, bank, job channels → Creates #work if needed

  • Detects: gambl, casino, bet channels → Creates #gambling if needed

  • Enables: Economy system in database

Dynamic Relationships:

  • Detects: owner, ownership channels → Creates #ownership if needed

  • Detects: simp, devot channels → Creates #devotion if needed

  • Detects: worship, praise channels → Creates #worship if needed

Gag Logs:

  • Detects: gag, muzzle, silence channels → Creates #gag-logs if needed

Counting Game:

  • Detects: count, counting channels → Creates #counting if needed

Leveling System:

  • Detects: level, rank, xp channels → Creates #level-ups if needed

  • Enables: Leveling system in database ('option': 'on')

Daily Questions:

  • Detects: revive, question, daily channels → Creates #daily-questions if needed

Money Bags:

  • Detects: general, chat, talk, main channels

  • Uses: Up to 3 detected general channels

  • Enables: Money bag drops in those channels

Safeword System (Premium):

  • Uses: Moderator channel from basic setup

  • Enables: Safeword notifications

Confessions (Premium):

  • Detects: confess, confession, anon channels → Creates #confessions if needed

  • Detects: mod-chat, moderation channels → Creates #confession-review if needed

  • Enables: Confession moderation system

5. Completion Summary:

Title: ✅ Auto-Configuration Complete
Description: Your server has been successfully configured!

🔨 Created Items
- Channels: X created
- Roles: Y created

⚙️ Enabled Features
✅ Jail System
✅ Economy System
✅ Leveling System
[etc.]

📌 Next Steps
• Review created channels and adjust permissions
• Customize feature settings with /manage features
• View configuration with /view stats

👥 Who It's For

Administrators: All three commands require Administrator permission

Server Owners: Can configure bot for their servers

Setup Methods:

  • Manual Setup: Step-by-step control, good for custom configurations

  • Feature Management: Individual feature control, modify existing setup

  • Automatic Configuration: Quick setup, AI-powered detection, best for new servers

💡 Why This Feature

Manual Setup: Provides complete control over role selection. Ensures proper role permissions. Prevents conflicts with automatic Removes overlap. Creates foundation for all features. Simple three-step process. Clear validation and feedback.

Feature Management: Granular feature control. Enable only desired features. Easy to modify configuration. Premium tier gating. Channel-specific assignments. Moderation options. No unwanted features.

Automatic Configuration: Saves massive time for admins. Intelligent detection prevents duplicates. Creates only what's needed. Sets proper permissions automatically. Enables all features at once. Perfect for new servers. Professional channel organization. Reduces configuration errors.

Made by DIVINITY • Pleasure Corner

PreviousSupport & UtilitiesNextFAQ

Last updated

Was this helpful?