Premium Commands

Complete reference for all Premium, Pro, and Lifetime commands available in Clocky. Upgrade to unlock these powerful features.

Subscription Management

Dashboard Subscription

Manage your subscription via the web dashboard at dashboard.clockybot.com.

How to subscribe:

Go to dashboard.clockybot.com
Log in with Discord
Select your server
Navigate to Subscription
Choose your plan and complete payment

Available tiers:

Free: 5 users, 1 year retention
Premium ($4.99/month): 100 users, 5 years retention, all premium features
Pro ($9.99/month): Unlimited users, 10 years retention, all premium features
Lifetime ($149.99 one-time): Unlimited everything, API access, audit trail, custom branding, dedicated support

`/billing`

View current subscription details.

/billing

Description: Shows your server's current subscription tier and usage statistics.

Cooldown: 30 seconds

Shows:

Current subscription tier
Active user count vs limit
Data retention period
Subscription status

Example response:

💳 Billing Information

Tier: Premium (Monthly)
Status: Active

Usage:
- Active users: 18 / 100
- Data retention: 5 years
- Rate limits: 120 commands/min

Visit dashboard.clockybot.com to manage your subscription.

Notes:

View-only command showing current status
Use the web dashboard to upgrade, downgrade, or manage billing

Advanced Analytics

Premium/Pro/Lifetime only: These commands require an active paid subscription.

`/analytics server`

View comprehensive server-wide work statistics and trends.

/analytics server range:month

Parameters:

range (optional): Time period - week, month, quarter, year, or all-time (default: month)

Description: Displays detailed server-wide analytics including total hours worked, average session duration, peak activity times, user participation rates, and trend comparisons.

Cooldown: 30 seconds

Shows:

Total hours worked (server-wide)
Active user count
Average session duration
Longest session
Peak activity hours
Day-of-week breakdown
Trend comparison vs previous period
Top contributors (opted-in users only)

Example response:

📊 Server Analytics (This Month)

Total worked: 1,247 hours 30 minutes
Active users: 18 / 100
Sessions: 324
Average session: 3 hours 51 minutes
Longest session: 9 hours 15 minutes

Trend: ↑ 12.5% vs last month

Peak activity:
- Monday 9-11 AM: 12 users
- Thursday 2-4 PM: 11 users

Day breakdown:
Monday:    254h (20.4%)
Tuesday:   241h (19.3%)
Wednesday: 235h (18.8%)
Thursday:  267h (21.4%)
Friday:    250h (20.1%)

Top contributors (opted-in):
1. @alice - 87h 30m
2. @bob - 76h 15m
3. @charlie - 64h 45m

Use cases:

Track team productivity trends
Identify peak collaboration times
Monitor workload distribution
Generate monthly reports
Spot burnout patterns

See Advanced Analytics for detailed documentation.

`/analytics user`

View detailed analytics for a specific user (admin only).

/analytics user:@username range:quarter

Parameters:

user (required): Discord user to analyze
range (optional): Time period - week, month, quarter, year, or all-time (default: month)

Description: Provides deep insights into individual user work patterns including session frequency, average hours per day, consistency score, break patterns, and productivity trends.

Cooldown: 30 seconds

Requires: Manage Server permission

Shows:

Total hours worked
Session count and frequency
Average hours per day
Consistency score (regularity of work hours)
Common work hours (heat map)
Break usage patterns
Trend vs previous period
Longest streak (consecutive days)

Example response:

📊 User Analytics for @alice (This Quarter)

Total worked: 487 hours 45 minutes
Sessions: 124
Days active: 62 / 90
Average per day: 7 hours 52 minutes
Consistency score: 87/100 (Very consistent)

Work patterns:
Most active: Monday-Thursday
Typical hours: 8:30 AM - 6:00 PM
Lunch break: Usually 12:00-1:00 PM

Trends:
↑ Hours: +8.3% vs last quarter
↑ Sessions: +12 sessions
→ Avg duration: 3h 56m (no change)

Longest streak: 14 days (Jan 5-18)
Break usage: 58 hours total (11.9% of work time)

Privacy note: User is notified when admins view detailed analytics.

Export Features

Premium/Pro/Lifetime only: Data export features require an active paid subscription.

`/export server-stats`

Export server-wide statistics to CSV or JSON.

/export server-stats range:month format:csv

Parameters:

range (required): Time period - week, month, quarter, year, or all-time
format (optional): Export format - csv or json (default: csv)

Description: Generates a downloadable file with comprehensive server statistics including all sessions, users, and aggregate data for the specified time period.

