Discord Commands Reference

Complete reference for all 32 registered Resonance Discord bot commands and their subcommands.

Quick Navigation

Member Commands — Economy, engagement, perks, community
Admin Commands — Setup, config, rewards, analytics, KPI, testing
Quick Reference Card — Most-used commands at a glance

Member Commands

Commands available to all server members.

DM Support

Works in DMs	Commands
Yes	`/balance`, `/help`, `/link`
No (server required)	All other commands

Economy & Rewards

Command	Description	Example
`/join`	Claim one-time welcome bonus	`/join`
`/daily`	Daily check-in reward (resets midnight UTC)	`/daily`
`/claim`	Claim a specific reward event	`/claim event_id:news_tracker`
`/balance`	Check RSNC balance (on-chain + pending + total earned from KV stats). Works in DMs.	`/balance`
`/cooldowns`	View your active cooldown timers and daily charge status	`/cooldowns`

Engagement & Progress

Command	Description	Example
`/streak`	View streak status, multiplier, and milestones	`/streak`
`/voice check`	View voice channel time progress	`/voice check`
`/voice claim`	Claim accumulated voice time rewards	`/voice claim`
`/leaderboard`	View server rankings	`/leaderboard type:rsnc_earned period:week`
`/roles`	View loyalty roles and their effects	`/roles`

Leaderboard options:

type: rsnc_earned, activity, claims, streak, voice_time
period: all, week, month

Voice Command Privacy

/voice responses are ephemeral (only visible to you). This keeps your reward status private.

Perks & Shopping

Command	Description	Example
`/perks`	Browse available perks	`/perks`
`/perk-buy`	Purchase a perk with RSNC	`/perk-buy id:perk-uuid`
`/buy-role list`	View purchasable roles	`/buy-role list`
`/buy-role info`	Get role details and supply	`/buy-role info role:@VIP`

Account Linking

Command	Description	Example
`/link x`	Link X (Twitter) account	`/link x`
`/link google`	Link Google account	`/link google`
`/link telegram`	Link Telegram account	`/link telegram`
`/link wallet`	Link external wallet	`/link wallet`
`/link view`	View all linked accounts	`/link view`
`/link unlink`	Unlink an account	`/link unlink x`

Works in both DMs and guild channels. See Account Linking for the full flow.

Milestones

Command	Description	Example
`/milestone create`	Create a milestone tied to a Discord role	`/milestone create role:@Veteran name:Veteran`
`/milestone edit`	Edit milestone name, description, or reward	`/milestone edit role:@Veteran reward:500`
`/milestone add-criteria`	Add a criteria requirement	`/milestone add-criteria role:@Veteran type:messages_total threshold:1000`
`/milestone remove-criteria`	Remove a criteria type	`/milestone remove-criteria role:@Veteran type:messages_total`
`/milestone list`	List all milestones for this server	`/milestone list`
`/milestone delete`	Delete a milestone	`/milestone delete role:@Veteran`

See Milestones for criteria types and evaluation details.

Command	Description	Example
`/help`	Get help on commands and topics	`/help topic:streaks`

Admin Commands

Commands for server administrators and moderators.

Permission Levels

Level	Who Gets It	What They Can Do
Full Admin	"Manage Server" permission holders	Everything
Event Manager	Assigned via `/config admin-roles`	Create events, drops, change rewards
Perk Manager	Assigned via `/config admin-roles`	Create and edit perks
Viewer	Assigned via `/config admin-roles`	View stats and audit logs

Setup Commands

Command	Description	Permission
`/setup wizard`	Guided setup wizard with permission checks	Full Admin
`/setup connect`	Connect server to brand	Full Admin
`/setup status`	Check connection status and health	Full Admin
`/setup check`	Run permission audit	Full Admin
`/setup disconnect`	Disconnect from Resonance	Full Admin
`/setup security-key`	Add or update HMAC authentication key	Full Admin

Connect example:

/setup connect brand_id:0xYOUR_BRAND_ADDRESS security_key:YOUR_SECURITY_KEY

Configuration Commands

Command	Description	Permission
`/config events`	List, create, edit, or delete reward events	Event Manager+
`/config reward`	Quick reward amount adjustment	Event Manager+
`/config multiplier`	Set server-wide reward multiplier (timed or permanent)	Full Admin
`/config drops`	List, edit, or disable active reaction drops	Event Manager+
`/config stacking`	Set role bonus stacking mode	Full Admin
`/config streaks`	Configure streak settings	Full Admin
`/config voice`	Configure voice channel rewards	Full Admin
`/config third-party`	View third-party bot integrations	Full Admin
`/config role-bonus`	Configure role multiplier bonuses	Full Admin
`/config admin-roles`	Manage admin role permissions	Full Admin
`/config admin-channel`	Set admin notification channel	Full Admin
`/config channels`	Include or exclude specific channels	Full Admin
`/config user`	Enable or disable specific users	Full Admin
`/config test-mode`	Enable or disable test mode	Full Admin

Stacking modes:

multiplicative — Role bonuses multiply (e.g., 1.2x * 1.3x = 1.56x)
additive — Role bonuses add (e.g., 1.2x + 1.3x = 1.5x)
highest_only — Only the highest bonus applies

