- Dhruv SethCreator & Engineer
ProMetricX
A gamified goal-tracking Discord bot for peer accountability.
- Role
- Creator & Engineer
- Status
- In progress
- Stack
Discord
discord.js
Node.js
Expressnode-cron
MongoDB
Mongoose
- Links
- Private
ProMetricX turns a Discord server into a place where members keep each other on track. Members set weekly goals and daily habits, earn or lose XP when they mark them done or missed, climb ranks from E to S, compete on leaderboards and get automatic reminders.
- Slash commands
- 30+
- Ranks
- E → S
- Weekly tasks required
- max(3, 2 + level)
ProMetricX
ProMetricX is a Discord bot that helps people stick to their goals using game mechanics and peer accountability. Members set weekly goals and daily habits, earn or lose XP when they mark them done or missed, level up through ranks from E to S, compete on leaderboards, and get automatic reminders.
The problem
Goals made in private are easy to drop. Habit apps track you alone, so there's no one to notice when you stop. ProMetricX puts goals where a community already spends its time — a Discord server — and adds stakes: progress is public, misses cost something, and the bar rises as you improve.
How it works
Members register with a slash command, then set weekly goals, daily habits (each with a morning, afternoon or evening reminder) and recurring daily goals that count toward a weekly target. Completing a task earns XP; failing one costs XP.
The game system
XP sets your level, and your level sets your rank: E → D → C → B → A → S.
Difficulty scales with you instead of staying flat:
required weekly tasks = max(3, 2 + level) # the weekly bar rises as you level
failure penalty = grows with your levelThe bot creates a colour-coded Discord role for each rank and assigns it automatically, so a member's rank is visible everywhere in the server. Each member gets a profile, progress bars, XP history, stats and weekly reports; the server gets a leaderboard and a public activity-feed channel.
Architecture
- Modular handlers. Commands, buttons, select menus and events are loaded automatically from their folders, so adding a feature means adding a file.
- One interaction router sends every slash command, modal, button and select menu to its handler.
- Game logic lives in the data models. Mongoose models for users and servers carry level and rank recalculation, penalty tiers, and history trimmed to the latest 50 entries.
- The XP engine and the scheduler are separate from the Discord-facing code, so the rules can change without touching command handlers.
Scheduling
All jobs run on IST via node-cron.
Features
- 30+ slash commands, plus interactive modals, buttons and select menus.
- XP, level and rank system with a scaling difficulty curve and failure penalties.
- Rank roles created and synced automatically, and server channels set up automatically.
- Scheduled reminders, broadcasts, weekly reports and resets.
- Rate limiting per user and per command, held in memory, with stricter limits for destructive or heavy commands.
- Admin tools — server setup, role sync and manual broadcast triggers.
- Express health-check endpoint so it can be deployed on cloud hosts.
Built with Node.js, discord.js v14, MongoDB and Mongoose, node-cron and Express, with slash commands deployed through the Discord REST API.
Built with
Nutrition tracking built for Indian food — not just calories.