Configuration Guide

Deep dive into the /config command and all its subcommands.

Viewing Configuration

/config

Shows your current server configuration including:

• Connected brand
• Active events
• Role bonuses
• Channel settings
• Test mode status

---

Event Management

List All Events

/config events

Shows all configured events with:

• Event name and ID
• Reward amount
• Cooldown period
• Max claims
• Enabled/disabled status

Create an Event

/config events action:create name:my_event reward:50 cooldown:24 max-claims:1

Option	Required	Description
name	✅	Event identifier (lowercase, underscores)
reward	✅	RSNC amount (1-10,000)
cooldown	❌	Hours between claims (-1 or 0 = no cooldown)
max-claims	❌	Per-user claim limit (-1 = unlimited)
max-total-claims	❌	Total claims across all users (-1 = unlimited)
smart	❌	Enable Smart Rewards formula mode (true/false)
channels	❌	Restrict to specific channels (comma-separated)
trigger	❌	Detection trigger type: keyword, min_length, or reaction_count
keywords	❌	Comma-separated keywords (required for keyword trigger)
min-length	❌	Minimum message length in characters (required for min_length trigger, 10-2000)
min-reactions	❌	Minimum reactions to trigger reward (required for reaction_count trigger: 3, 5, 7, 10, 15, 20, or 25)

Cooldown Options

• cooldown:-1 or cooldown:0 → No cooldown (unlimited claims per day)
• cooldown:24 → 24-hour cooldown between claims
• For voice events, always use cooldown:-1 (voice tracker handles rate limiting)

Trigger Types

Events can optionally specify a trigger to enable automatic detection by the gateway relay. Without a trigger, events are manual-only (via /reward or /drop).

Keyword Trigger

Watch specific channels for messages starting with configured keywords.

/config events action:create name:gm_reward trigger:keyword keywords:gm,gn,gz channels:gm-channel reward:5 cooldown:24

• keywords: Comma-separated list of words to match (case-insensitive)
• channels: Optional channel restriction (recommended to prevent spam)
• Matches messages that start with the keyword (e.g., "gm everyone" matches "gm")

Min Length Trigger

Reward non-spam messages longer than N characters across the server.

/config events action:create name:quality_chat trigger:min_length min-length:50 reward:2 cooldown:1

• min-length: Minimum character count (10-2000)
• channels: Optional channel restriction
• Works with the gateway's quality message filter (spam is already excluded)

Reaction Count Trigger

Reward message authors when their post receives N+ reactions from unique users.

/config events action:create name:popular_post trigger:reaction_count min-reactions:5 reward:10 cooldown:0

• min-reactions: Minimum unique reactions (3, 5, 7, 10, 15, 20, or 25)
• Each message can only trigger a reward once per event (prevents double-rewarding)
• Rewards the message author, not the reactors

Edit an Event

/config events action:edit name:daily_checkin reward:30
/config events action:edit name:gm_checkin cooldown:12

Toggle Event On/Off

/config events action:toggle name:gm_checkin
/config events action:toggle name:gm_checkin enabled:false

Delete an Event

/config events action:delete name:my_event

Quick Reward Adjustment

/config reward gm_checkin 50
/config reward daily_checkin 25

---

Server-Wide Reward Multiplier

Apply a multiplier to all reward types across your server — GM/GN check-ins, quality messages, reaction drops, boosts, voice rewards, and third-party bot events.

Set Multiplier

/config multiplier multiplier:2.0 duration:3d

Option	Required	Description
multiplier	✅	Multiplier value (e.g., 1.5 = 50% bonus, 2.0 = double, 3.0 = triple)
duration	❌	How long: 1h, 3d, 7d, or permanent (default: permanent)

Examples:

/config multiplier multiplier:2.0 duration:7d    — Double rewards for one week
/config multiplier multiplier:1.5 duration:permanent  — Permanent 50% boost
/config multiplier multiplier:3.0 duration:1h    — Triple rewards for 1 hour (flash event)

Timed multipliers auto-expire via TTL — no cleanup needed. All reward calculation sites apply the multiplier on top of role bonuses and event-level rewards.

View / Remove

/config multiplier            — View current multiplier
/config multiplier multiplier:1.0  — Reset to default (no multiplier)

Use Cases

• Double XP weekends: 2.0 for 3d before a community event
• Flash rewards: 3.0 for 1h to drive engagement during a live session
• Permanent boost: 1.5 for a newly launched server to accelerate onboarding

---

Live Drop Management

Edit or disable active reaction drops without recreating them.

List Active Drops

/config drops action:list

Shows all active reaction drops with message ID, emoji, reward, claims, and expiry.

Edit a Drop