Examples:

/config events                           — List all events
/config reward daily_checkin 5           — Set daily check-in to 5 RSNC
/config multiplier multiplier:2.0 duration:3d  — 2× rewards for 3 days
/config multiplier multiplier:1.5 duration:permanent — Permanent 1.5× multiplier
/config drops action:list                — List all active reaction drops
/config drops action:edit message_id:123 reward:50  — Edit a live drop
/config drops action:disable message_id:123  — Disable a drop without deleting
/config streaks grace_period:2           — Allow 2 missed days
/config stacking mode:multiplicative     — Stack role bonuses multiplicatively
/config test-mode enable:true            — Enable test mode
/config channels exclude:#bot-spam       — Exclude a channel from rewards

Reward & Drop Commands

Command	Description	Permission
`/reward`	Manually reward a user	Event Manager+
`/drop`	Create a button or reaction drop	Event Manager+
`/reaction-drop`	Legacy reaction drop creation	Event Manager+
`/watch start`	Auto-create drops for every message in a channel	Event Manager+
`/watch stop`	Stop watching a channel	Event Manager+
`/watch list`	View all watched channels	Event Manager+

Drop options:

event_id — Event to trigger (from monitoring_rules)
type — button (default) or reaction
message_id — Attach to specific message
emoji — Custom reaction emoji
lifespan — Duration: 1s, 5m, 2h, 24h, permanent
label — Button label text
description — Drop description

Examples:

/drop event_id:announcement_reward label:"Claim!"
/drop event_id:news_tracker type:reaction message_id:123456 emoji:🎉 lifespan:2h
/watch start channel:#announcements
/watch start channel:#news event:news_tracker emoji:📰 reward:10
/watch stop channel:#announcements
/reward event_id:helpful_contribution user:@alice reason:"Great answer"

Perk Management

Command	Description	Permission
`/perk create`	Create a new perk	Perk Manager+
`/perk edit`	Edit existing perk	Perk Manager+
`/perk delete`	Delete a perk	Perk Manager+
`/perk list`	List all perks	Any user

Categories: General, Fashion, Events, Art, Gaming, Exclusive, Digital, Physical, Experience

Example:

/perk create name:"VIP Access" price:1000 description:"Exclusive VIP channel access" max-supply:100

Analytics Commands

Command	Description	Permission
`/stats`	Main dashboard — users, engagement, rewards	Viewer+
`/stats period:day`	Daily stats	Viewer+
`/stats breakdown:events`	Breakdown by event type	Viewer+
`/stats compare:true`	Compare to previous period	Viewer+
`/audit`	View recent audit events	Viewer+
`/audit user:@user`	Filter audit by user	Viewer+
`/audit type:rewards`	Filter by action type	Viewer+
`/audit export:true`	Export audit log as CSV	Viewer+
`/export type:rewards`	Export reward history	Viewer+
`/export type:users`	Export user data	Viewer+
`/export type:config`	Export server configuration	Viewer+
`/segments list`	View user segment categories	Viewer+
`/segments view`	View users in a segment	Viewer+

User segments:

whales — Top earners
power_users — Highly active
new_users — Recently joined
at_risk — Activity declining
dormant — Inactive users
voice_regulars — Frequent voice users

Export periods: week, month, all

KPI Commands

Comprehensive performance monitoring with alerts, custom metrics, and presets.

Basic KPI Management:

Command	Description	Permission
`/kpi set`	Set a KPI target with period	Event Manager+
`/kpi list`	View all configured KPIs	Viewer+
`/kpi report`	View KPI performance report	Viewer+
`/kpi remove`	Remove a KPI target	Event Manager+
`/kpi compare`	Period comparisons vs baseline	Event Manager+

Examples:

/kpi set metric:daily_active_users target:100 period:week
/kpi compare set metric:daily_active_users baseline_start:2025-01-01 baseline_end:2025-01-31

Alert Configuration:

Command	Description	Permission
`/kpi alert-config`	View or configure metric alerts	Event Manager+

/kpi alert-config metric:daily_active_users threshold:80 frequency:daily severity:warning
/kpi alert-config metric:daily_active_users channel:#alerts escalation_days:3

Compound Alerts (Multi-Condition):

Command	Description	Permission
`/kpi compound-alert create`	Create multi-condition alert	Event Manager+
`/kpi compound-alert list`	List all compound alerts	Event Manager+
`/kpi compound-alert view`	View alert details	Event Manager+
`/kpi compound-alert remove`	Remove compound alert	Event Manager+
`/kpi compound-alert toggle`	Enable or disable alert	Event Manager+
`/kpi compound-alert history`	View alert trigger history	Event Manager+

/kpi compound-alert create name:"Server Health" conditions:"dau<100,streak<50" logic:AND

Custom Metrics (Formula-Based):

Command	Description	Permission
`/kpi custom-metric create`	Create formula-based metric	Event Manager+
`/kpi custom-metric list`	List all custom metrics	Event Manager+
`/kpi custom-metric view`	View metric details	Event Manager+
`/kpi custom-metric edit`	Edit custom metric formula	Event Manager+
`/kpi custom-metric remove`	Remove custom metric	Event Manager+
`/kpi custom-metric test`	Test a formula without creating	Event Manager+

