EP (Effort Points) System

Track weekly effort points per player, assign rank quotas, run automated weekly resets, and post Discord reports.

Overview

The EP (Effort Points) System is designed for military, clan, roleplay, and competitive Roblox communities. It tracks weekly participation and activity points earned by group members, compares them against required rank quotas, and automates weekly reset reports to Discord.

Key Features

1. Rank Quotas & Player Tracking

Assign weekly EP quotas to each rank in your community (e.g. Recruit = 5 EP/week, Officer = 20 EP/week). The system tracks earned points in real-time and calculates whether each player has passed or failed their quota.

2. Player Excusal Management

If a player is on leave or excused for the week, toggle their Excused state from the dashboard or Discord bot. Excused members are marked with a special status in weekly reports and will not be penalized for missed quotas.

3. Discord Bot Commands

Staff members can log points directly inside Discord using slash commands like /ep add username amount or check member status with /ep view username.

4. Automated Weekly Reset & Webhook Summaries

Configure a recurring reset day and UTC time (e.g. Every Monday at 00:00 UTC). When the reset fires, ShadowConfig evaluates all members, archives weekly totals, resets counters, and posts a comprehensive pass/fail summary embed to your configured Discord webhook.

Data Store Storage

All EP data is persisted in your game's own Roblox DataStore via Open Cloud. To learn how to browse raw DataStores, view the DataStore Explorer Documentation.