ActivityBot — Discord Automation Made Easy

✨ Key Features

💰 Automated Payroll

Automatic hour tracking, paycheck calculations, and scheduled payroll resets. Configure pay rates by rank with customizable hour caps.

📊 Activity Tracking

Real-time monitoring of officer activity with automatic inactivity strike system. LOA exemptions included.

📋 Training Checklists

Comprehensive FTO and Cadet training checklist management. Track training progress with organized sections.

⚙️ Easy Configuration

Web-based dashboard for admins to manage ranks, roles, permissions, and payroll settings without commands.

🔔 Scheduled Automation

Automatic hour archiving and payroll resets on daily, weekly, biweekly, or monthly schedules.

📈 Comprehensive Reports

Detailed payroll history with individual payment tracking and server-wide totals.

🖥️ Web Dashboard

ActivityBot includes a powerful web-based dashboard accessible at the top-right of any channel after running /setupchannels.

📱 Dashboard Tabs

🏠 Dashboard

Real-time Statistics: Total members, strikes, active/inactive officers
Countdown Timer: View time until next payroll reset (top-right header)
Activity Table: View all officers with their activity hours, strikes, and status
Search & Filter: Search by nickname/ID, filter by active/inactive/strikes
Strike Management: View disciplinary and inactivity strikes with reasons

💵 Salary Settings

Configure Pay Rates: Set hourly pay rate for each rank/role
Hour Cap: Define maximum billable hours per payroll period
Current Rates Table: View all configured pay rates at a glance

📊 Payroll History

Payroll Periods: View historical payroll data by period
Server Totals: See total amount paid server-wide per period
Individual Payments: Track individual officer payments and bonuses
Payment Details: Expandable view showing who was paid and how much

⚙️ Settings (Admin)

Rank Structure: Define your server's rank hierarchy
Allowed Roles: Control which roles can access the dashboard (non-admin)
Minimum Payroll Rank: Set the minimum rank eligible for payroll processing
Role Management: Add/remove roles with drag-and-drop ordering

📋 Training Checklist

Cadet Checklist: Create and manage training requirements for cadets
FTO Checklist: Define Field Training Officer evaluation criteria
Organized Sections: Group related requirements into logical sections
Edit & Delete: Modify checklist items with built-in editors
Progress Tracking: View completion status through officer modals

⌨️ Bot Commands

/setupchannels

Creates all required channels and interactive buttons for the bot.

Usage: /setupchannels

Permissions: Administrator + Manage Channels

Note: This is the first command you should run. It creates the Activity-Panel with the dashboard link.

/inactivitystrike

Adds inactivity strikes to users who didn't meet minimum hours. Users with the LOA role are automatically exempt.

Usage: /inactivitystrike

Permissions: Allowed Roles (configured in dashboard)

⚠️ Important: Create a role named LOA in your server for this command to work properly. Users with this role will be exempt from inactivity strikes.

/setpayrollschedule

Configures automatic hour archiving and payroll resets on a schedule.

Usage: /setpayrollschedule

Options:

Period: Daily, Weekly, Biweekly, or Monthly
Time: When the reset should occur
Day: Required for weekly/biweekly/monthly periods

Permissions: Administrator only

⚠️ Warning: For weekly, biweekly, and monthly periods, you MUST select a day or automatic resets will not work.

Note: The countdown to next reset is visible in the dashboard header (top-right).

/addclockinserver

Links your server to ClockInBot for automatic hour archiving and payroll resets. Required for automatic reset functionality.

Usage: /addclockinserver [Server ID] [Codeword] [Username] [Password]

Parameters:

Server ID: Your ClockInBot server ID
Codeword: Authentication codeword from ClockInBot
Username: API username (created via /register apiuser on ClockInBot)
Password: API password (created via /register apiuser on ClockInBot)

Permissions: Administrator only

Prerequisites: Must have ClockInBot installed and configured