Cooldown: 5 minutes

CSV includes:

Date, User ID, Username
Session start/end times
Duration (hours:minutes)
Break time
Net worked time
Server name

JSON includes:

All CSV data plus:
Session IDs
Timezone information
Metadata (export date, query params)

Example response:

📥 Server Statistics Export

Generating export for March 2025...

Sessions: 324
Users: 18
Date range: March 1-31, 2025
Format: CSV
File size: 42 KB

[Download Export]

Export expires in 24 hours.

Use cases:

Payroll processing
Monthly reporting
External analytics tools
Compliance audits
Backup records

Notes:

Respects user privacy (only exports data from opted-in users for leaderboards)
Files expire after 24 hours
Download link sent via DM (if DMs enabled)
Large exports may take 1-2 minutes to generate

See Data Export for detailed documentation.

`/export user-report`

Generate a detailed work report for a specific user (admin only).

/export user-report user:@username range:year format:pdf

Parameters:

user (required): Discord user to generate report for
range (required): Time period - month, quarter, year, or all-time
format (optional): Export format - pdf, csv, or json (default: pdf)

Description: Creates a comprehensive, formatted work report for an individual user including statistics, charts, session history, and trend analysis.

Cooldown: 5 minutes

Requires: Manage Server permission

PDF report includes:

Cover page with summary statistics
Monthly breakdown chart
Session history table
Break usage analysis
Productivity trends
Comparison to server average

CSV/JSON includes:

Raw session data
All timestamps
Break records
Calculated metrics

Example response:

📊 User Report Generated

User: @alice
Period: January 1 - December 31, 2024
Format: PDF
Pages: 8
File size: 1.2 MB

Summary:
- Total hours: 1,847h 30m
- Sessions: 486
- Average: 7h 52m/day

[Download Report]

Report expires in 7 days.
User has been notified.

Use cases:

Annual performance reviews
Contractor invoicing
Work verification letters
Personal records for user
Dispute resolution

Privacy note: User is notified when admin generates their report and receives a copy.

Premium Benefits Summary

What you get with paid tiers

Premium tier ($4.99/month or $49.99/year):

100 active users
5 years data retention
2x higher rate limits (120/min vs 60/min)
50% faster command cooldowns
Projects and work types
Session editing
Priority support (24-hour SLA)
Beta program access
/analytics server - Server-wide analytics
/analytics user - Individual user analytics
/export server-stats - Bulk data export
/export user-report - Formatted user reports

Pro tier ($9.99/month or $99.99/year):

Unlimited active users
10 years data retention
3x higher rate limits (180/min vs 60/min)
50% faster command cooldowns
All Premium features
Unlimited projects and work types

Lifetime tier ($149.99 one-time):

Unlimited active users
Unlimited data retention
5x higher rate limits (300/min vs 60/min)
50% faster command cooldowns
All Pro features PLUS:
API access
Full audit trail
Custom branding
Dedicated support (4-hour SLA)

Lifetime-only features

Lifetime tier includes everything in Pro plus:

Unlimited retention: Keep data forever
API access: REST API for custom integrations
Audit trail: Complete modification history for compliance
Custom branding: Customize bot messages
Dedicated support: 4-hour response SLA

Upgrade Today

View All Premium Features

Pricing & Subscription Details

Quick Reference

Analytics Commands (Premium/Pro/Lifetime)

/analytics server range:month         # Server analytics
/analytics user:@alice range:quarter  # User analytics

Export Commands (Premium/Pro/Lifetime)

/export server-stats range:year format:csv      # Server export
/export user-report user:@alice range:month format:pdf  # User report

Frequently Asked Questions

How do I subscribe?

Visit dashboard.clockybot.com, log in with Discord, select your server, and navigate to Subscription.

Can I upgrade mid-cycle?

Yes! Upgrades take effect immediately. You'll be charged a prorated amount.

What happens if I hit the user limit?

New users cannot check in until you upgrade or inactive users are removed. Existing users continue working normally.

Can I downgrade?

Yes. Downgrades take effect at the end of your current billing period.

Is there a discount for annual billing?

Yes! Annual billing saves 17%:

Premium: $49.99/year (vs $59.88/year monthly)
Pro: $99.99/year (vs $119.88/year monthly)

What's the difference between Pro and Lifetime?

Pro is a subscription with 10-year retention. Lifetime is a one-time payment with unlimited retention plus exclusive features (API, audit trail, custom branding).

User Commands

Admin Commands

Premium Features Detail

Subscription Management