Discord Commands Reference

Complete reference for all Loyalteez Discord bot commands.

User Commands

Commands available to all server members.

DM Support

Some commands work in Direct Messages with the bot:

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

Core Commands

Command	Description	Example
`/join`	Claim one-time welcome bonus	`/join`
`/daily`	Claim daily check-in reward (resets midnight UTC)	`/daily`
`/balance`	Check your LTZ balance (works in DMs)	`/balance`
`/help`	View all available commands	`/help`

Engagement Commands

Command	Description	Example
`/streak`	View streak status and claim milestones	`/streak`
`/voice`	Check voice time progress	`/voice`
`/voice claim`	Claim earned voice reward (ephemeral)	`/voice claim`
`/leaderboard`	View server rankings	`/leaderboard metric:ltz_earned`
`/roles`	View loyalty roles and their benefits	`/roles`

Voice Command Privacy

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

Perk Commands

Command	Description	Example
`/perks`	Browse available perks	`/perks`
`/perk-buy`	Purchase a perk with LTZ	`/perk-buy perk:VIP Access`
`/buy-role`	Purchase a role-linked perk	`/buy-role role:@VIP`

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`	View setup wizard or connection status	Full Admin
`/setup wizard`	Show guided setup wizard	Full Admin
`/setup connect brand_id:ADDRESS security_key:KEY`	Connect server to brand (requires Security Key)	Full Admin
`/setup status`	Check server connection status	Full Admin
`/setup check`	Run permission audit	Full Admin
`/setup disconnect confirm:DISCONNECT`	Disconnect from Loyalteez	Full Admin

Configuration Commands

Command	Description	Permission
`/config`	View current configuration	Viewer+
`/config events`	List/create/edit/delete events	Event Manager+
`/config reward EVENT AMOUNT`	Quick reward adjustment	Event Manager+
`/config stacking MODE`	Set role effect stacking	Full Admin
`/config streaks`	Configure streak settings	Full Admin
`/config voice`	Configure voice rewards	Full Admin
`/config third-party`	Third-party bot integrations	Full Admin
`/config role-bonus`	Configure role multipliers	Full Admin
`/config admin-roles`	Manage admin permissions	Full Admin
`/config admin-channel`	Set notification channel	Full Admin
`/config channels`	Include/exclude channels	Full Admin
`/config user`	Enable/disable users	Full Admin
`/config test-mode`	Enable/disable test mode	Full Admin

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

Create perk example:

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

Engagement Tools

Command	Description	Permission
`/drop`	Create button or reaction drop	Event Manager+
`/watch start channel:#CH [event:EVENT] [emoji:E] [reward:N]`	Auto-create drops for every message in a channel	Event Manager+
`/watch stop channel:#CH`	Stop watching a channel	Event Manager+
`/watch list`	List all watched channels	Event Manager+
`/reward`	Manually reward a user	Configured roles

Drop examples:

/drop event_id:announcement_reward label:"Claim!"
/drop event_id:news_tracker type:reaction message_id:123456 emoji:🎉 lifespan:2h

Channel watch examples:

/watch start channel:#announcements
/watch start channel:#news event:news_tracker emoji:📰 reward:10
/watch stop channel:#announcements
/watch list

Analytics Commands

Command	Description	Permission
`/stats`	Weekly overview	Viewer+
`/stats period:day`	Daily stats	Viewer+
`/stats breakdown:events`	Event breakdown	Viewer+
`/audit`	Recent 25 audit events	Viewer+
`/audit user:@user`	Filter by user	Viewer+
`/audit export:true`	Export as CSV	Viewer+
`/export type:rewards`	Export reward history	Viewer+
`/segments`	View user segments	Viewer+

KPI Commands

Basic KPI Management:

Command	Description	Permission
`/kpi set metric:NAME target:N period:WEEK`	Set KPI target with period	Event Manager+
`/kpi list`	View all configured KPIs	Viewer+
`/kpi report`	View KPI performance report	Viewer+
`/kpi remove metric:NAME`	Remove a KPI target	Event Manager+
`/kpi enable metric:NAME`	Activate a KPI	Event Manager+
`/kpi disable metric:NAME`	Deactivate a KPI	Event Manager+
`/kpi export format:CSV`	Export KPI data (CSV/JSON)	Event Manager+

Alert Configuration:

Command	Description	Permission
`/kpi alert-config metric:NAME`	View alert configuration	Event Manager+
`/kpi alert-config metric:NAME threshold:80 frequency:DAILY severity:WARNING`	Configure alerts	Event Manager+
`/kpi alert-config metric:NAME channel:#alerts escalation_days:3`	Set alert channels and escalation	Event Manager+