⚠️ Critical: Using an incorrect codeword will prevent automatic resets. The bot will notify you if the connection is successful and display the current codeword. Both this command AND /setpayrollschedule must be completed for automatic resets to work.

/totalpayrollpaid

Displays the total payroll paid for the current period.

Usage: /totalpayrollpaid

Permissions: Minimum Payroll Rank (configured in dashboard)

🛠️ Complete Setup Guide

Step 1: Initial Bot Setup

Invite the Bot
Use the invite link at the top of this page to add ActivityBot to your server.
Run /setupchannels
This command creates all necessary channels including:
- Activity-Panel — Contains the dashboard link and information
- Other management channels with interactive buttons

Step 2: Configure Server Settings

Access the Dashboard
Click the dashboard link in the Activity-Panel channel.
Navigate to Settings Tab
Configure the following:
- Rank Structure: Add roles in hierarchical order (highest to lowest)
- Allowed Roles: Select non-admin roles that should have dashboard access
- Minimum Payroll Rank: Set the minimum rank eligible for payroll

Step 3: Configure Payroll

Go to Salary Settings Tab
- Select each role and set its hourly pay rate
- Configure the payroll hour cap (default: 10 hours)
- Verify all rates in the current pay rates table

Step 4: Create LOA Role

Create a Discord Role
In your server settings, create a role named exactly LOA (Leave of Absence).
Assign as Needed
Users with this role will be exempt from inactivity strikes when you run /inactivitystrike.

Step 5: Optional - Training Checklists

Navigate to Training Checklist Tab
- Add cadet training requirements organized by sections
- Add FTO evaluation criteria organized by sections
- Edit or delete items as needed

Step 6: Automatic Payroll Reset (Requires ClockInBot)

Note: To enable automatic hour archiving and payroll resets on a schedule, you must integrate with ClockInBot. This is the only way to enable automatic resets.

⚠️ Required: Both steps below MUST be completed for automatic resets to work.

Step A: Link Clock-In System
1. First, invite ClockInBot to your server
2. Run /register apiuser on ClockInBot to create API credentials (username/password)
3. Run /addclockinserver [Server ID] [Codeword] [Username] [Password] on ActivityBot
4. Bot will confirm successful connection and display the current codeword
Step B: Set Payroll Schedule
1. Run /setpayrollschedule on ActivityBot
2. Select period (daily/weekly/biweekly/monthly)
3. Select time
4. Important: Select a day for weekly/biweekly/monthly periods

Important: Skipping either step will prevent automatic resets from functioning.

⚠️ Important Reminders:

The LOA role must be created for /inactivitystrike to work
Days must be selected for weekly/biweekly/monthly schedules
Incorrect codewords will prevent automatic resets
The countdown timer shows time until next reset in the dashboard header

🎯 Feature Highlights

Dashboard Features

Interactive Statistics: Click stat cards to filter officers (Total Members, Active, Inactive, With Strikes)
Real-time Search: Instantly filter officers by nickname or user ID
Strike Tracking: View both disciplinary strikes and inactivity strikes with reasons
Visual Indicators: Color-coded badges for different strike types and statuses
Countdown Timer: Always visible timer showing next payroll reset

Payroll Management

Flexible Pay Rates: Set different rates for each rank/role
Hour Caps: Prevent overpayment with configurable hour limits
Automatic Archiving: Historical payroll data saved for every period
Detailed History: View who was paid, when, and how much
Bonus Tracking: Record and track bonus payments separately

Training System

Dual Checklists: Separate checklists for Cadets and FTOs
Organized Sections: Group related training items logically
Easy Editing: Modify questions and sections with built-in modals
Progress Tracking: View training completion through officer profiles

Security & Permissions

Role-Based Access: Control who can access which features
Admin Controls: Sensitive settings require administrator permissions
Allowed Roles: Grant dashboard access to trusted non-admin roles
Minimum Rank Gates: Restrict payroll processing to specific ranks

⚡ ActivityBot

🚀 Discord Automation Made Simple