Discord Admin Guide
Managing OrbitKin in your Discord community
Admin Role Overview
As an OrbitKin admin, you're the bridge between users and developers. You help users navigate the system, manage matching cycles, handle reports, and escalate technical issues when needed.
What Admins Can Do
- • Start and manage matching cycles
- • Create and delete Orbit channels
- • Help users with registration issues
- • Collect and forward feedback
- • Handle user reports and conflicts
- • Moderate Orbit discussions
- • View registered and unmatched users
- • Escalate technical issues
Developer Only
- • Access user personal data directly
- • View questionnaire responses
- • Modify user profiles
- • Access database
- • Change system configuration
- • Export user data
- • View detailed analytics
- • Deploy bot updates
Quick Start Checklist
Read this guide completely
Understand your responsibilities
Locate the admin panel
Find admin controls in your server
Test matching preview
Understand the matching process
Review active Orbits
Check current group status
Learn user commands
Be able to help users
Know developer contact
For escalation: @skygorilla
Admin Commands
Matching Commands
| Command | Description |
|---|---|
ok!admin preview | Preview potential matches without creating Orbits |
ok!admin matchmake | Run full matching cycle for all unmatched users |
ok!admin rematch | Match only newly registered users since last cycle |
ok!admin listregistered | List all registered users (names & IDs) |
ok!admin listunmatched | List unmatched users ready for grouping |
Orbit Management
| Command | Description |
|---|---|
ok!admin orbit list | See all active Orbits with member counts |
ok!admin orbit info #channel | Get details about specific Orbit |
ok!admin orbit facilitation #channel [level] | Set facilitation level (none/low/medium/high) |
ok!admin orbit delete #channel | Remove an Orbit (requires confirmation) |
User Management
| Command | Description |
|---|---|
ok!admin user @user | View user's registration and Orbit status |
ok!admin remove @user | Remove user from their current Orbit |
ok!admin feedback | View recent user feedback submissions |
💡 All admin commands require appropriate permissions and are logged for security
Admin Panel Features
Matching Actions
- • Preview Match - See potential groups before creating
- • Execute Full Match - Create Orbits for all users
- • Execute Rematch - Match only new users
- • View Quality Scores - Check match compatibility
Analytics & Reports
- • User Statistics - Total registered/matched users
- • Orbit Health - Activity levels and engagement
- • Feedback Summary - Recent user feedback
- • Report Queue - User reports needing attention
Handling User Reports
Report Types & Actions
Harassment/Bullying
→ Document evidence, warn/mute user, consider Orbit removal
Spam/Advertising
→ Delete messages, warn user, escalate if repeated
Inappropriate Content
→ Remove content, warn user, potential temporary ban
Technical Issues
→ Document details, attempt basic troubleshooting, escalate to developer
Common Issues & Solutions
User can't complete questionnaire
- • Have them try
ok!registeragain - • Check if they're in the correct channel
- • Verify bot has proper permissions
- • If persistent, escalate to developer with user ID
Not enough users for matching
- • Minimum 4 users needed for one Orbit
- • Consider promotional activities
- • Wait for more registrations
- • Can adjust matching thresholds (developer only)
Orbit channel not created after matching
- • Check bot permissions (Manage Channels)
- • Verify category isn't full (50 channel limit)
- • Try manual channel creation
- • Report to developer with match details
Running a Matching Cycle
Recommended Process
- 1
Check pool size
Run
ok!admin listunmatchedto see available users - 2
Preview matches
Use
ok!admin previewto see potential groups and quality scores - 3
Execute matching
Run
ok!admin matchmaketo create Orbits - 4
Verify creation
Check
ok!admin orbit listto confirm channels were created - 5
Announce to community
Let users know new Orbits have been formed
💡 Tip: Schedule regular matching cycles (e.g., every Sunday) so users know when to expect matches
Best Practices
User Communication
- ✅ Be patient and understanding
- ✅ Direct users to help commands first
- ✅ Document recurring issues
- ✅ Maintain user privacy
- ✅ Never share questionnaire data
System Management
- ✅ Run matching cycles regularly
- ✅ Monitor Orbit activity weekly
- ✅ Clean up inactive Orbits monthly
- ✅ Review feedback promptly
- ✅ Keep documentation updated
Success Metrics
Track these metrics to measure OrbitKin's success in your community:
Registration Rate
% of members who register
Orbit Activity
Messages per week in Orbits
Retention
Users staying in Orbits
Need Developer Support?
For technical issues, data requests, or system configuration
When escalating, include:
• User ID(s) involved
• Exact error messages
• Steps already tried
• Screenshots if applicable
⚠️ Response time: 24-48 hours for non-critical issues