Frolf Bot — Documentation
Frolf Bot is an event-driven Discord companion for disc golf communities. It handles round scheduling, RSVP tracking, score submission, tag-based leaderboards, points seasons, and season management — all from Discord, with a live web app for viewing stats.
Sections
- Getting Started — Signing up and accessing your dashboard
- Rounds — Creating, editing, and RSVPing to rounds
- Challenges — Opening, accepting, scheduling, and linking challenge matches
- Scoring — Submitting scores, importing UDisc scorecards, and the points system
- Tags & Leaderboard — Claiming tags, viewing history, and season standings
- Admin Reference — Server setup, roles, and season management
- Commands Reference — Full slash command reference
Permission Levels
Most commands require a role. Roles are automatically assigned during signup or by an editor.
| Level | Who | What they can do |
|---|---|---|
| Everyone | Any Discord user | Sign up, view history and dashboard |
| Player | Registered members | Create rounds, RSVP, claim tags, submit scores, upload scorecards, earn points |
| Editor | Trusted members | All Player actions + manage roles, override scores |
| Admin | Server admins | All Editor actions + server setup, season management |
Note: Points are only awarded during an active season. Outside of a season, rounds are scored and tags are updated normally, but no points are earned.
How it works
Frolf Bot is powered by an event-driven backend. When you run a slash command or click a button, it publishes an event that the backend processes asynchronously. Responses are sent back to Discord as the events complete — this means some actions (like signup or round creation) may have a brief delay before you see a confirmation.
The web dashboard updates in real time via a live data stream.