Period Comparisons:

Command	Description	Permission
`/kpi compare`	View all period comparisons	Event Manager+
`/kpi compare set metric:NAME baseline_start:YYYY-MM-DD baseline_end:YYYY-MM-DD`	Set baseline period	Event Manager+
`/kpi compare disable metric:NAME`	Disable comparison	Event Manager+

Compound Alerts (Multi-Condition):

Command	Description	Permission
`/kpi compound-alert create name:"Alert Name" conditions:"dau<100,streak<50" logic:AND`	Create multi-condition alert	Event Manager+
`/kpi compound-alert list`	List all compound alerts	Event Manager+
`/kpi compound-alert view name:"Alert Name"`	View alert details	Event Manager+
`/kpi compound-alert remove name:"Alert Name"`	Remove compound alert	Event Manager+
`/kpi compound-alert toggle name:"Alert Name" enable:true`	Enable/disable alert	Event Manager+
`/kpi compound-alert history`	View alert trigger history	Event Manager+

Custom Metrics (Formula-Based):

Command	Description	Permission
`/kpi custom-metric create name:"Engagement Score" formula:"(dau0.6)+(wau0.4)"`	Create custom metric	Event Manager+
`/kpi custom-metric list`	List all custom metrics	Event Manager+
`/kpi custom-metric view name:"Metric Name"`	View metric details	Event Manager+
`/kpi custom-metric edit name:"Metric Name" formula:"new formula"`	Edit custom metric	Event Manager+
`/kpi custom-metric remove name:"Metric Name"`	Remove custom metric	Event Manager+
`/kpi custom-metric test formula:"dau*2"`	Test formula without creating	Event Manager+

Presets & Templates:

Command	Description	Permission
`/kpi preset list`	List available presets	Event Manager+
`/kpi preset view name:"Preset Name"`	View preset details	Event Manager+
`/kpi preset apply name:"Preset Name"`	Apply a preset to server	Event Manager+
`/kpi preset create name:"My Preset" description:"..."`	Save current config as preset	Event Manager+
`/kpi preset remove name:"Preset Name"`	Remove a preset	Event Manager+

Role-Based Alert Routing:

Command	Description	Permission
`/kpi role-alerts set severity:CRITICAL role:@Admin channel:#alerts`	Route alerts to roles/channels	Event Manager+
`/kpi role-alerts list`	View role alert configuration	Event Manager+
`/kpi role-alerts remove severity:CRITICAL`	Remove role alert routing	Event Manager+

Available KPI Metrics:

daily_active_users - Users who claimed rewards today
weekly_active_users - Users active this week
streak_retention - % of users maintaining streaks
new_user_conversion - % of new users who engage
voice_participation - % of users using voice
reward_efficiency - Average LTZ per user
churn_rate - % 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
time_to_first_reward_pct - % rewarded within first day
repeat_event_rate - Average events per rewarded user
repeat_event_rate_pct - % triggering 3+ events
avg_streak_length - Average streak length
streak_break_frequency - % of streaks that break

Reports Commands

Command	Description	Permission
`/reports`	View report configuration	Viewer+
`/reports schedule frequency:WEEKLY`	Schedule automated reports	Event Manager+
`/reports disable`	Disable scheduled reports	Event Manager+

Diagnostic Commands

Command	Description
`/test all`	Full diagnostic suite
`/test connectivity`	Test service connections
`/test permissions`	Check bot permissions
`/test config`	Validate configuration
`/test reward event:EVENT`	Dry-run reward pipeline

Quick Reference Card

Most Used Commands

For Members:

/daily          - Daily check-in
/balance        - Check LTZ balance
/streak         - View streak status
/perks          - Browse perks
/leaderboard    - See rankings

For Admins:

/config events                    - View all events
/config reward daily_checkin 5    - Change reward amount
/watch start channel:#news        - Auto-drop on every message
/drop event_id:EVENT              - Create a one-off drop
/reward user:@user amount:100     - Manual reward
/stats                            - View analytics

Need Help?

Configuration Guide - Detailed /config options
Troubleshooting - Common issues and fixes

User Commands​

DM Support​

Core Commands​

Engagement Commands​

Perk Commands​

Admin Commands​

Permission Levels​

Setup Commands​

Configuration Commands​

Perk Management​

Engagement Tools​

Analytics Commands​

KPI Commands​

Reports Commands​

Diagnostic Commands​

Quick Reference Card​

Most Used Commands​

Need Help?​