/config drops action:edit message_id:123456789 reward:50
/config drops action:edit message_id:123456789 emoji:🎁 max_claims:100
/config drops action:edit message_id:123456789 duration:24h

Option	Description
message_id	The message ID of the drop to edit
reward	New reward amount
emoji	New reaction emoji
max_claims	New max claims limit
duration	New duration from now

Disable a Drop

/config drops action:disable message_id:123456789

Deactivates the drop immediately. The message and reactions remain, but no new claims are processed. All edits and disables are audit-logged.

---

Role Bonus Configuration

Configure RSNC bonuses for Discord roles.

View Role Bonuses

/config role-bonus

Set Multiplier

/config role-bonus role:@VIP multiplier:1.5

Multiplier range: 1.0 to 5.0 (1.5 = 50% bonus)

Set Flat Bonus

/config role-bonus role:@Whale flat-bonus:25

Adds fixed RSNC to every reward (0-1,000 range).

Set Both

/config role-bonus role:@Booster multiplier:2.0 flat-bonus:10

Remove Role Bonus

/config role-bonus clear:@OldRole

Stacking Modes

Configure how multiple role bonuses combine:

/config stacking mode:multiplicative   # 1.5x × 1.2x = 1.8x
/config stacking mode:additive         # +50% + 20% = +70%
/config stacking mode:highest_only     # Only best bonus applies

---

Admin Roles

Control who can configure the bot.

Assign Admin Role

/config admin-roles role:@Moderator level:event_manager

Permission Levels:

Level	Value	Capabilities
Full Admin	full_admin	Everything
Event Manager	event_manager	Events, drops, rewards
Perk Manager	perk_manager	Create/edit perks
Viewer	viewer	View stats only

View Admin Roles

/config admin-roles

Remove Admin Role

/config admin-roles remove:@Moderator

Clear All

/config admin-roles clear:true

---

Admin Notifications

Get real-time notifications of all reward activity.

Set Admin Channel

/config admin-channel channel:#admin-logs

View Current Channel

/config admin-channel

Disable Notifications

/config admin-channel clear:true

---

Channel Configuration

Control which channels trigger rewards.

View Settings

/config channels

Exclude Channel

/config channels exclude:#spam-chat

Whitelist Mode

Only reward in specific channels:

/config channels include-only:#rewards-chat

Boost Channel

Give bonus rewards in a channel:

/config channels boost:#premium-chat multiplier:1.5

Clear Settings

/config channels clear:exclude
/config channels clear:all

---

User Management

Enable/disable rewards for specific users.

Disable User

/config user disable:@user reason:"Breaking rules"

Enable User

/config user enable:@user

Check Status

/config user status:@user

List Disabled Users

/config user list-disabled

---

Test Mode

Safely test configuration changes without affecting real rewards.

Enable Test Mode

/config test-mode enable:true

Restrict to Role

/config test-mode role:@Testers

Disable Test Mode

/config test-mode enable:false

Test mode behavior:

• Only testers/admins receive rewards
• All events logged with [TEST] flag
• Does not count toward KPIs

---

Streak Configuration

Set Grace Period

/config streaks grace-period:8    # 8 hours
/config streaks grace-period:48   # 48 hours (max: 72)

---

Voice Configuration

Voice rewards have their own rate-limiting system separate from event cooldowns.

View Voice Config

/config voice

Set Voice Rewards

/config voice minutes_per_reward:60 rsnc_per_reward:25 max_daily:3

Option	Description	Default
minutes_per_reward	Minutes in voice to earn one reward	60
rsnc_per_reward	RSNC amount per reward	25
max_daily	Maximum rewards per user per day	3

Voice Event Configuration

When creating a voice_time event via /config events, use cooldown:-1 or cooldown:0:

/config events action:create name:voice_time reward:25 cooldown:-1 smart:true

Why No Cooldown for Voice?

Voice rewards use maxRewardsPerDay (configured via /config voice) as the rate limit instead of event cooldown. This allows users to claim multiple rewards in a single voice session if they've accumulated enough time.

How Voice Rate Limiting Works

1. Voice Tracker tracks minutes accumulated per user per day
2. Voice Tracker enforces max_daily rewards per user
3. Event Handler trusts voice tracker and skips cooldown check
4. Max Total Claims still enforced if configured (global event limit)

---

Third-Party Integrations

Enable Integration

/config third-party enable:mee6

Set Reward Amount

/config third-party reward:mee6 amount:50

Disable Integration

/config third-party disable:mee6

View Status

/config third-party

---

Daily Event Configuration

Configure which event /daily triggers:

/config daily-event event_id:my_daily_event

---

Sync Discord Roles

Import Discord roles for reward configuration:

/config sync-roles