/kpi custom-metric create name:"Engagement Score" formula:"(dau*0.6)+(wau*0.4)"
/kpi custom-metric test formula:"dau*2"

Presets & Templates:

Command	Description	Permission
`/kpi preset list`	List available presets	Event Manager+
`/kpi preset view`	View preset details	Event Manager+
`/kpi preset apply`	Apply a preset to your server	Event Manager+
`/kpi preset create`	Save current config as preset	Event Manager+
`/kpi preset remove`	Remove a preset	Event Manager+

Role-Based Alert Routing:

Command	Description	Permission
`/kpi role-alerts set`	Route alerts to specific roles/channels	Event Manager+
`/kpi role-alerts list`	View role alert configuration	Event Manager+
`/kpi role-alerts remove`	Remove role alert routing	Event Manager+

/kpi role-alerts set severity:critical role:@Admin channel:#alerts

Available KPI Metrics:

Metric	Description
`daily_active_users`	Users who claimed rewards today
`weekly_active_users`	Users active this week
`streak_retention`	Percentage of users maintaining streaks
`new_user_conversion`	Percentage of new users who engage
`voice_participation`	Percentage of users using voice
`reward_efficiency`	Average RSNC per user
`churn_rate`	Percentage of users gone inactive
`triggered_event_rate`	Events triggered per day
`events_per_active_user`	Average events per active user
`time_to_first_reward`	Median hours to first reward
`repeat_event_rate`	Average events per rewarded user
`avg_streak_length`	Average streak length
`streak_break_frequency`	Percentage of streaks that break

Reports Commands

Command	Description	Permission
`/reports schedule`	Schedule automated reports	Event Manager+
`/reports preview`	Preview what a report looks like	Viewer+
`/reports disable`	Disable all scheduled reports	Event Manager+
`/reports list`	List active report schedules	Viewer+

Schedule options:

frequency: daily, weekly, monthly
channel: Target channel for reports
day: Day of week (for weekly) or day of month
type: stats, kpi, full

/reports schedule frequency:weekly channel:#admin-reports day:monday type:full

Diagnostic Commands

Command	Description	Permission
`/test all`	Full diagnostic suite (runs all checks)	Full Admin
`/test connectivity`	Test connections to Resonance services	Full Admin
`/test permissions`	Check bot permissions in server	Full Admin
`/test config`	Validate server configuration	Full Admin
`/test reward`	Dry-run the reward pipeline (no RSNC sent)	Full Admin
`/test reward-live`	Live reward test (brand→brand, net 0)	Full Admin
`/test write`	Test database write capability	Full Admin
`/test cron`	Test CRON-based activity polling	Full Admin
`/test gateway`	Test natural participation event detection	Full Admin
`/test report`	Generate a full diagnostic report	Full Admin

Test Mode

Enable test mode before experimenting: /config test-mode enable:true. This prevents accidental rewards to members while you configure.

Quick Reference Card

Most Used — Members

/daily          — Daily check-in (say "gm" or "gn" for auto-reward)
/balance        — Check RSNC balance (on-chain + pending + total earned)
/cooldowns      — View active cooldown timers and daily charges
/streak         — View streak status
/perks          — Browse perks
/leaderboard    — See rankings
/voice check    — Check voice time progress
/link x         — Link X/Twitter account for cross-platform rewards
/help           — Get help

Most Used — Admins

/config events                    — View/manage all events
/config reward daily_checkin 5    — Change reward amount
/config multiplier 2.0 duration:7d — Double rewards for a week
/config drops action:list         — Manage active drops
/watch start channel:#news        — Auto-drop on every message
/drop event_id:EVENT              — Create a one-off drop
/reward event_id:EVENT user:@user — Manual reward
/stats                            — View analytics dashboard
/kpi report                       — KPI performance overview
/test all                         — Run full diagnostics

Configuration Guide — Detailed /config deep-dive
Events & Rewards Guide — How events, detection, and cooldowns work
Advanced Features — KPI compound alerts, custom metrics, presets
Drops & Events — Creating and managing drops
Troubleshooting — Common issues and fixes

Member Commands​

DM Support​

Economy & Rewards​

Engagement & Progress​

Perks & Shopping​

Account Linking​

Milestones​

Community & Social​

Admin Commands​

Permission Levels​

Setup Commands​

Configuration Commands​

Reward & Drop Commands​

Perk Management​

Analytics Commands​

KPI Commands​

Reports Commands​

Diagnostic Commands​

Quick Reference Card​

Most Used — Members​

Most Used — Admins​

Related Guides​

Member Commands

DM Support

Economy & Rewards

Engagement & Progress

Perks & Shopping

Account Linking

Milestones

Community & Social

Admin Commands

Permission Levels

Setup Commands

Configuration Commands

Reward & Drop Commands

Perk Management

Analytics Commands

KPI Commands

Reports Commands

Diagnostic Commands

Quick Reference Card

Most Used — Members

Most Used — Admins

Related Guides