Skip to main content

Admin Commands Reference

TL;DR

All 17 admin commands at a glance.

Quick Reference​

CommandDescriptionExample
/setupConnect, configure, and audit your server/setup connect brand_id:123 security_key:abc
/configManage events, roles, multipliers, and integrations/config events
/programConfigure reward program via guided wizard/program show
/dropCreate a button or reaction drop/drop event_id:42
/reaction-dropAttach a reaction reward to an existing message/reaction-drop message_id:123 emoji:⭐ reward:50
/rewardManually reward a user/reward user:@Alice event_id:5
/watchAuto-create drops for new messages in a channel/watch start channel:#general
/statsServer health dashboard/stats period:month
/auditTransaction audit log/audit user:@Bob export:true
/kpiConfigure and view KPI tracking/kpi set metric:dau target:500
/reportsSchedule automated reports/reports schedule
/segmentsView user segments/segments list
/exportExport data to CSV/export type:csv
/perkCreate and manage community perks/perk create
/milestoneCreate milestone role rewards/milestone create role:@VIP name:Top Contributor
/queueView and manage the reward distribution queue/queue status
/testRun diagnostic tests/test all

Setup & Configuration​

/setup​

Connect your server to Resonance and manage the integration lifecycle.

Subcommands:

  • connect brand_id:<ID> security_key:<KEY> — Link the server to your Resonance brand account.
  • status — View the current connection status, brand linkage, and sync health.
  • check — Audit bot permissions and surface any missing channel or role access.
  • wizard — Launch the guided setup walkthrough for first-time configuration.
  • disconnect confirm:DISCONNECT — Permanently remove the server connection. The confirm value must be the literal string DISCONNECT.
/setup connect brand_id:8821 security_key:sk_live_xxxx

/config​

Manage core server configuration including reward events, admin roles, and integrations.

Subcommands:

  • events — Create, edit, list, toggle, or delete reward events.
  • admin-roles — Add or remove roles that have access to admin commands.
  • multiplier — Set a server-wide reward multiplier applied to all events.
  • third-party — Enable or disable third-party bot integration (e.g. MEE6, Tatsu).
  • test-mode — Toggle test mode; rewards are calculated but not distributed (dry run).
  • notification-channel — Set the channel where the bot posts notifications and drops. Also syncs to the Partner Portal so scheduled reports and program alerts use the same channel.
/config notification-channel channel:#bot-alerts

/program​

Configure your reward program through a guided modal wizard. Sets budget, tolerance, reward split, and category weights.

Subcommands:

  • show — Display the current program configuration and status.
  • migrate — Generate a migration proposal to transition from manual event config to program-managed rewards.
  • advanced — Access advanced program tuning options.
  • disable — Turn off program-managed rewards and revert to manual event configuration.

Running /program with no subcommand launches the setup wizard — a two-step modal that walks through budget and category weight configuration.

/program show

Rewards & Drops​

/drop​

Create a drop — a button or reaction widget posted in a channel that users can claim for rewards.

Options:

  • event_id:<ID> (required) — The reward event to attach to the drop.
  • label:<text> — Button label text.
  • description:<text> — Embed description shown above the button.
  • emoji:<emoji> — Emoji displayed on the button or used for reaction drops.
  • lifespan:<minutes> — How long the drop stays active before expiring.
  • max_claims:<number> — Maximum number of users who can claim the drop.
/drop event_id:42 label:Claim Reward emoji:🎁 lifespan:60 max_claims:100

/reaction-drop​

Attach a reaction reward to an existing message. Users who react with the specified emoji receive the reward.

Options:

  • message_id:<ID> (required) — The ID of the target message.
  • emoji:<emoji> (required) — The reaction emoji to monitor.
  • reward:<amount> (required) — The point amount awarded per reaction.
/reaction-drop message_id:1187340021 emoji:⭐ reward:25

/reward​

Manually grant a reward to a specific user outside of an event flow.

Options:

  • user:<@user> (required) — The user to reward.
  • event_id:<ID> (required) — The event to credit the reward against.
  • amount:<number> — Override the event's default reward amount.
  • reason:<text> — Internal note logged with the transaction.
/reward user:@Alice event_id:5 amount:200 reason:Community spotlight winner

/watch​

Monitor a channel and automatically create drops whenever a new message is posted.

Subcommands:

  • start channel:<#channel> — Begin watching a channel. Options: event, emoji, reward.
  • stop — Stop watching the active channel.
  • list — View all channels currently being watched and their configurations.
/watch start channel:#announcements event:14 emoji:🔔 reward:10

Analytics & Management​

/stats​

Display a server health dashboard covering activity, reward distribution, and engagement trends.

Options:

  • period:<week|month|all> — Time window for the report (default: week).
/stats period:month

/audit​

Browse the full transaction audit log with filtering and export support.

Options:

  • user:<@user> — Filter transactions to a specific user.
  • event:<ID> — Filter by event.
  • export:<true|false> — Download results as a CSV attachment.
/audit user:@Bob event:5 export:true

/kpi​

Configure key performance indicators and set up alerting thresholds.

Subcommands:

  • set metric:<name> target:<value> — Define a KPI target (e.g. dau, retention_7d, drop_claims).
  • view — Display current KPI values against configured targets.
  • alerts — Manage alert channels and notification thresholds.
/kpi set metric:dau target:500

/reports​

Schedule automated reports to be delivered to a designated channel on a recurring basis.

/reports schedule

/segments​

View pre-built user segments to understand community composition and identify engagement opportunities.

Segments available: whales, power_users, new_users, at_risk, dormant.

/segments list

/export​

Export server data to a downloadable file.

Options:

  • type:<csv> (required) — File format for the export.
/export type:csv

Management​

/perk​

Create and manage community perks that users can redeem with their points.

Subcommands:

  • create — Define a new perk with a name, cost, and optional role or asset reward.
  • edit — Update an existing perk's details or cost.
  • list — View all active and inactive perks.
  • delete — Remove a perk permanently.
/perk create

/milestone​

Configure milestone rewards that are automatically granted when users meet progression criteria.

Subcommands:

  • create role:<@role> name:<name> — Create a new milestone linked to a Discord role reward.
  • add-criteria — Attach point, streak, or event-count criteria to an existing milestone.
  • list — View all configured milestones and their completion rates.
/milestone create role:@VIP name:"Top Contributor"

/queue​

Inspect and manage the reward distribution queue.

Subcommands:

  • status — View pending, processing, and failed queue entries.
  • retry — Re-attempt delivery of failed reward transactions.
  • unstick — Force-release a transaction that is stuck in a processing state.
/queue status

/test​

Run diagnostic tests to verify that the bot is operating correctly in this server.

Subcommands:

  • all — Run the full diagnostic suite.
  • permissions — Check that the bot has required permissions in all configured channels.
  • events — Verify that all active reward events are correctly configured.
  • connectivity — Test the connection between Discord and the Resonance API.
/test all
note

User-facing commands (/balance, /daily, /streak, /cooldowns, /milestones, /perks, etc.) are documented in the User Guide.

Last updated on