Professional Time Tracking for Discord

Complete employee time management with automated overtime alerts, detailed reporting, and multi-language support. Perfect for remote teams, gaming communities, and businesses.

Add to Discord Learn More

🚀 Key Features

⏰

Smart Clock System

One-click clock in/out with automatic role management and real-time tracking. Perfect for work shifts and activity monitoring.

🔔

Overtime Alerts NEW

Automated reminders when users work too long. Configurable thresholds with notifications to both users and admins.

📊

Detailed Reports

Track total hours, view active workers, and generate comprehensive time reports for individuals or teams.

🛠️

Admin Controls

Force clock-outs, adjust time records, reset users, and manage all aspects of time tracking with powerful admin tools.

🌍

Multi-Language

Full support for English and Spanish with more languages coming. Switch locales instantly with simple commands.

🔒

Role-Based Security

Granular permission system with separate roles for admins, workers, and members. Complete access control.

📋 Prerequisites

Important: You need Administrator permissions in your Discord server to configure the bot.

Grant the bot these permissions: Send Messages, Manage Roles, Use Slash Commands
Ensure the Clock.CoreBots role is positioned above your working and member roles in server settings
The bot needs access to your chosen update channel

⚙️ Initial Configuration

Set up your server with the /config command:

/config update_channel:#activity-logs working_role:@Working admin_role:@Manager member_role:@Verified

update_channel

Where clock-in/out notifications are posted

working_role

Role automatically assigned when users clock in

admin_role

Role authorized to use management commands

member_role

Role permitted to clock in (e.g., Verified, Employee)

🔔 Overtime Reminder Setup NEW

Configure automated overtime alerts to promote healthy work habits and compliance:

/reminder-config enabled:True hours:8 channel:#overtime-alerts

Smart Reminders: The system sends DMs to users and notifications to admins when someone works beyond the configured threshold. Reminders are limited to once per hour to prevent spam.

Reminder Configuration Options

enabled: Turn reminders on/off (default: off)
hours: Threshold before sending alerts (1-24 hours, default: 8)
channel: Optional dedicated channel for admin notifications

Examples:

# Enable with 6-hour threshold
/reminder-config enabled:True hours:6

# Disable reminders
/reminder-config enabled:False

# Use specific admin channel
/reminder-config enabled:True hours:10 channel:#hr-alerts

📱 Daily Usage

/clock

Display the main time tracking panel with all interactive buttons

/setlocale

Switch server language between English (en) and Spanish (es)

User Actions (via buttons)

Clock In/Out: Start and end work sessions with automatic role assignment
List Working: See who's currently clocked in and for how long
My Total Time: View your personal time statistics
Admin Panel: Access management tools (admin role required)

🛠️ Admin Features

Comprehensive management tools available through the Admin Panel:

Force Clock-Out

Manually clock out users who forgot or are experiencing issues

Adjust Time

Add or subtract minutes from user sessions for corrections

Reset Records

Clear individual user data or reset all records for fresh starts

Total Reports

View comprehensive time reports for all users with sorting

🌍 Localization

Full multi-language support with instant switching:

# Switch to Spanish
/setlocale es

# Switch to English  
/setlocale en

All interface elements, notifications, and error messages are translated. More languages coming soon!

❓ Frequently Asked Questions

Q: I don't see the slash commands after inviting the bot?: Ensure the bot was invited with the applications.commands scope and has Use Slash Commands permission. Try refreshing Discord or re-inviting the bot.
Q: Can regular members use the time tracking features?: Yes! Only /config, /reminder-config, and /setlocale require admin permissions. All users with the configured member role can clock in/out and view their time.
Q: What happens if I misconfigure the roles or channels?: Simply run /config again with the correct settings. The bot will update the configuration immediately.
Q: Why do I get "interaction failed" when using buttons?: This typically happens after bot updates. Send a new /clock command to refresh the buttons with the latest functionality.
Q: Role assignment isn't working - what's wrong?: Check that the Clock.CoreBots role is positioned above your working and member roles in Server Settings → Roles. Discord requires proper role hierarchy for management.
Q: How do overtime reminders work exactly?: When enabled, the bot checks every 5 minutes for users exceeding the configured threshold. It sends a DM to the user and posts in the admin channel. Reminders are limited to once per hour per user to prevent spam.
Q: Can I customize the reminder messages?: Currently, messages use the server's configured language (English/Spanish). Custom message templates are planned for a future update.
Q: What data does the bot store?: The bot stores clock-in/out times, user IDs, guild configuration, and reminder timestamps. No personal information beyond Discord IDs is collected.

🆘 Support & Updates

Having issues? Need help? Here's how to get support:

Check this guide first - most issues are covered in the FAQ
Verify permissions - ensure proper role hierarchy and bot permissions
Test with a fresh /clock command - this refreshes button interactions
Contact support - reach out to CoreBots.Guru for technical assistance

Pro Tip: Join our support server for real-time help, feature announcements, and community tips from other server administrators.