Leaderboards
SkillDocs & knowledgeNotes the leaderboard export/import conventions in src/utils/functions/economy/top.ts, including how global vs guild scope is selected. Use when adding a new leaderboard or modifying existing top/leaderboard functions.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Leaderboards skill
What this skill tells your AI
The instructions your AI receives, as published by mxz7/nypsi in .agents/skills/leaderboards/SKILL.md and read by ahel’s review.
- Leaderboard functions live in domain files under src/utils/functions/leaderboards/.
- Expose one overloaded export per leaderboard type. Global and guild callers use the same export,
selecting scope with
"global", undefinedor"guild", guild. - Add user-facing leaderboard options to src/commands/top.ts.
- Global leaderboards that populate profile positions call
checkLeaderboardPositions()and should be included in src/scheduled/jobs/seed-leaderboards.ts. - Publish website leaderboard updates with publishLeaderboardUpdate(). It is fire-and-forget, reuses one Redis pub/sub connection per active leaderboard, and closes inactive connections after 15 minutes.
- Named event channels use
nypsi:leaderboard:{type}and item channels usenypsi:leaderboard:item-{itemId}. Payloads contain string fieldsentityIdandvalue, plus optionalincrement: truefor integer deltas. Send unformatted numeric strings, milliseconds for times, andP{prestige} L{level}for levels. - Use increment events for counts and item additions/removals instead of querying the aggregate value. Only send an absolute time when a write establishes a new personal best.
Signals
- GitHub stars
- 69
- Forks
- 31
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
leaderboards- Source
- github.com/mxz7/nypsi