OVERSEER DOCS

Configuration

All bot settings live under the /setup command tree. You can change any setting at any time without resetting others. Changes take effect immediately.

Run /setup view at any time to see a full summary of your current configuration, including any missing or misconfigured values.

/setup channels

Assign Discord channels to each bot feature. Any unset channel causes the related feature to be silently skipped.

OptionUsed For
welcome_channelNew member welcome message
rules_channelRules reaction gate (link to rules message)
spotlight_channelSpotlight start announcements
trivia_channelDaily trivia questions
trivia_recap_channelDaily trivia stats recap
birthday_channelBirthday celebration announcements
rank_up_channelRank-up notification messages
live_announcements_channelGo-live for unranked / non-affiliate
bronze_live_channelGo-live announcements for Bronze members
silver_live_channelGo-live announcements for Silver members
gold_live_channelGo-live announcements for Gold members
diamond_live_channelGo-live announcements for Diamond members
stream_recap_channelEnd-of-stream attendance recap
mod_log_channelModeration action log (bans, kicks, timeouts)
raid_feedback_channelRaid Train member feedback submissions

/setup roles

Assign Discord roles to each rank and special function.

OptionPurpose
unranked_roleAssigned when a member has 0–249 XP
bronze_roleAssigned at 250 XP
silver_roleAssigned at 4,000 XP
gold_roleAssigned at 8,000 XP
diamond_roleAssigned at 15,000 XP
spotlight_supporter_roleAssigned during an active spotlight
affiliate_push_roleRole for affiliate-push spotlight recipients
hype_squad_roleAssigned to top trivia/stream participants
birthday_roleAssigned on a member's birthday

/setup features

Toggle individual features on or off. Disabling a feature stops the bot from responding to related triggers without clearing any stored data.

/setup features xp_system:true spotlight:true voice_xp:true trivia:true rank_announcements:true xp_decay:false auto_role_assignment:true twitch_tracking:true raid_train:false birthday:true

/setup xp_base

/setup xp_base message_xp:5 voice_xp:15 spotlight_xp:250 daily_trivia_xp:250

Base XP amounts per activity. All default values shown above.

/setup xp_ranks

/setup xp_ranks bronze_threshold:250 silver_threshold:4000 gold_threshold:8000 diamond_threshold:15000

XP thresholds at which members are promoted to each rank.

/setup xp_stream

/setup xp_stream bronze_stream_xp:5 silver_stream_xp:10 gold_stream_xp:25 diamond_stream_xp:50 stream_chat_multiplier:2 spotlight_multiplier:1.5

/setup antispam

/setup antispam enabled:true cooldown_seconds:30 max_xp_per_hour:500 min_message_length:2 block_duplicates:true

/setup decay

Configure XP decay for inactive members. Can be progressive (tiered) or flat-rate.

/setup decay enabled:true progressive:true tier1_days:7 tier1_rate:1 tier2_days:14 tier2_rate:5 tier3_days:30 tier3_rate:10
/setup decay enabled:true progressive:false flat_rate:5 flat_decay_after_days:14

/setup spotlight

/setup spotlight duration:60 message_interval:15 non_affiliate_multiplier:1.5 auto_delete_messages:false

duration is in minutes (minimum 15). message_interval is how often the bot posts a reminder during the spotlight.

/setup trivia

/setup trivia auto_post:true xp_reward:250 time_limit:10 ping_everyone:false categories:gaming,anime interval_hours:6

categories is a comma-separated list. Common values: gaming, anime, wrestling, horror, music, movies, sports. Add custom prompts with /setup trivia_custom action:add name:[name] prompt:[AI prompt].

/setup voice

/setup voice xp_per_minute:15 minimum_users:2 require_unmuted:true require_undeafened:false

/setup branding

Premium feature.
/setup branding bot_name:"The Warlord" community_name:"Warzone Kings" theme:"#ff4400" member_title:"Soldier" catch_phrase:"Built Different"

/setup rules

Set up a reaction gate — members must react to a specific message to gain access to the rest of the server.

/setup rules message_id:123456789 reaction:✅

/setup agegate

Post an age-verification button in a channel. Members who click confirm they are 18+ and are assigned the specified role.

/setup agegate channel:#verify-age role:@18plus

/setup subrole

Premium feature.
/setup subrole role:@TwitchSub announce_channel:#subscriber-announcements

/setup vote_link

Post a top.gg vote reminder every 4 hours. Members who vote earn a $5/mo discount on Premium subscriptions.

/setup vote_link channel:#vote-for-us enabled:true

Resetting Configuration

CommandDescription
/resetconfigReset ALL bot settings to factory defaults. Irreversible.
/resetxpWipe ALL member XP and ranks. Irreversible.
/setup viewDisplay current configuration summary.
/config statusShow configuration health check with warnings.
/resetconfig and /resetxp are permanent and cannot be undone. Use them only if you intend to start fresh.